twilio-ruby 5.5.1 → 5.58.3

data/lib/twilio-ruby/rest/preview/sync/service/document.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -26,21 +28,16 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of DocumentInstance records from the API.
-            # Request is executed immediately.
+            # Create the DocumentInstance
             # @param [String] unique_name The unique_name
             # @param [Hash] data The data
-            # @return [DocumentInstance] Newly created DocumentInstance
+            # @return [DocumentInstance] Created DocumentInstance
             def create(unique_name: :unset, data: :unset)
-              data = Twilio::Values.of({'UniqueName' => unique_name, 'Data' => Twilio.serialize_object(data)})
+              data = Twilio::Values.of({'UniqueName' => unique_name, 'Data' => Twilio.serialize_object(data), })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
-              DocumentInstance.new(@version, payload, service_sid: @solution[:service_sid])
+              DocumentInstance.new(@version, payload, service_sid: @solution[:service_sid], )
             end
 
             ##
@@ -72,7 +69,7 @@ module Twilio
             def stream(limit: nil, page_size: nil)
               limits = @version.read_limits(limit, page_size)
 
-              page = self.page(page_size: limits[:page_size])
+              page = self.page(page_size: limits[:page_size], )
 
               @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
             end
@@ -84,7 +81,7 @@ module Twilio
             def each
               limits = @version.read_limits
 
-              page = self.page(page_size: limits[:page_size])
+              page = self.page(page_size: limits[:page_size], )
 
               @version.stream(page,
                               limit: limits[:limit],
@@ -104,11 +101,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               DocumentPage.new(@version, response, @solution)
             end
 
@@ -153,7 +148,7 @@ module Twilio
             # @param [Hash] payload Payload response from the API
             # @return [DocumentInstance] DocumentInstance
             def get_instance(payload)
-              DocumentInstance.new(@version, payload, service_sid: @solution[:service_sid])
+              DocumentInstance.new(@version, payload, service_sid: @solution[:service_sid], )
             end
 
             ##
@@ -176,7 +171,7 @@ module Twilio
               super(version)
 
               # Path Solution
-              @solution = {service_sid: service_sid, sid: sid}
+              @solution = {service_sid: service_sid, sid: sid, }
               @uri = "/Services/#{@solution[:service_sid]}/Documents/#{@solution[:sid]}"
 
               # Dependents
@@ -184,41 +179,33 @@ module Twilio
             end
 
             ##
-            # Fetch a DocumentInstance
+            # Fetch the DocumentInstance
             # @return [DocumentInstance] Fetched DocumentInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
-              DocumentInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid])
+              DocumentInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the DocumentInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the DocumentInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
             # Update the DocumentInstance
             # @param [Hash] data The data
+            # @param [String] if_match The If-Match HTTP request header
             # @return [DocumentInstance] Updated DocumentInstance
-            def update(data: nil)
-              data = Twilio::Values.of({'Data' => Twilio.serialize_object(data)})
+            def update(data: nil, if_match: :unset)
+              data = Twilio::Values.of({'Data' => Twilio.serialize_object(data), })
+              headers = Twilio::Values.of({'If-Match' => if_match, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data, headers: headers)
 
-              DocumentInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid])
+              DocumentInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid], )
             end
 
             ##
@@ -229,7 +216,7 @@ module Twilio
               raise ArgumentError, 'identity cannot be nil' if identity.nil?
 
               if identity != :unset
-                return DocumentPermissionContext.new(@version, @solution[:service_sid], @solution[:sid], identity)
+                return DocumentPermissionContext.new(@version, @solution[:service_sid], @solution[:sid], identity, )
               end
 
               unless @document_permissions
@@ -249,6 +236,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.Preview.Sync.DocumentContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Preview.Sync.DocumentContext #{context}>"
+            end
           end
 
           ##
@@ -281,7 +275,7 @@ module Twilio
 
               # Context
               @instance_context = nil
-              @params = {'service_sid' => service_sid, 'sid' => sid || @properties['sid']}
+              @params = {'service_sid' => service_sid, 'sid' => sid || @properties['sid'], }
             end
 
             ##
@@ -290,7 +284,7 @@ module Twilio
             # @return [DocumentContext] DocumentContext for this DocumentInstance
             def context
               unless @instance_context
-                @instance_context = DocumentContext.new(@version, @params['service_sid'], @params['sid'])
+                @instance_context = DocumentContext.new(@version, @params['service_sid'], @params['sid'], )
               end
               @instance_context
             end
@@ -362,15 +356,15 @@ module Twilio
             end
 
             ##
