twilio-ruby 3.15.2 → 3.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 55ea3eb8f942cafe675c70aad8fa1ff5bf3836bf
-  data.tar.gz: b2dfc49ca27752b0e6bc87f8e7c5fc9095251627
+  metadata.gz: e89894997e17d49541145a1f4ca4a95e2960e8f5
+  data.tar.gz: 4f0e819ab0fe41e01c0e7823178180cc565ac573
 SHA512:
-  metadata.gz: 7df8d0e86f338607a6696a0defeda6283a5055870feccf48f15f47754a92e7e32a42961d9c7acdce974595511e1f1831034251f27aadfd0514eb41daea0b6489
-  data.tar.gz: a9e7eeea7956069958f186b2c62811283680db576cb0479b1b835c31826a94804f9aa1ce622d42661ef73a30f9c980b3e390dfbbe98f88f597b2c215c0c52fe1
+  metadata.gz: 24e2db1a0a70571578cb9916cf7888b82e4970282b0d6b3761d6b814a8091fa1e76ee358b735c247611e8d38e916c84508fb7e5d6ebba801b1daa80521dc494e
+  data.tar.gz: 84f0fda6bf321cf575d7fb28ec42a24b58f9191b4fbaae5322e776bc2047d78b833f3d4c5f5379f15f5c75bc1deb4ec91bd46289743458c4408d7c175829a545

data/CHANGES.md

@@ -1,6 +1,14 @@
 twilio-ruby changelog
 =====================
 
+Version 3.16.0
+--------------
+
+Released March 31, 2015
+
+- Add support for new Twilio Lookups API
+- Update LICENSE wording
+
 Version 3.15.2
 --------------
 

data/lib/twilio-ruby.rb

@@ -49,6 +49,7 @@ require 'twilio-ruby/rest/task_router/workflow_statistics'
 require 'twilio-ruby/rest/task_router/workflows'
 require 'twilio-ruby/rest/task_router/workspaces'
 require 'twilio-ruby/rest/task_router/workspace_statistics'
+require 'twilio-ruby/rest/lookups/phone_numbers'
 require 'twilio-ruby/rest/media'
 require 'twilio-ruby/rest/messages'
 require 'twilio-ruby/rest/applications'
@@ -78,6 +79,8 @@ require 'twilio-ruby/rest/notifications'
 require 'twilio-ruby/rest/addresses'
 require 'twilio-ruby/rest/addresses/dependent_phone_numbers'
 require 'twilio-ruby/rest/client'
+require 'twilio-ruby/rest/task_router_client'
+require 'twilio-ruby/rest/lookups_client'
 require 'rack/twilio_webhook_authentication'
 
 module Twilio

data/lib/twilio-ruby/rest/base_client.rb

