twilio-ruby 5.1.2 → 5.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 73e7d7451244594c21a6404c68f9024929afd5de
-  data.tar.gz: e0e6a02ddc95f46c72315fd6c2e31c3dd1439476
+  metadata.gz: 8d533d87716914f7de3176c3a076a57f724bddde
+  data.tar.gz: 19f83ab1668c792dd6b392e2d5e22c3d936636c5
 SHA512:
-  metadata.gz: 85f17716b4e55821f781fdc6f93e66ef838c93586a324e4076ac9251e1901bd3b011f74569352a23e641ce592c837515bd31085802909e3af2389a74a40cd57a
-  data.tar.gz: ddd9aa3be92c33d625959411180fe6e0dcd51a3ab2c2588da2c4d0b93ccd6c9ec0cdae799cd80252814062c688b0ed3be8927fead0af66def75a93e6fd0fb8cf
+  metadata.gz: 07c6a28ba0ac34f19fb1f0a9eaf69095f459a9bcc09f5c825aac523bdf0e41784458e559bdbd1cfcb0b99374ea63eecb1848f8cf8c65601bc24b7d9f7136163f
+  data.tar.gz: ed1f51c729bd7b1fffe60f2c23fc9e4307826dbd757a7cdfc1bbeffb5c02f8003e50dbb65142dc0207fcebd4dafeb87f2f41731ff7caae4120b5b1c1851216ce

data/.rubocop.yml

@@ -27,3 +27,12 @@ Metrics/MethodLength:
 
 Metrics/ParameterLists:
   Max: 20
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false

data/CHANGES.md

@@ -1,6 +1,26 @@
 twilio-ruby changelog
 =====================
 
+[2017-08-25] Version 5.2.0
+---------------------------
+**Library**
+- Add `last_request`, `last_response` properties to http client for easier debugging.
+- Add `Request` class to abstract http client implementations.
+- Rename `TwilioResponse` to `Response` for consistency, deprecate `TwilioResponse` class.
+- Support libxml 2 and 3. Issue #315. Thanks @malmckay.
+- Add `inspect` methods to all classes. Thanks @malmckay.
+
+**Api**
+- Update `status` enum for Recordings to include 'failed'
+- Add `error_code` property on Recordings
+
+**Chat**
+- Add mutable parameters for channel, members and messages
+
+**Video**
+- New `media_region` parameter when creating a room, which controls which region media will be served out of.
+
+
 [2017-08-18] Version 5.1.2
 ---------------------------
 **Api**

data/README.md

