twilio-ruby 5.5.1 → 5.58.3

data/lib/twilio-ruby/rest/api/v2010/account.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -22,30 +24,26 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of AccountInstance records from the API.
-          # Request is executed immediately.
+          # Create the AccountInstance
           # @param [String] friendly_name A human readable description of the account to
           #   create, defaults to `SubAccount Created at {YYYY-MM-DD HH:MM meridian}`
-          # @return [AccountInstance] Newly created AccountInstance
+          # @return [AccountInstance] Created AccountInstance
           def create(friendly_name: :unset)
-            data = Twilio::Values.of({'FriendlyName' => friendly_name})
+            data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
-            AccountInstance.new(@version, payload)
+            AccountInstance.new(@version, payload, )
           end
 
           ##
           # Lists AccountInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] friendly_name Filter accounts where the friendly name exactly
-          #   matches the desired FriendlyName
-          # @param [account.Status] status Only show accounts with the given Status
+          # @param [String] friendly_name Only return the Account resources with friendly
+          #   names that exactly match this name.
+          # @param [account.Status] status Only return Account resources with the given
+          #   status. Can be `closed`, `suspended` or `active`.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit.  Default is no limit
           # @param [Integer] page_size Number of records to fetch per request, when
@@ -54,16 +52,22 @@ module Twilio
           #    efficient page size, i.e. min(limit, 1000)
           # @return [Array] Array of up to limit results
           def list(friendly_name: :unset, status: :unset, limit: nil, page_size: nil)
-            self.stream(friendly_name: friendly_name, status: status, limit: limit, page_size: page_size).entries
+            self.stream(
+                friendly_name: friendly_name,
+                status: status,
+                limit: limit,
+                page_size: page_size
+            ).entries
           end
 
           ##
           # Streams AccountInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] friendly_name Filter accounts where the friendly name exactly
-          #   matches the desired FriendlyName
-          # @param [account.Status] status Only show accounts with the given Status
+          # @param [String] friendly_name Only return the Account resources with friendly
+          #   names that exactly match this name.
+          # @param [account.Status] status Only return Account resources with the given
+          #   status. Can be `closed`, `suspended` or `active`.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit. Default is no limit.
           # @param [Integer] page_size Number of records to fetch per request, when
@@ -74,7 +78,7 @@ module Twilio
           def stream(friendly_name: :unset, status: :unset, limit: nil, page_size: nil)
             limits = @version.read_limits(limit, page_size)
 
-            page = self.page(friendly_name: friendly_name, status: status, page_size: limits[:page_size])
+            page = self.page(friendly_name: friendly_name, status: status, page_size: limits[:page_size], )
 
             @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
           end
@@ -86,7 +90,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],
@@ -96,9 +100,10 @@ module Twilio
           ##
           # Retrieve a single page of AccountInstance records from the API.
           # Request is executed immediately.
-          # @param [String] friendly_name Filter accounts where the friendly name exactly
-          #   matches the desired FriendlyName
-          # @param [account.Status] status Only show accounts with the given Status
+          # @param [String] friendly_name Only return the Account resources with friendly
+          #   names that exactly match this name.
+          # @param [account.Status] status Only return Account resources with the given
+          #   status. Can be `closed`, `suspended` or `active`.
           # @param [String] page_token PageToken provided by the API
           # @param [Integer] page_number Page Number, this value is simply for client state
           # @param [Integer] page_size Number of records to return, defaults to 50
@@ -111,11 +116,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             AccountPage.new(@version, response, @solution)
           end
 
@@ -158,7 +161,7 @@ module Twilio
           # @param [Hash] payload Payload response from the API
           # @return [AccountInstance] AccountInstance
           def get_instance(payload)
-            AccountInstance.new(@version, payload)
+            AccountInstance.new(@version, payload, )
           end
 
           ##
@@ -179,7 +182,7 @@ module Twilio
             super(version)
 
             # Path Solution
-            @solution = {sid: sid}
+            @solution = {sid: sid, }
             @uri = "/Accounts/#{@solution[:sid]}.json"
 
             # Dependents
@@ -187,6 +190,7 @@ module Twilio
             @applications = nil
             @authorized_connect_apps = nil
             @available_phone_numbers = nil