@@ -0,0 +1,140 @@
+module Twilio
+  module REST
+    class BaseClient
+      include Twilio::Util
+      include Twilio::REST::Utils
+
+      HTTP_HEADERS = {
+          'Accept' => 'application/json',
+          'Accept-Charset' => 'utf-8',
+          'User-Agent' => "twilio-ruby/#{Twilio::VERSION}" \
+                        " (#{RUBY_ENGINE}/#{RUBY_PLATFORM}" \
+                        " #{RUBY_VERSION}-p#{RUBY_PATCHLEVEL})"
+      }
+
+      DEFAULTS = {
+          host: 'api.twilio.com',
+          port: 443,
+          use_ssl: true,
+          ssl_verify_peer: true,
+          ssl_ca_file: File.dirname(__FILE__) + '/../../../conf/cacert.pem',
+          timeout: 30,
+          proxy_addr: nil,
+          proxy_port: nil,
+          proxy_user: nil,
+          proxy_pass: nil,
+          retry_limit: 1
+      }
+
+      attr_reader :account_sid, :last_request, :last_response
+
+      def initialize(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        @config = get_defaults.merge! options
+
+        @account_sid = args[0] || Twilio.account_sid
+        @auth_token = args[1] || Twilio.auth_token
+        if @account_sid.nil? || @auth_token.nil?
+          raise ArgumentError, 'Account SID and auth token are required'
+        end
+
+        set_up_connection
+        set_up_subresources
+      end
+
+      ##
+      # Define #get, #put, #post and #delete helper methods for sending HTTP
+      # requests to Twilio. You shouldn't need to use these methods directly,
+      # but they can be useful for debugging. Each method returns a hash
+      # obtained from parsing the JSON object in the response body.
+      [:get, :put, :post, :delete].each do |method|
+        method_class = Net::HTTP.const_get method.to_s.capitalize
+        define_method method do |path, *args|
+          params = twilify(args[0])
+          params = {} if params.empty?
+          # build the full path unless already given
+          path = build_full_path(path, params, method) unless args[1]
+          request = method_class.new(path, HTTP_HEADERS)
+          request.basic_auth(@account_sid, @auth_token)
+          request.form_data = params if [:post, :put].include?(method)
+          connect_and_send(request)
+        end
+      end
+
+      protected
+
+      ##
+      # Get the default config values.
+      def get_defaults
+        # To be overridden
+        DEFAULTS
+      end
+
+      ##
+      # Builds up full request path
+      # Needs implementation in child classes
+      def build_full_path(path, params, method)
+        raise NotImplementedError
+      end
+
+      ##
+      # Set up and cache a Net::HTTP object to use when making requests. This is
+      # a private method documented for completeness.
+      def set_up_connection # :doc:
+        connection_class = Net::HTTP::Proxy @config[:proxy_addr],
+                                            @config[:proxy_port], @config[:proxy_user], @config[:proxy_pass]
+        @connection = connection_class.new @config[:host], @config[:port]
+        set_up_ssl
+        @connection.open_timeout = @config[:timeout]
+        @connection.read_timeout = @config[:timeout]
+      end
+
+      ##
+      # Set up the ssl properties of the <tt>@connection</tt> Net::HTTP object.
+      # This is a private method documented for completeness.
+      def set_up_ssl # :doc:
+        @connection.use_ssl = @config[:use_ssl]
+        if @config[:ssl_verify_peer]
+          @connection.verify_mode = OpenSSL::SSL::VERIFY_PEER
+          @connection.ca_file = @config[:ssl_ca_file]
+        else
+          @connection.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        end
+      end
+
+      ##
+      # Set up sub resources attributes.
+      def set_up_subresources # :doc:
+        # To be overridden
+      end
+
+      ##
+      # Send an HTTP request using the cached <tt>@connection</tt> object and
+      # return the JSON response body parsed into a hash. Also save the raw
+      # Net::HTTP::Request and Net::HTTP::Response objects as
+      # <tt>@last_request</tt> and <tt>@last_response</tt> to allow for
+      # inspection later.
+      def connect_and_send(request) # :doc:
+        @last_request = request
+        retries_left = @config[:retry_limit]
+        begin
+          response = @connection.request request
+          @last_response = response
+          if response.kind_of? Net::HTTPServerError
+            raise Twilio::REST::ServerError
+          end
+        rescue Exception
+          raise if request.class == Net::HTTP::Post
+          if retries_left > 0 then retries_left -= 1; retry else raise end
+        end
+        if response.body and !response.body.empty?
+          object = MultiJson.load response.body
+        end
+        if response.kind_of? Net::HTTPClientError
+          raise Twilio::REST::RequestError.new object['message'], object['code']
+        end
+        object
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/client.rb

@@ -1,116 +1,6 @@
+require 'twilio-ruby/rest/base_client'
 module Twilio
   module REST
-    class BaseClient
-      include Twilio::Util
-      include Twilio::REST::Utils
-
-      HTTP_HEADERS = {
-          'Accept' => 'application/json',
-          'Accept-Charset' => 'utf-8',
-          'User-Agent' => "twilio-ruby/#{Twilio::VERSION}" \
-                        " (#{RUBY_ENGINE}/#{RUBY_PLATFORM}" \
-                        " #{RUBY_VERSION}-p#{RUBY_PATCHLEVEL})"
-      }
-
-      DEFAULTS = {
-          host: 'api.twilio.com',
-          port: 443,
-          use_ssl: true,
-          ssl_verify_peer: true,
-          ssl_ca_file: File.dirname(__FILE__) + '/../../../conf/cacert.pem',
-          timeout: 30,
-          proxy_addr: nil,
-          proxy_port: nil,
-          proxy_user: nil,
-          proxy_pass: nil,
-          retry_limit: 1
-      }
-
-      attr_reader :account_sid, :last_request, :last_response
-
-      def initialize(*args)
-        options = args.last.is_a?(Hash) ? args.pop : {}
-        @config = get_defaults.merge! options
-
-        @account_sid = args[0] || Twilio.account_sid
-        @auth_token = args[1] || Twilio.auth_token
-        if @account_sid.nil? || @auth_token.nil?
-          raise ArgumentError, 'Account SID and auth token are required'
-        end
-
-        set_up_connection
-        set_up_subresources
-      end
-
-      protected
-
-      ##
-      # Get the default config values.
-      def get_defaults
-        # To be overridden
-        DEFAULTS
-      end
-
-      ##
-      # Set up and cache a Net::HTTP object to use when making requests. This is
-      # a private method documented for completeness.
-      def set_up_connection # :doc:
-        connection_class = Net::HTTP::Proxy @config[:proxy_addr],
-                                            @config[:proxy_port], @config[:proxy_user], @config[:proxy_pass]
-        @connection = connection_class.new @config[:host], @config[:port]
-        set_up_ssl
-        @connection.open_timeout = @config[:timeout]
-        @connection.read_timeout = @config[:timeout]
-      end
-
-      ##
-      # Set up the ssl properties of the <tt>@connection</tt> Net::HTTP object.
-      # This is a private method documented for completeness.
-      def set_up_ssl # :doc:
-        @connection.use_ssl = @config[:use_ssl]
-        if @config[:ssl_verify_peer]
-          @connection.verify_mode = OpenSSL::SSL::VERIFY_PEER
-          @connection.ca_file = @config[:ssl_ca_file]
-        else
-          @connection.verify_mode = OpenSSL::SSL::VERIFY_NONE
-        end
-      end
-
-      ##
-      # Set up sub resources attributes.
-      def set_up_subresources # :doc:
-        # To be overridden
-      end
-
-      ##
-      # Send an HTTP request using the cached <tt>@connection</tt> object and
-      # return the JSON response body parsed into a hash. Also save the raw
-      # Net::HTTP::Request and Net::HTTP::Response objects as
-      # <tt>@last_request</tt> and <tt>@last_response</tt> to allow for
-      # inspection later.
-      def connect_and_send(request) # :doc:
-        @last_request = request
-        retries_left = @config[:retry_limit]
-        begin
-          response = @connection.request request
-          @last_response = response
-          if response.kind_of? Net::HTTPServerError
-            raise Twilio::REST::ServerError
-          end
-        rescue Exception
-          raise if request.class == Net::HTTP::Post
-          if retries_left > 0 then retries_left -= 1; retry else raise end
-        end
-        if response.body and !response.body.empty?
-          object = MultiJson.load response.body
-        end
-        if response.kind_of? Net::HTTPClientError
-          raise Twilio::REST::RequestError.new object['message'], object['code']
-        end
-        object
-      end
-    end
-
     ##
     # The Twilio::REST::Client class caches authentication parameters and
     # exposes methods to make HTTP requests to Twilio's REST API. However, you
@@ -237,26 +127,6 @@ module Twilio
         "<Twilio::REST::Client @account_sid=#{@account_sid}>"
       end
 
-      ##
-      # Define #get, #put, #post and #delete helper methods for sending HTTP
-      # requests to Twilio. You shouldn't need to use these methods directly,
-      # but they can be useful for debugging. Each method returns a hash
-      # obtained from parsing the JSON object in the response body.
-      [:get, :put, :post, :delete].each do |method|
-        method_class = Net::HTTP.const_get method.to_s.capitalize
-        define_method method do |path, *args|
-          params = twilify args[0]; params = {} if params.empty?
-          unless args[1] # build the full path unless already given
-            path = "#{path}.json"
-            path << "?#{url_encode(params)}" if method == :get && !params.empty?
-          end
-          request = method_class.new path, HTTP_HEADERS
-          request.basic_auth @account_sid, @auth_token
-          request.form_data = params if [:post, :put].include? method
-          connect_and_send request
-        end
-      end
-
       ##
       # Delegate account methods from the client. This saves having to call
       # <tt>client.account</tt> every time for resources on the default
@@ -285,217 +155,14 @@ module Twilio
         @accounts = Twilio::REST::Accounts.new "/#{API_VERSION}/Accounts", self
         @account = @accounts.get @account_sid
       end
-    end
-
-    class TaskRouterClient < BaseClient
-      API_VERSION = 'v1'
-
-      DEFAULTS = {
-          host: 'taskrouter.twilio.com',
-          port: 443,
-          use_ssl: true,
-          ssl_verify_peer: true,
-          ssl_ca_file: File.dirname(__FILE__) + '/../../../conf/cacert.pem',
-          timeout: 30,
-          proxy_addr: nil,
-          proxy_port: nil,
-          proxy_user: nil,
-          proxy_pass: nil,
-          retry_limit: 1
-      }
-
-      attr_reader :workspace, :workspace_sid, :workspaces
 
       ##
-      # Instantiate a new HTTP TaskRouter client to talk to Twilio. The parameters
-      # +account_sid+, +auth_token+ and +workspace_sid are required, unless you
-      # have configured them already using the block configure syntax, and used
-      # to generate the HTTP basic auth header in each request. The +options+
-      # parameter is a hash of connection configuration options. the following
-      # keys are supported:
-      #
-      # === <tt>host: 'taskrouter.twilio.com'</tt>
-      #
-      # The domain to which you'd like the client to make HTTP requests. Useful
-      # for testing. Defaults to 'api.twilio.com'.
-      #
-      # === <tt>port: 443</tt>
-      #
-      # The port on which to connect to the above domain. Defaults to 443 and
-      # should be left that way except in testing environments.
-      #
-      # === <tt>use_ssl: true</tt>
-      #
-      # Declare whether ssl should be used for connections to the above domain.
-      # Defaults to true and should be left alone except when testing.
-      #
-      # === <tt>ssl_verify_peer: true</tt>
-      #
-      # Declare whether to verify the host's ssl cert when setting up the
-      # connection to the above domain. Defaults to true, but can be turned off
-      # to avoid ssl certificate verification failures in environments without
-      # the necessary ca certificates.
-      #
-      # === <tt>ssl_ca_file: '/path/to/ca/file'</tt>
-      #
-      # Specify the path to the certificate authority bundle you'd like to use
-      # to verify Twilio's SSL certificate on each request. If not specified, a
-      # certificate bundle extraced from Firefox is packaged with the gem and
-      # used by default.
-      #
-      # === <tt>timeout: 30</tt>
-      #
-      # Set the time in seconds to wait before timing out the HTTP request.
-      # Defaults to 30 seconds. If you aren't fetching giant pages of call or
-      # SMS logs you can safely decrease this to something like 3 seconds or
-      # lower. In paricular if you are sending SMS you can set this to 1 second
-      # or less and swallow the exception if you don't care about the response.
-      #
-      # === <tt>proxy_addr: 'proxy.host.domain'</tt>
-      #
-      # The domain of a proxy through which you'd like the client to make HTTP
-      # requests. Defaults to nil.
-      #
-      # === <tt>proxy_port: 3128</tt>
-      #
-      # The port on which to connect to the above proxy. Defaults to nil.
-      #
-      # === <tt>proxy_user: 'username'</tt>
-      #
-      # The user name to use for authentication with the proxy. Defaults to nil.
-      #
-      # === <tt>proxy_pass: 'password'</tt>
-      #
-      # The password to use for authentication with the proxy. Defaults to nil.
-      #
-      # === <tt>retry_limit: 1</tt>
-      #
-      # The number of times to retry a request that has failed before throwing
-      # an exception. Defaults to one.
-      def initialize(*args)
-        @workspace_sid = args[2]
-        if @workspace_sid.nil?
-          raise ArgumentError, 'Workspace SID is required'
-        end
-        super(*args)
-      end
-
-      ##
-      # Define #get, #put, #post and #delete helper methods for sending HTTP
-      # requests to Twilio. You shouldn't need to use these methods directly,
-      # but they can be useful for debugging. Each method returns a hash
-      # obtained from parsing the JSON object in the response body.
-      [:get, :put, :post, :delete].each do |method|
-        method_class = Net::HTTP.const_get method.to_s.capitalize
-        define_method method do |path, *args|
-          params = twilify args[0]; params = {} if params.empty?
-          unless args[1] # build the full path unless already given
-            path = path.dup
-            path << "?#{url_encode(params)}" if method == :get && !params.empty?
-          end
-          request = method_class.new path, HTTP_HEADERS
-          request.basic_auth @account_sid, @auth_token
-          request.form_data = params if [:post, :put].include? method
-          connect_and_send request
-        end
-      end
-
-      def inspect # :nodoc:
-        "<Twilio::REST::TaskRouterClient @account_sid=#{@account_sid}>"
-      end
-
-      ##
-      # Delegate workspace methods from the client. This saves having to call
-      # <tt>client.workspace</tt> every time for resources on the default
-      # workspace.
-      def method_missing(method_name, *args, &block)
-        if workspace.respond_to?(method_name)
-          workspace.send(method_name, *args, &block)
-        else
-          super
-        end
+      # Builds up full request path
+      def build_full_path(path, params, method)
+        path = "#{path}.json"
+        path << "?#{url_encode(params)}" if method == :get && !params.empty?
+        path
       end
-
-      def respond_to?(method_name, include_private=false)
-        if workspace.respond_to?(method_name, include_private)
-          true
-        else
-          super
-        end
-      end
-
-      ##
-      # Get statistics of a task queue.
-      def task_queue_statistics(task_queue_sid, *args) # :doc:
-        if task_queue_sid.nil?
-          raise ArgumentError, 'Task queue SID is required'
-        end
-        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/TaskQueues/#{task_queue_sid}/Statistics"
-        response = get path, args, true
-        Twilio::REST::TaskRouter::TaskQueueStatistics.new path, self, response
-      end
-
-      ##
-      # Get statistics of task queues.
-      def task_queues_statistics(*args) # :doc:
-        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/TaskQueues/Statistics"
-        stats = Twilio::REST::TaskRouter::TaskQueuesStatistics.new path, self
-        stats.list args, true
-      end
-
-      ##
-      # Get statistics of a worker.
-      def worker_statistics(worker_sid, *args) # :doc:
-        if worker_sid.nil?
-          raise ArgumentError, 'Worker SID is required'
-        end
-        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/Workers/#{worker_sid}/Statistics"
-        response = get path, args, true
-        Twilio::REST::TaskRouter::WorkerStatistics.new path, self, response
-      end
-
-      ##
-      # Get statistics of workers.
-      def workers_statistics(*args) # :doc:
-        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/Workers/Statistics"
-        response = get path, args, true
-        Twilio::REST::TaskRouter::WorkersStatistics.new path, self, response
-      end
-
-      ##
-      # Get statistics of a workflow.
-      def workflow_statistics(workflow_sid, *args) # :doc:
-        if workflow_sid.nil?
-          raise ArgumentError, 'Workflow SID is required'
-        end
-        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/Workflows/#{workflow_sid}/Statistics"
-        response = get path, args, true
-        Twilio::REST::TaskRouter::WorkflowStatistics.new path, self, response
-      end
-
-      ##
-      # Get statistics of a workspace.
-      def workspace_statistics(*args) # :doc:
-        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/Statistics"
-        response = get path, args, true
-        Twilio::REST::TaskRouter::WorkspaceStatistics.new path, self, response
-      end
-
-      protected
-
-      ##
-      # Get the default config values.
-      def get_defaults
-        DEFAULTS
-      end
-
-      ##
-      # Set up +workspace+ and +workspaces+ attributes.
-      def set_up_subresources # :doc:
-        @workspaces = Twilio::REST::TaskRouter::Workspaces.new "/#{API_VERSION}/Workspaces", self
-        @workspace = @workspaces.get @workspace_sid
-      end
-
     end
   end
 end

data/lib/twilio-ruby/rest/lookups/phone_numbers.rb

@@ -0,0 +1,8 @@
+module Twilio
+  module REST
+    module Lookups
+      class PhoneNumbers < Twilio::REST::NextGenListResource; end
+      class PhoneNumber < InstanceResource; end
+    end
+  end
+end

data/lib/twilio-ruby/rest/lookups_client.rb

@@ -0,0 +1,117 @@
+require 'twilio-ruby/rest/base_client'
+module Twilio
+  module REST
+    class LookupsClient < BaseClient
+      API_VERSION = 'v1'
+
+      DEFAULTS = {
+          host: 'lookups.twilio.com',
+          port: 443,
+          use_ssl: true,
+          ssl_verify_peer: true,
+          ssl_ca_file: File.dirname(__FILE__) + '/../../../conf/cacert.pem',
+          timeout: 30,
+          proxy_addr: nil,
+          proxy_port: nil,
+          proxy_user: nil,
+          proxy_pass: nil,
+          retry_limit: 1
+      }
+
+      attr_reader :phone_numbers
+
+      ##
+      # Instantiate a new HTTP Lookups client to talk to Twilio. The parameters
+      # +account_sid+, +auth_token+ and +workspace_sid are required, unless you
+      # have configured them already using the block configure syntax, and used
+      # to generate the HTTP basic auth header in each request. The +options+
+      # parameter is a hash of connection configuration options. the following
+      # keys are supported:
+      #
+      # === <tt>host: 'lookups.twilio.com'</tt>
+      #
+      # The domain to which you'd like the client to make HTTP requests. Useful
+      # for testing. Defaults to 'lookups.twilio.com'.
+      #
+      # === <tt>port: 443</tt>
+      #
+      # The port on which to connect to the above domain. Defaults to 443 and
+      # should be left that way except in testing environments.
+      #
+      # === <tt>use_ssl: true</tt>
+      #
+      # Declare whether ssl should be used for connections to the above domain.
+      # Defaults to true and should be left alone except when testing.
+      #
+      # === <tt>ssl_verify_peer: true</tt>
+      #
+      # Declare whether to verify the host's ssl cert when setting up the
+      # connection to the above domain. Defaults to true, but can be turned off
+      # to avoid ssl certificate verification failures in environments without
+      # the necessary ca certificates.
+      #
+      # === <tt>ssl_ca_file: '/path/to/ca/file'</tt>
+      #
+      # Specify the path to the certificate authority bundle you'd like to use
+      # to verify Twilio's SSL certificate on each request. If not specified, a
+      # certificate bundle extraced from Firefox is packaged with the gem and
+      # used by default.
+      #
+      # === <tt>timeout: 30</tt>
+      #
+      # Set the time in seconds to wait before timing out the HTTP request.
+      # Defaults to 30 seconds. If you aren't fetching giant pages of call or
+      # SMS logs you can safely decrease this to something like 3 seconds or
+      # lower. In paricular if you are sending SMS you can set this to 1 second
+      # or less and swallow the exception if you don't care about the response.
+      #
+      # === <tt>proxy_addr: 'proxy.host.domain'</tt>
+      #
+      # The domain of a proxy through which you'd like the client to make HTTP
+      # requests. Defaults to nil.
+      #
+      # === <tt>proxy_port: 3128</tt>
+      #
+      # The port on which to connect to the above proxy. Defaults to nil.
+      #
+      # === <tt>proxy_user: 'username'</tt>
+      #
+      # The user name to use for authentication with the proxy. Defaults to nil.
+      #
+      # === <tt>proxy_pass: 'password'</tt>
+      #
+      # The password to use for authentication with the proxy. Defaults to nil.
+      #
+      # === <tt>retry_limit: 1</tt>
+      #
+      # The number of times to retry a request that has failed before throwing
+      # an exception. Defaults to one.
+      def inspect # :nodoc:
+        "<Twilio::REST::LookupsClient @account_sid=#{@account_sid}>"
+      end
+
+      protected
+
+      ##
+      # Get the default config values.
+      def get_defaults
+        DEFAULTS
+      end
+
+      ##
+      # Set up +phone_numbers+ attribute.
+      def set_up_subresources # :doc:
+        @phone_numbers = Twilio::REST::Lookups::PhoneNumbers.new "/#{API_VERSION}/PhoneNumbers", self
+      end
+
+      ##
+      # Builds up full request path
+      def build_full_path(path, params, method)
+        path = path.dup
+        path << "?#{url_encode(params)}" if method == :get && !params.empty?
+        path
+      end
+
+    end
+  end
+end

data/lib/twilio-ruby/rest/task_router_client.rb

@@ -0,0 +1,203 @@
+require 'twilio-ruby/rest/base_client'
+module Twilio
+  module REST
+    class TaskRouterClient < BaseClient
+      API_VERSION = 'v1'
+
+      DEFAULTS = {
+          host: 'taskrouter.twilio.com',
+          port: 443,
+          use_ssl: true,
+          ssl_verify_peer: true,
+          ssl_ca_file: File.dirname(__FILE__) + '/../../../conf/cacert.pem',
+          timeout: 30,
+          proxy_addr: nil,
+          proxy_port: nil,
+          proxy_user: nil,
+          proxy_pass: nil,
+          retry_limit: 1
+      }
+
+      attr_reader :workspace, :workspace_sid, :workspaces
+
+      ##
+      # Instantiate a new HTTP TaskRouter client to talk to Twilio. The parameters
+      # +account_sid+, +auth_token+ and +workspace_sid are required, unless you
+      # have configured them already using the block configure syntax, and used
+      # to generate the HTTP basic auth header in each request. The +options+
+      # parameter is a hash of connection configuration options. the following
+      # keys are supported:
+      #
+      # === <tt>host: 'taskrouter.twilio.com'</tt>
+      #
+      # The domain to which you'd like the client to make HTTP requests. Useful
+      # for testing. Defaults to 'api.twilio.com'.
+      #
+      # === <tt>port: 443</tt>
+      #
+      # The port on which to connect to the above domain. Defaults to 443 and
+      # should be left that way except in testing environments.
+      #
+      # === <tt>use_ssl: true</tt>
+      #
+      # Declare whether ssl should be used for connections to the above domain.
+      # Defaults to true and should be left alone except when testing.
+      #
+      # === <tt>ssl_verify_peer: true</tt>
+      #
+      # Declare whether to verify the host's ssl cert when setting up the
+      # connection to the above domain. Defaults to true, but can be turned off
+      # to avoid ssl certificate verification failures in environments without
+      # the necessary ca certificates.
+      #
+      # === <tt>ssl_ca_file: '/path/to/ca/file'</tt>
+      #
+      # Specify the path to the certificate authority bundle you'd like to use
+      # to verify Twilio's SSL certificate on each request. If not specified, a
+      # certificate bundle extraced from Firefox is packaged with the gem and
+      # used by default.
+      #
+      # === <tt>timeout: 30</tt>
+      #
+      # Set the time in seconds to wait before timing out the HTTP request.
+      # Defaults to 30 seconds. If you aren't fetching giant pages of call or
+      # SMS logs you can safely decrease this to something like 3 seconds or
+      # lower. In paricular if you are sending SMS you can set this to 1 second
+      # or less and swallow the exception if you don't care about the response.
+      #
+      # === <tt>proxy_addr: 'proxy.host.domain'</tt>
+      #
+      # The domain of a proxy through which you'd like the client to make HTTP
+      # requests. Defaults to nil.
+      #
+      # === <tt>proxy_port: 3128</tt>
+      #
+      # The port on which to connect to the above proxy. Defaults to nil.
+      #
+      # === <tt>proxy_user: 'username'</tt>
+      #
+      # The user name to use for authentication with the proxy. Defaults to nil.
+      #
+      # === <tt>proxy_pass: 'password'</tt>
+      #
+      # The password to use for authentication with the proxy. Defaults to nil.
+      #
+      # === <tt>retry_limit: 1</tt>
+      #
+      # The number of times to retry a request that has failed before throwing
+      # an exception. Defaults to one.
+      def initialize(*args)
+        @workspace_sid = args[2]
+        if @workspace_sid.nil?
+          raise ArgumentError, 'Workspace SID is required'
+        end
+        super(*args)
+      end
+
+      def inspect # :nodoc:
+        "<Twilio::REST::TaskRouterClient @account_sid=#{@account_sid}>"
+      end
+
+      ##
+      # Delegate workspace methods from the client. This saves having to call
+      # <tt>client.workspace</tt> every time for resources on the default
+      # workspace.
+      def method_missing(method_name, *args, &block)
+        if workspace.respond_to?(method_name)
+          workspace.send(method_name, *args, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to?(method_name, include_private=false)
+        if workspace.respond_to?(method_name, include_private)
+          true
+        else
+          super
+        end
+      end
+
+      ##
+      # Get statistics of a task queue.
+      def task_queue_statistics(task_queue_sid, *args) # :doc:
+        if task_queue_sid.nil?
+          raise ArgumentError, 'Task queue SID is required'
+        end
+        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/TaskQueues/#{task_queue_sid}/Statistics"
+        response = get path, args, true
+        Twilio::REST::TaskRouter::TaskQueueStatistics.new path, self, response
+      end
+
+      ##
+      # Get statistics of task queues.
+      def task_queues_statistics(*args) # :doc:
+        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/TaskQueues/Statistics"
+        stats = Twilio::REST::TaskRouter::TaskQueuesStatistics.new path, self
+        stats.list args, true
+      end
+
+      ##
+      # Get statistics of a worker.
+      def worker_statistics(worker_sid, *args) # :doc:
+        if worker_sid.nil?
+          raise ArgumentError, 'Worker SID is required'
+        end
+        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/Workers/#{worker_sid}/Statistics"
+        response = get path, args, true
+        Twilio::REST::TaskRouter::WorkerStatistics.new path, self, response
+      end
+
+      ##
+      # Get statistics of workers.
+      def workers_statistics(*args) # :doc:
+        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/Workers/Statistics"
+        response = get path, args, true
+        Twilio::REST::TaskRouter::WorkersStatistics.new path, self, response
+      end
+
+      ##
+      # Get statistics of a workflow.
+      def workflow_statistics(workflow_sid, *args) # :doc:
+        if workflow_sid.nil?
+          raise ArgumentError, 'Workflow SID is required'
+        end
+        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/Workflows/#{workflow_sid}/Statistics"
+        response = get path, args, true
+        Twilio::REST::TaskRouter::WorkflowStatistics.new path, self, response
+      end
+
+      ##
+      # Get statistics of a workspace.
+      def workspace_statistics(*args) # :doc:
+        path = "/#{API_VERSION}/Workspaces/#{@workspace_sid}/Statistics"
+        response = get path, args, true
+        Twilio::REST::TaskRouter::WorkspaceStatistics.new path, self, response
+      end
+
+      protected
+
+      ##
+      # Get the default config values.
+      def get_defaults
+        DEFAULTS
+      end
+
+      ##
+      # Set up +workspace+ and +workspaces+ attributes.
+      def set_up_subresources # :doc:
+        @workspaces = Twilio::REST::TaskRouter::Workspaces.new "/#{API_VERSION}/Workspaces", self
+        @workspace = @workspaces.get @workspace_sid
+      end
+
+      ##
+      # Builds up full request path
+      def build_full_path(path, params, method)
+        path = path.dup
+        path << "?#{url_encode(params)}" if method == :get && !params.empty?
+        path
+      end
+
+    end
+  end
+end

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-  VERSION = '3.15.2'
+  VERSION = '3.16.0'
 end

data/spec/rest/lookups/phone_number_spec.rb

@@ -0,0 +1,8 @@
+require 'spec_helper'
+
+describe Twilio::REST::Lookups::PhoneNumbers do
+  it 'creates a phone_number object' do
+    client = Twilio::REST::LookupsClient.new 'otherSid', 'otherToken'
+    expect(client).to respond_to(:phone_numbers)
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twilio-ruby
 version: !ruby/object:Gem::Version
-  version: 3.15.2
+  version: 3.16.0
 platform: ruby
 authors:
 - Andrew Benton
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-10 00:00:00.000000000 Z
+date: 2015-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -139,6 +139,7 @@ files:
 - lib/twilio-ruby/rest/available_phone_numbers/local.rb
 - lib/twilio-ruby/rest/available_phone_numbers/mobile.rb
 - lib/twilio-ruby/rest/available_phone_numbers/toll_free.rb
+- lib/twilio-ruby/rest/base_client.rb
 - lib/twilio-ruby/rest/call_feedback.rb
 - lib/twilio-ruby/rest/call_feedback_summary.rb
 - lib/twilio-ruby/rest/calls.rb
@@ -153,6 +154,8 @@ files:
 - lib/twilio-ruby/rest/incoming_phone_numbers/toll_free.rb
 - lib/twilio-ruby/rest/instance_resource.rb
 - lib/twilio-ruby/rest/list_resource.rb
+- lib/twilio-ruby/rest/lookups/phone_numbers.rb
+- lib/twilio-ruby/rest/lookups_client.rb
 - lib/twilio-ruby/rest/media.rb
 - lib/twilio-ruby/rest/messages.rb
 - lib/twilio-ruby/rest/next_gen_list_resource.rb
@@ -185,6 +188,7 @@ files:
 - lib/twilio-ruby/rest/task_router/workflows.rb
 - lib/twilio-ruby/rest/task_router/workspace_statistics.rb
 - lib/twilio-ruby/rest/task_router/workspaces.rb
+- lib/twilio-ruby/rest/task_router_client.rb
 - lib/twilio-ruby/rest/tokens.rb
 - lib/twilio-ruby/rest/transcriptions.rb
 - lib/twilio-ruby/rest/usage.rb
@@ -208,6 +212,7 @@ files:
 - spec/rest/client_spec.rb
 - spec/rest/conference_spec.rb
 - spec/rest/instance_resource_spec.rb
+- spec/rest/lookups/phone_number_spec.rb
 - spec/rest/message_spec.rb
 - spec/rest/numbers_spec.rb
 - spec/rest/queue_spec.rb
@@ -268,6 +273,7 @@ test_files:
 - spec/rest/client_spec.rb
 - spec/rest/conference_spec.rb
 - spec/rest/instance_resource_spec.rb
+- spec/rest/lookups/phone_number_spec.rb
 - spec/rest/message_spec.rb
 - spec/rest/numbers_spec.rb
 - spec/rest/queue_spec.rb