twilio-ruby 5.5.1 → 5.58.3

data/lib/twilio-ruby/rest/trunking/v1/trunk/credential_list.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -13,7 +15,8 @@ module Twilio
             ##
             # Initialize the CredentialListList
             # @param [Version] version Version that contains the resource
-            # @param [String] trunk_sid The trunk_sid
+            # @param [String] trunk_sid The SID of the Trunk the credential list in associated
+            #   with.
             # @return [CredentialListList] CredentialListList
             def initialize(version, trunk_sid: nil)
               super(version)
@@ -24,20 +27,18 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of CredentialListInstance records from the API.
-            # Request is executed immediately.
-            # @param [String] credential_list_sid The credential_list_sid
-            # @return [CredentialListInstance] Newly created CredentialListInstance
+            # Create the CredentialListInstance
+            # @param [String] credential_list_sid The SID of the {Credential
+            #   List}[https://www.twilio.com/docs/voice/sip/api/sip-credentiallist-resource]
+            #   that you want to associate with the trunk. Once associated, we will authenticate
+            #   access to the trunk against this list.
+            # @return [CredentialListInstance] Created CredentialListInstance
             def create(credential_list_sid: nil)
-              data = Twilio::Values.of({'CredentialListSid' => credential_list_sid})
+              data = Twilio::Values.of({'CredentialListSid' => credential_list_sid, })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
-              CredentialListInstance.new(@version, payload, trunk_sid: @solution[:trunk_sid])
+              CredentialListInstance.new(@version, payload, trunk_sid: @solution[:trunk_sid], )
             end
 
             ##
@@ -69,7 +70,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
@@ -81,7 +82,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],
@@ -101,11 +102,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               CredentialListPage.new(@version, response, @solution)
             end
 
@@ -148,7 +147,7 @@ module Twilio
             # @param [Hash] payload Payload response from the API
             # @return [CredentialListInstance] CredentialListInstance
             def get_instance(payload)
-              CredentialListInstance.new(@version, payload, trunk_sid: @solution[:trunk_sid])
+              CredentialListInstance.new(@version, payload, trunk_sid: @solution[:trunk_sid], )
             end
 
             ##
@@ -162,37 +161,38 @@ module Twilio
             ##
             # Initialize the CredentialListContext
             # @param [Version] version Version that contains the resource
-            # @param [String] trunk_sid The trunk_sid
-            # @param [String] sid The sid
+            # @param [String] trunk_sid The SID of the Trunk from which to fetch the
+            #   credential list.
+            # @param [String] sid The unique string that we created to identify the
+            #   CredentialList resource to fetch.
             # @return [CredentialListContext] CredentialListContext
             def initialize(version, trunk_sid, sid)
               super(version)
 
               # Path Solution
-              @solution = {trunk_sid: trunk_sid, sid: sid}
+              @solution = {trunk_sid: trunk_sid, sid: sid, }
               @uri = "/Trunks/#{@solution[:trunk_sid]}/CredentialLists/#{@solution[:sid]}"
             end
 
             ##
-            # Fetch a CredentialListInstance
+            # Fetch the CredentialListInstance
             # @return [CredentialListInstance] Fetched CredentialListInstance
             def fetch
-              params = Twilio::Values.of({})
+              payload = @version.fetch('GET', @uri)
 
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
+              CredentialListInstance.new(
+                  @version,
+                  payload,
+                  trunk_sid: @solution[:trunk_sid],
+                  sid: @solution[:sid],
               )
-
-              CredentialListInstance.new(@version, payload, trunk_sid: @solution[:trunk_sid], sid: @solution[:sid])
             end
 
             ##
-            # Deletes the CredentialListInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the CredentialListInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -201,6 +201,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.Trunking.V1.CredentialListContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Trunking.V1.CredentialListContext #{context}>"
+            end
           end
 
           class CredentialListInstance < InstanceResource
@@ -208,8 +215,10 @@ module Twilio
             # Initialize the CredentialListInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] trunk_sid The trunk_sid