+            @balance = nil
             @calls = nil
             @conferences = nil
             @connect_apps = nil
@@ -209,37 +213,28 @@ module Twilio
           end
 
           ##
-          # Fetch a AccountInstance
+          # Fetch the AccountInstance
           # @return [AccountInstance] Fetched AccountInstance
           def fetch
-            params = Twilio::Values.of({})
+            payload = @version.fetch('GET', @uri)
 
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
-
-            AccountInstance.new(@version, payload, sid: @solution[:sid])
+            AccountInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
           # Update the AccountInstance
           # @param [String] friendly_name Update the human-readable description of this
           #   Account
-          # @param [account.Status] status Alter the status of this account with a given
-          #   Status
+          # @param [account.Status] status Alter the status of this account: use `closed` to
+          #   irreversibly close this account, `suspended` to temporarily suspend it, or
+          #   `active` to reactivate it.
           # @return [AccountInstance] Updated AccountInstance
           def update(friendly_name: :unset, status: :unset)
-            data = Twilio::Values.of({'FriendlyName' => friendly_name, 'Status' => status})
+            data = Twilio::Values.of({'FriendlyName' => friendly_name, 'Status' => status, })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
-            AccountInstance.new(@version, payload, sid: @solution[:sid])
+            AccountInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
@@ -250,11 +245,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return AddressContext.new(@version, @solution[:sid], sid)
+              return AddressContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @addresses
-              @addresses = AddressList.new(@version, account_sid: @solution[:sid])
+              @addresses = AddressList.new(@version, account_sid: @solution[:sid], )
             end
 
             @addresses
@@ -268,11 +263,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return ApplicationContext.new(@version, @solution[:sid], sid)
+              return ApplicationContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @applications
-              @applications = ApplicationList.new(@version, account_sid: @solution[:sid])
+              @applications = ApplicationList.new(@version, account_sid: @solution[:sid], )
             end
 
             @applications
@@ -286,11 +281,11 @@ module Twilio
             raise ArgumentError, 'connect_app_sid cannot be nil' if connect_app_sid.nil?
 
             if connect_app_sid != :unset
-              return AuthorizedConnectAppContext.new(@version, @solution[:sid], connect_app_sid)
+              return AuthorizedConnectAppContext.new(@version, @solution[:sid], connect_app_sid, )
             end
 
             unless @authorized_connect_apps
-              @authorized_connect_apps = AuthorizedConnectAppList.new(@version, account_sid: @solution[:sid])
+              @authorized_connect_apps = AuthorizedConnectAppList.new(@version, account_sid: @solution[:sid], )
             end
 
             @authorized_connect_apps
@@ -304,7 +299,7 @@ module Twilio
             raise ArgumentError, 'country_code cannot be nil' if country_code.nil?
 
             if country_code != :unset
-              return AvailablePhoneNumberCountryContext.new(@version, @solution[:sid], country_code)
+              return AvailablePhoneNumberCountryContext.new(@version, @solution[:sid], country_code, )
             end
 
             unless @available_phone_numbers
@@ -317,6 +312,18 @@ module Twilio
             @available_phone_numbers
           end
 
+          ##
+          # Access the balance
+          # @return [BalanceList]
+          # @return [BalanceContext]
+          def balance
+            unless @balance
+              @balance = BalanceList.new(@version, account_sid: @solution[:sid], )
+            end
+
+            @balance
+          end
+
           ##
           # Access the calls
           # @return [CallList]
@@ -325,11 +332,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return CallContext.new(@version, @solution[:sid], sid)
+              return CallContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @calls
-              @calls = CallList.new(@version, account_sid: @solution[:sid])
+              @calls = CallList.new(@version, account_sid: @solution[:sid], )
             end
 
             @calls
@@ -343,11 +350,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return ConferenceContext.new(@version, @solution[:sid], sid)
+              return ConferenceContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @conferences
-              @conferences = ConferenceList.new(@version, account_sid: @solution[:sid])
+              @conferences = ConferenceList.new(@version, account_sid: @solution[:sid], )
             end
 
             @conferences