-            # Fetch a DocumentInstance
+            # Fetch the DocumentInstance
             # @return [DocumentInstance] Fetched DocumentInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the DocumentInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the DocumentInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete
             end
@@ -378,9 +372,10 @@ module Twilio
             ##
             # Update the DocumentInstance
             # @param [Hash] data The data
+            # @param [String] if_match The If-Match HTTP request header
             # @return [DocumentInstance] Updated DocumentInstance
-            def update(data: nil)
-              context.update(data: data)
+            def update(data: nil, if_match: :unset)
+              context.update(data: data, if_match: if_match, )
             end
 
             ##

data/lib/twilio-ruby/rest/preview/sync/service/sync_list/sync_list_item.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -28,18 +30,13 @@ module Twilio
               end
 
               ##
-              # Retrieve a single page of SyncListItemInstance records from the API.
-              # Request is executed immediately.
+              # Create the SyncListItemInstance
               # @param [Hash] data The data
-              # @return [SyncListItemInstance] Newly created SyncListItemInstance
+              # @return [SyncListItemInstance] Created SyncListItemInstance
               def create(data: nil)
-                data = Twilio::Values.of({'Data' => Twilio.serialize_object(data)})
+                data = Twilio::Values.of({'Data' => Twilio.serialize_object(data), })
 