-            # @param [String] sid The sid
+            # @param [String] trunk_sid The SID of the Trunk the credential list in associated
+            #   with.
+            # @param [String] sid The unique string that we created to identify the
+            #   CredentialList resource to fetch.
             # @return [CredentialListInstance] CredentialListInstance
             def initialize(version, payload, trunk_sid: nil, sid: nil)
               super(version)
@@ -227,7 +236,7 @@ module Twilio
 
               # Context
               @instance_context = nil
-              @params = {'trunk_sid' => trunk_sid, 'sid' => sid || @properties['sid']}
+              @params = {'trunk_sid' => trunk_sid, 'sid' => sid || @properties['sid'], }
             end
 
             ##
@@ -236,63 +245,63 @@ module Twilio
             # @return [CredentialListContext] CredentialListContext for this CredentialListInstance
             def context
               unless @instance_context
-                @instance_context = CredentialListContext.new(@version, @params['trunk_sid'], @params['sid'])
+                @instance_context = CredentialListContext.new(@version, @params['trunk_sid'], @params['sid'], )
               end
               @instance_context
             end
 
             ##
-            # @return [String] The account_sid
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The sid
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The trunk_sid
+            # @return [String] The SID of the Trunk the credential list in associated with
             def trunk_sid
               @properties['trunk_sid']
             end
 
             ##
-            # @return [String] The friendly_name
+            # @return [String] The string that you assigned to describe the resource
             def friendly_name
               @properties['friendly_name']
             end
 
             ##
-            # @return [Time] The date_created
+            # @return [Time] The RFC 2822 date and time in GMT when the resource was created
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The date_updated
+            # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
             def date_updated
               @properties['date_updated']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The absolute URL of the resource
             def url
               @properties['url']
             end
 
             ##
-            # Fetch a CredentialListInstance
+            # Fetch the CredentialListInstance
             # @return [CredentialListInstance] Fetched CredentialListInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the CredentialListInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the CredentialListInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete
             end

data/lib/twilio-ruby/rest/trunking/v1/trunk/ip_access_control_list.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -13,7 +15,7 @@ module Twilio
             ##
             # Initialize the IpAccessControlListList
             # @param [Version] version Version that contains the resource
-            # @param [String] trunk_sid The trunk_sid
+            # @param [String] trunk_sid The SID of the Trunk the resource is associated with.
             # @return [IpAccessControlListList] IpAccessControlListList
             def initialize(version, trunk_sid: nil)
               super(version)
@@ -24,20 +26,17 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of IpAccessControlListInstance records from the API.
-            # Request is executed immediately.
-            # @param [String] ip_access_control_list_sid The ip_access_control_list_sid
-            # @return [IpAccessControlListInstance] Newly created IpAccessControlListInstance
+            # Create the IpAccessControlListInstance
+            # @param [String] ip_access_control_list_sid The SID of the {IP Access Control
+            #   List}[https://www.twilio.com/docs/voice/sip/api/sip-ipaccesscontrollist-resource]
+            #   that you want to associate with the trunk.
+            # @return [IpAccessControlListInstance] Created IpAccessControlListInstance
             def create(ip_access_control_list_sid: nil)
-              data = Twilio::Values.of({'IpAccessControlListSid' => ip_access_control_list_sid})
+              data = Twilio::Values.of({'IpAccessControlListSid' => ip_access_control_list_sid, })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
-              IpAccessControlListInstance.new(@version, payload, trunk_sid: @solution[:trunk_sid])
+              IpAccessControlListInstance.new(@version, payload, trunk_sid: @solution[:trunk_sid], )
             end
 
             ##
@@ -69,7 +68,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
@@ -81,7 +80,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],
@@ -101,11 +100,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               IpAccessControlListPage.new(@version, response, @solution)
             end
 
@@ -148,7 +145,7 @@ module Twilio
             # @param [Hash] payload Payload response from the API
             # @return [IpAccessControlListInstance] IpAccessControlListInstance
             def get_instance(payload)