@@ -361,11 +368,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return ConnectAppContext.new(@version, @solution[:sid], sid)
+              return ConnectAppContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @connect_apps
-              @connect_apps = ConnectAppList.new(@version, account_sid: @solution[:sid])
+              @connect_apps = ConnectAppList.new(@version, account_sid: @solution[:sid], )
             end
 
             @connect_apps
@@ -379,11 +386,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return IncomingPhoneNumberContext.new(@version, @solution[:sid], sid)
+              return IncomingPhoneNumberContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @incoming_phone_numbers
-              @incoming_phone_numbers = IncomingPhoneNumberList.new(@version, account_sid: @solution[:sid])
+              @incoming_phone_numbers = IncomingPhoneNumberList.new(@version, account_sid: @solution[:sid], )
             end
 
             @incoming_phone_numbers
@@ -397,11 +404,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return KeyContext.new(@version, @solution[:sid], sid)
+              return KeyContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @keys
-              @keys = KeyList.new(@version, account_sid: @solution[:sid])
+              @keys = KeyList.new(@version, account_sid: @solution[:sid], )
             end
 
             @keys
@@ -415,11 +422,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return MessageContext.new(@version, @solution[:sid], sid)
+              return MessageContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @messages
-              @messages = MessageList.new(@version, account_sid: @solution[:sid])
+              @messages = MessageList.new(@version, account_sid: @solution[:sid], )
             end
 
             @messages
@@ -431,7 +438,7 @@ module Twilio
           # @return [NewKeyContext]
           def new_keys
             unless @new_keys
-              @new_keys = NewKeyList.new(@version, account_sid: @solution[:sid])
+              @new_keys = NewKeyList.new(@version, account_sid: @solution[:sid], )
             end
 
             @new_keys
@@ -443,7 +450,7 @@ module Twilio
           # @return [NewSigningKeyContext]
           def new_signing_keys
             unless @new_signing_keys
-              @new_signing_keys = NewSigningKeyList.new(@version, account_sid: @solution[:sid])
+              @new_signing_keys = NewSigningKeyList.new(@version, account_sid: @solution[:sid], )
             end
 
             @new_signing_keys
@@ -457,11 +464,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return NotificationContext.new(@version, @solution[:sid], sid)
+              return NotificationContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @notifications
-              @notifications = NotificationList.new(@version, account_sid: @solution[:sid])
+              @notifications = NotificationList.new(@version, account_sid: @solution[:sid], )
             end
 
             @notifications
@@ -475,11 +482,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return OutgoingCallerIdContext.new(@version, @solution[:sid], sid)
+              return OutgoingCallerIdContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @outgoing_caller_ids
-              @outgoing_caller_ids = OutgoingCallerIdList.new(@version, account_sid: @solution[:sid])
+              @outgoing_caller_ids = OutgoingCallerIdList.new(@version, account_sid: @solution[:sid], )
             end
 
             @outgoing_caller_ids
@@ -493,11 +500,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return QueueContext.new(@version, @solution[:sid], sid)
+              return QueueContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @queues
-              @queues = QueueList.new(@version, account_sid: @solution[:sid])
+              @queues = QueueList.new(@version, account_sid: @solution[:sid], )
             end
 
             @queues
@@ -511,11 +518,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return RecordingContext.new(@version, @solution[:sid], sid)
+              return RecordingContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @recordings
-              @recordings = RecordingList.new(@version, account_sid: @solution[:sid])
+              @recordings = RecordingList.new(@version, account_sid: @solution[:sid], )
             end
 
             @recordings
@@ -529,11 +536,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return SigningKeyContext.new(@version, @solution[:sid], sid)
+              return SigningKeyContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @signing_keys
-              @signing_keys = SigningKeyList.new(@version, account_sid: @solution[:sid])
+              @signing_keys = SigningKeyList.new(@version, account_sid: @solution[:sid], )
             end
 
             @signing_keys
@@ -545,7 +552,7 @@ module Twilio
           # @return [SipContext]
           def sip
             unless @sip
-              @sip = SipList.new(@version, account_sid: @solution[:sid])
+              @sip = SipList.new(@version, account_sid: @solution[:sid], )
             end
 
             @sip