-                payload = @version.create(
-                    'POST',
-                    @uri,
-                    data: data
-                )
+                payload = @version.create('POST', @uri, data: data)
 
                 SyncListItemInstance.new(
                     @version,
@@ -84,7 +81,7 @@ module Twilio
               def stream(order: :unset, from: :unset, bounds: :unset, limit: nil, page_size: nil)
                 limits = @version.read_limits(limit, page_size)
 
-                page = self.page(order: order, from: from, bounds: bounds, page_size: limits[:page_size])
+                page = self.page(order: order, from: from, bounds: bounds, page_size: limits[:page_size], )
 
                 @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
               end
@@ -96,7 +93,7 @@ module Twilio
               def each
                 limits = @version.read_limits
 
-                page = self.page(page_size: limits[:page_size])
+                page = self.page(page_size: limits[:page_size], )
 
                 @version.stream(page,
                                 limit: limits[:limit],
@@ -122,11 +119,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 SyncListItemPage.new(@version, response, @solution)
               end
 
@@ -200,21 +195,15 @@ module Twilio
                 super(version)
 
                 # Path Solution
-                @solution = {service_sid: service_sid, list_sid: list_sid, index: index}
+                @solution = {service_sid: service_sid, list_sid: list_sid, index: index, }
                 @uri = "/Services/#{@solution[:service_sid]}/Lists/#{@solution[:list_sid]}/Items/#{@solution[:index]}"
               end
 
               ##
-              # Fetch a SyncListItemInstance
+              # Fetch the SyncListItemInstance
               # @return [SyncListItemInstance] Fetched SyncListItemInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 SyncListItemInstance.new(
                     @version,
@@ -226,24 +215,25 @@ module Twilio
               end
 
               ##
-              # Deletes the SyncListItemInstance
-              # @return [Boolean] true if delete succeeds, true otherwise
-              def delete
-                @version.delete('delete', @uri)
+              # Delete the SyncListItemInstance
+              # @param [String] if_match The If-Match HTTP request header
+              # @return [Boolean] true if delete succeeds, false otherwise
+              def delete(if_match: :unset)
+                headers = Twilio::Values.of({'If-Match' => if_match, })
+
+                 @version.delete('DELETE', @uri, headers: headers)
               end
 
               ##
               # Update the SyncListItemInstance
               # @param [Hash] data The data
+              # @param [String] if_match The If-Match HTTP request header
               # @return [SyncListItemInstance] Updated SyncListItemInstance
-              def update(data: nil)
-                data = Twilio::Values.of({'Data' => Twilio.serialize_object(data)})
+              def update(data: nil, if_match: :unset)
+                data = Twilio::Values.of({'Data' => Twilio.serialize_object(data), })
+                headers = Twilio::Values.of({'If-Match' => if_match, })
 
-                payload = @version.update(
-                    'POST',
-                    @uri,
-                    data: data,
-                )
+                payload = @version.update('POST', @uri, data: data, headers: headers)
 
                 SyncListItemInstance.new(
                     @version,
@@ -260,6 +250,13 @@ module Twilio
                 context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
                 "#<Twilio.Preview.Sync.SyncListItemContext #{context}>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+                "#<Twilio.Preview.Sync.SyncListItemContext #{context}>"
+              end
             end
 
             ##
@@ -376,25 +373,27 @@ module Twilio
               end
 
               ##
-              # Fetch a SyncListItemInstance
+              # Fetch the SyncListItemInstance
               # @return [SyncListItemInstance] Fetched SyncListItemInstance
               def fetch
                 context.fetch
               end
 
               ##
-              # Deletes the SyncListItemInstance
-              # @return [Boolean] true if delete succeeds, true otherwise
-              def delete
-                context.delete
+              # Delete the SyncListItemInstance
+              # @param [String] if_match The If-Match HTTP request header
+              # @return [Boolean] true if delete succeeds, false otherwise
+              def delete(if_match: :unset)
+                context.delete(if_match: if_match, )
               end
 
               ##
               # Update the SyncListItemInstance
               # @param [Hash] data The data
+              # @param [String] if_match The If-Match HTTP request header
               # @return [SyncListItemInstance] Updated SyncListItemInstance
-              def update(data: nil)
-                context.update(data: data)
+              def update(data: nil, if_match: :unset)
+                context.update(data: data, if_match: if_match, )
               end
 
               ##

data/lib/twilio-ruby/rest/preview/sync/service/sync_list/sync_list_permission.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -58,7 +60,7 @@ module Twilio
               def stream(limit: nil, page_size: nil)
                 limits = @version.read_limits(limit, page_size)
 
-                page = self.page(page_size: limits[:page_size])
+                page = self.page(page_size: limits[:page_size], )
 
                 @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
               end
@@ -70,7 +72,7 @@ module Twilio
               def each
                 limits = @version.read_limits
 
-                page = self.page(page_size: limits[:page_size])
+                page = self.page(page_size: limits[:page_size], )
 
                 @version.stream(page,
                                 limit: limits[:limit],
@@ -90,11 +92,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 SyncListPermissionPage.new(@version, response, @solution)
               end
 
@@ -170,21 +170,15 @@ module Twilio
                 super(version)
 
                 # Path Solution
-                @solution = {service_sid: service_sid, list_sid: list_sid, identity: identity}
+                @solution = {service_sid: service_sid, list_sid: list_sid, identity: identity, }
                 @uri = "/Services/#{@solution[:service_sid]}/Lists/#{@solution[:list_sid]}/Permissions/#{@solution[:identity]}"
               end
 
               ##
-              # Fetch a SyncListPermissionInstance
+              # Fetch the SyncListPermissionInstance
               # @return [SyncListPermissionInstance] Fetched SyncListPermissionInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 SyncListPermissionInstance.new(
                     @version,
@@ -196,10 +190,10 @@ module Twilio
               end
 
               ##
-              # Deletes the SyncListPermissionInstance
-              # @return [Boolean] true if delete succeeds, true otherwise
+              # Delete the SyncListPermissionInstance
+              # @return [Boolean] true if delete succeeds, false otherwise
               def delete
-                @version.delete('delete', @uri)
+                 @version.delete('DELETE', @uri)
               end
 
               ##
@@ -212,13 +206,9 @@ module Twilio
               #   the Sync List.
               # @return [SyncListPermissionInstance] Updated SyncListPermissionInstance
               def update(read: nil, write: nil, manage: nil)
-                data = Twilio::Values.of({'Read' => read, 'Write' => write, 'Manage' => manage})
+                data = Twilio::Values.of({'Read' => read, 'Write' => write, 'Manage' => manage, })
 
-                payload = @version.update(
-                    'POST',
-                    @uri,
-                    data: data,
-                )
+                payload = @version.update('POST', @uri, data: data)
 
                 SyncListPermissionInstance.new(
                     @version,
@@ -235,6 +225,13 @@ module Twilio
                 context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
                 "#<Twilio.Preview.Sync.SyncListPermissionContext #{context}>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+                "#<Twilio.Preview.Sync.SyncListPermissionContext #{context}>"
+              end
             end
 
             ##
@@ -340,15 +337,15 @@ module Twilio
               end
 
               ##
-              # Fetch a SyncListPermissionInstance
+              # Fetch the SyncListPermissionInstance
               # @return [SyncListPermissionInstance] Fetched SyncListPermissionInstance
               def fetch
                 context.fetch
               end
 
               ##
-              # Deletes the SyncListPermissionInstance
-              # @return [Boolean] true if delete succeeds, true otherwise
+              # Delete the SyncListPermissionInstance
+              # @return [Boolean] true if delete succeeds, false otherwise
               def delete
                 context.delete
               end
@@ -363,7 +360,7 @@ module Twilio
               #   the Sync List.
               # @return [SyncListPermissionInstance] Updated SyncListPermissionInstance
               def update(read: nil, write: nil, manage: nil)
-                context.update(read: read, write: write, manage: manage)
+                context.update(read: read, write: write, manage: manage, )
               end
 
               ##