-              IpAccessControlListInstance.new(@version, payload, trunk_sid: @solution[:trunk_sid])
+              IpAccessControlListInstance.new(@version, payload, trunk_sid: @solution[:trunk_sid], )
             end
 
             ##
@@ -162,28 +159,24 @@ module Twilio
             ##
             # Initialize the IpAccessControlListContext
             # @param [Version] version Version that contains the resource
-            # @param [String] trunk_sid The trunk_sid
-            # @param [String] sid The sid
+            # @param [String] trunk_sid The SID of the Trunk from which to fetch the IP Access
+            #   Control List.
+            # @param [String] sid The unique string that we created to identify the
+            #   IpAccessControlList resource to fetch.
             # @return [IpAccessControlListContext] IpAccessControlListContext
             def initialize(version, trunk_sid, sid)
               super(version)
 
               # Path Solution
-              @solution = {trunk_sid: trunk_sid, sid: sid}
+              @solution = {trunk_sid: trunk_sid, sid: sid, }
               @uri = "/Trunks/#{@solution[:trunk_sid]}/IpAccessControlLists/#{@solution[:sid]}"
             end
 
             ##
-            # Fetch a IpAccessControlListInstance
+            # Fetch the IpAccessControlListInstance
             # @return [IpAccessControlListInstance] Fetched IpAccessControlListInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               IpAccessControlListInstance.new(
                   @version,
@@ -194,10 +187,10 @@ module Twilio
             end
 
             ##
-            # Deletes the IpAccessControlListInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the IpAccessControlListInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -206,6 +199,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.Trunking.V1.IpAccessControlListContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Trunking.V1.IpAccessControlListContext #{context}>"
+            end
           end
 
           class IpAccessControlListInstance < InstanceResource
@@ -213,8 +213,9 @@ module Twilio
             # Initialize the IpAccessControlListInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] trunk_sid The trunk_sid
-            # @param [String] sid The sid
+            # @param [String] trunk_sid The SID of the Trunk the resource is associated with.
+            # @param [String] sid The unique string that we created to identify the
+            #   IpAccessControlList resource to fetch.
             # @return [IpAccessControlListInstance] IpAccessControlListInstance
             def initialize(version, payload, trunk_sid: nil, sid: nil)
               super(version)
@@ -232,7 +233,7 @@ module Twilio
 
               # Context
               @instance_context = nil
-              @params = {'trunk_sid' => trunk_sid, 'sid' => sid || @properties['sid']}
+              @params = {'trunk_sid' => trunk_sid, 'sid' => sid || @properties['sid'], }
             end
 
             ##
@@ -241,63 +242,63 @@ module Twilio
             # @return [IpAccessControlListContext] IpAccessControlListContext for this IpAccessControlListInstance
             def context
               unless @instance_context
-                @instance_context = IpAccessControlListContext.new(@version, @params['trunk_sid'], @params['sid'])
+                @instance_context = IpAccessControlListContext.new(@version, @params['trunk_sid'], @params['sid'], )
               end
               @instance_context
             end
 
             ##
-            # @return [String] The account_sid
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The sid
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The trunk_sid
+            # @return [String] The SID of the Trunk the resource is associated with
             def trunk_sid
               @properties['trunk_sid']
             end
 
             ##
-            # @return [String] The friendly_name
+            # @return [String] The string that you assigned to describe the resource
             def friendly_name
               @properties['friendly_name']
             end
 
             ##
-            # @return [Time] The date_created
+            # @return [Time] The RFC 2822 date and time in GMT when the resource was created
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The date_updated
+            # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
             def date_updated
               @properties['date_updated']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The absolute URL of the resource
             def url
               @properties['url']
             end
 
             ##
-            # Fetch a IpAccessControlListInstance
+            # Fetch the IpAccessControlListInstance
             # @return [IpAccessControlListInstance] Fetched IpAccessControlListInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the IpAccessControlListInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the IpAccessControlListInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete
             end