@@ -559,11 +566,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return ShortCodeContext.new(@version, @solution[:sid], sid)
+              return ShortCodeContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @short_codes
-              @short_codes = ShortCodeList.new(@version, account_sid: @solution[:sid])
+              @short_codes = ShortCodeList.new(@version, account_sid: @solution[:sid], )
             end
 
             @short_codes
@@ -575,7 +582,7 @@ module Twilio
           # @return [TokenContext]
           def tokens
             unless @tokens
-              @tokens = TokenList.new(@version, account_sid: @solution[:sid])
+              @tokens = TokenList.new(@version, account_sid: @solution[:sid], )
             end
 
             @tokens
@@ -589,11 +596,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return TranscriptionContext.new(@version, @solution[:sid], sid)
+              return TranscriptionContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @transcriptions
-              @transcriptions = TranscriptionList.new(@version, account_sid: @solution[:sid])
+              @transcriptions = TranscriptionList.new(@version, account_sid: @solution[:sid], )
             end
 
             @transcriptions
@@ -605,7 +612,7 @@ module Twilio
           # @return [UsageContext]
           def usage
             unless @usage
-              @usage = UsageList.new(@version, account_sid: @solution[:sid])
+              @usage = UsageList.new(@version, account_sid: @solution[:sid], )
             end
 
             @usage
@@ -617,7 +624,7 @@ module Twilio
           # @return [ValidationRequestContext]
           def validation_requests
             unless @validation_requests
-              @validation_requests = ValidationRequestList.new(@version, account_sid: @solution[:sid])
+              @validation_requests = ValidationRequestList.new(@version, account_sid: @solution[:sid], )
             end
 
             @validation_requests
@@ -629,6 +636,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Api.V2010.AccountContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Api.V2010.AccountContext #{context}>"
+          end
         end
 
         class AccountInstance < InstanceResource
@@ -658,7 +672,7 @@ module Twilio
 
             # Context
             @instance_context = nil
-            @params = {'sid' => sid || @properties['sid']}
+            @params = {'sid' => sid || @properties['sid'], }
           end
 
           ##
@@ -667,7 +681,7 @@ module Twilio
           # @return [AccountContext] AccountContext for this AccountInstance
           def context
             unless @instance_context
-              @instance_context = AccountContext.new(@version, @params['sid'])
+              @instance_context = AccountContext.new(@version, @params['sid'], )
             end
             @instance_context
           end
@@ -733,7 +747,7 @@ module Twilio
           end
 
           ##
-          # Fetch a AccountInstance
+          # Fetch the AccountInstance
           # @return [AccountInstance] Fetched AccountInstance
           def fetch
             context.fetch
@@ -743,11 +757,12 @@ module Twilio
           # Update the AccountInstance
           # @param [String] friendly_name Update the human-readable description of this
           #   Account
-          # @param [account.Status] status Alter the status of this account with a given
-          #   Status
+          # @param [account.Status] status Alter the status of this account: use `closed` to
+          #   irreversibly close this account, `suspended` to temporarily suspend it, or
+          #   `active` to reactivate it.
           # @return [AccountInstance] Updated AccountInstance
           def update(friendly_name: :unset, status: :unset)
-            context.update(friendly_name: friendly_name, status: status)
+            context.update(friendly_name: friendly_name, status: status, )
           end
 
           ##
@@ -778,6 +793,13 @@ module Twilio
             context.available_phone_numbers
           end
 
+          ##
+          # Access the balance
+          # @return [balance] balance
+          def balance
+            context.balance
+          end
+
           ##
           # Access the calls
           # @return [calls] calls

data/lib/twilio-ruby/rest/api/v2010.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -24,11 +26,12 @@ module Twilio
         # @return [Twilio::REST::Api::V2010::AccountList]
         def accounts(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @accounts ||= AccountList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @accounts ||= AccountList.new self
           else
-            AccountContext.new(self, sid)
+              AccountContext.new(self, sid)
           end
         end
 
@@ -60,6 +63,10 @@ module Twilio
           self.account.available_phone_numbers(country_code)
         end
 
+        def balance
+          self.account.balance()
+        end
+
         def calls(sid=:unset)
           self.account.calls(sid)
         end