@@ -27,13 +27,13 @@ in-line code documentation here in the library.
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.1.2'
+gem 'twilio-ruby', '~> 5.2.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.1.2
+gem install twilio-ruby -v 5.2.0
 ```
 
 To build and install the development branch yourself from the latest source:

data/lib/twilio-ruby/framework/request.rb

@@ -0,0 +1,39 @@
+module Twilio
+  class Request
+    attr_reader :host, :port, :method, :url, :params, :data, :headers, :auth, :timeout
+
+    def initialize(host, port, method, url, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
+      @host = host
+      @port = port
+      @url = url
+      @method = method
+      @params = params
+      @data = data
+      @headers = headers
+      @auth = auth
+      @timeout = timeout
+    end
+
+    def to_s
+      auth = @auth.nil? ? '' : '(' + @auth.join(',') + ')'
+
+      params = ''
+      unless @params.nil? || @params.empty?
+        params = '?' + @params.each.map { |key, value| "#{CGI.escape(key)}=#{CGI.escape(value)}" }.join('&')
+      end
+
+      headers = ''
+      unless @headers.nil? || @headers.empty?
+        headers = "\n" + @headers.each.map { |key, value| "-H \"#{key}\": \"#{value}\"" }.join("\n")
+      end
+
+      data = ''
+      unless @data.nil? || @data.empty?
+        data = @method.equal?('GET') ? "\n -G" : "\n"
+        data += @data.each.map { |key, value| "-d \"#{key}\"=\"#{value}\"" }.join("\n")
+      end
+
+      "#{auth} #{@method} #{@url}#{params}#{data}#{headers}"
+    end
+  end
+end

data/lib/twilio-ruby/framework/response.rb

@@ -0,0 +1,15 @@
+module Twilio
+  class Response
+    attr_accessor :status_code, :body
+
+    def initialize(status_code, body)
+      @status_code = status_code
+      body = '{}' if !body || body.empty?
+      @body = JSON.parse(body)
+    end
+
+    def to_s
+      "[#{status_code}] #{body}"
+    end
+  end
+end

data/lib/twilio-ruby/framework/twilio_response.rb

@@ -2,14 +2,16 @@ module Twilio
   class TwilioResponse
     attr_accessor :status_code, :body
 
+    # @deprecated Use 'Twilio::Response' instead.
     def initialize(status_code, body)
-      @status_code = status_code
-      body = '{}' if !body || body.empty?
-      @body = JSON.parse(body)
+      warn "'Twilio::TwilioResponse' has been deprecated. Use 'Twilio::Response' instead."
+      response = Twilio::Response.new(status_code, body)
+      @status_code = response.status_code
+      @body = response.body
     end
 
     def to_s
-      "[#{status_code}] #{body}"
+      "[#{@status_code}] #{@body}"
     end
   end
 end

data/lib/twilio-ruby/http/http_client.rb

@@ -4,6 +4,7 @@ module Twilio
   module HTTP
     class Client
       attr_accessor :adapter
+      attr_reader :last_response, :last_request
 
       def initialize(proxy_addr = nil, proxy_port = nil, proxy_user = nil, proxy_pass = nil, ssl_ca_file = nil)
         @proxy_addr = proxy_addr
@@ -14,30 +15,41 @@ module Twilio
         @adapter = Faraday.default_adapter
       end
 
-      def request(host, port, method, url, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
-        @connection = Faraday.new(url: host + ':' + port.to_s, ssl: { verify: true }) do |f|
+      def _request(request)
+        @connection = Faraday.new(url: request.host + ':' + request.port.to_s, ssl: { verify: true }) do |f|
           f.options.params_encoder = Faraday::FlatParamsEncoder
           f.request :url_encoded
           f.adapter @adapter
-          f.headers = headers
-          f.basic_auth(auth[0], auth[1])
+          f.headers = request.headers
+          f.basic_auth(request.auth[0], request.auth[1])
           if @proxy_addr
             f.proxy '#{@proxy_user}:#{@proxy_pass}@#{@proxy_addr}:#{@proxy_port}'
           end
-          f.options.open_timeout = timeout
-          f.options.timeout = timeout
+          f.options.open_timeout = request.timeout
+          f.options.timeout = request.timeout
         end
 
-        response = @connection.send(method.downcase.to_sym, url, method == 'GET' ? params : data)
+        @last_request = request
+        @last_response = nil
+        response = @connection.send(request.method.downcase.to_sym,
+                                    request.url,
+                                    request.method == 'GET' ? request.params : request.data)
 
-        @last_response = response
         if response.body && !response.body.empty?
           object = response.body
         elsif response.status == 400
           object = { message: 'Bad request', code: 400 }.to_json
         end
 
-        TwilioResponse.new(response.status, object)
+        twilio_response = Twilio::Response.new(response.status, object)
+        @last_response = twilio_response
+
+        twilio_response
+      end
+
+      def request(host, port, method, url, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
+        request = Twilio::Request.new(host, port, method, url, params, data, headers, auth, timeout)
+        _request(request)
       end
     end
   end

data/lib/twilio-ruby/rest/accounts/v1/credential.rb

@@ -98,6 +98,12 @@ module Twilio
           def to_s
             "<Twilio.Accounts.V1.CredentialInstance>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            "<Twilio.Accounts.V1.CredentialInstance>"
+          end
         end
       end
     end

data/lib/twilio-ruby/rest/accounts/v1/credential/public_key.rb

@@ -362,6 +362,13 @@ module Twilio
               values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
               "<Twilio.Accounts.V1.PublicKeyInstance #{values}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Accounts.V1.PublicKeyInstance #{values}>"
+            end
           end
         end
       end

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

@@ -1091,6 +1091,13 @@ module Twilio
             values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
             "<Twilio.Api.V2010.AccountInstance #{values}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Api.V2010.AccountInstance #{values}>"
+          end
         end
       end
     end

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

@@ -507,6 +507,13 @@ module Twilio
               values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
               "<Twilio.Api.V2010.AddressInstance #{values}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Api.V2010.AddressInstance #{values}>"
+            end
           end
         end
       end

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

@@ -256,6 +256,12 @@ module Twilio
               def to_s
                 "<Twilio.Api.V2010.DependentPhoneNumberInstance>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                "<Twilio.Api.V2010.DependentPhoneNumberInstance>"
+              end
             end
           end
         end

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

@@ -612,6 +612,13 @@ module Twilio
               values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
               "<Twilio.Api.V2010.ApplicationInstance #{values}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Api.V2010.ApplicationInstance #{values}>"
+            end
           end
         end
       end

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

@@ -323,6 +323,13 @@ module Twilio
               values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
               "<Twilio.Api.V2010.AuthorizedConnectAppInstance #{values}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Api.V2010.AuthorizedConnectAppInstance #{values}>"
+            end
           end
         end
       end

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

@@ -362,6 +362,13 @@ module Twilio
               values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
               "<Twilio.Api.V2010.AvailablePhoneNumberCountryInstance #{values}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Api.V2010.AvailablePhoneNumberCountryInstance #{values}>"
+            end
           end
         end
       end

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

@@ -380,6 +380,12 @@ module Twilio
               def to_s
                 "<Twilio.Api.V2010.LocalInstance>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                "<Twilio.Api.V2010.LocalInstance>"
+              end
             end
           end
         end

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

@@ -380,6 +380,12 @@ module Twilio
               def to_s
                 "<Twilio.Api.V2010.MobileInstance>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                "<Twilio.Api.V2010.MobileInstance>"
+              end
             end
           end
         end

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

@@ -380,6 +380,12 @@ module Twilio
               def to_s
                 "<Twilio.Api.V2010.TollFreeInstance>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                "<Twilio.Api.V2010.TollFreeInstance>"
+              end
             end
           end
         end

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

@@ -791,6 +791,13 @@ module Twilio
               values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
               "<Twilio.Api.V2010.CallInstance #{values}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Api.V2010.CallInstance #{values}>"
+            end
           end
         end
       end

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

@@ -287,6 +287,13 @@ module Twilio
                 values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
                 "<Twilio.Api.V2010.FeedbackInstance #{values}>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Api.V2010.FeedbackInstance #{values}>"
+              end
             end
           end
         end

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

@@ -308,6 +308,13 @@ module Twilio
                 values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
                 "<Twilio.Api.V2010.FeedbackSummaryInstance #{values}>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Api.V2010.FeedbackSummaryInstance #{values}>"
+              end
             end
           end
         end

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

@@ -418,6 +418,13 @@ module Twilio
                 values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
                 "<Twilio.Api.V2010.NotificationInstance #{values}>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Api.V2010.NotificationInstance #{values}>"
+              end
             end
           end
         end

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

@@ -256,6 +256,7 @@ module Twilio
                     'price' => payload['price'].to_f,
                     'uri' => payload['uri'],
                     'encryption_details' => payload['encryption_details'],
+                    'error_code' => payload['error_code'] == nil ? payload['error_code'] : payload['error_code'].to_i,
                 }
 
                 # Context
@@ -343,6 +344,12 @@ module Twilio
                 @properties['encryption_details']
               end
 
+              ##
+              # @return [String] The error_code
+              def error_code
+                @properties['error_code']
+              end
+
               ##
               # Fetch a RecordingInstance
               # @return [RecordingInstance] Fetched RecordingInstance
@@ -363,6 +370,13 @@ module Twilio
                 values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
                 "<Twilio.Api.V2010.RecordingInstance #{values}>"
               end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Api.V2010.RecordingInstance #{values}>"
+              end
             end
           end
         end