twilio-ruby 4.6.1 → 6.9.0

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

@@ -1,87 +0,0 @@
-module Twilio
-  module REST
-    ##
-    # A class to wrap an instance resource (like a call or application) within
-    # the Twilio API. All other instance resource classes within this library
-    # inherit from this class. You shouldn't need to instantiate this class
-    # directly. But reviewing the available methods is informative since they
-    # are rarely overridden in the inheriting class.
-    class InstanceResource
-      include Utils
-
-      ##
-      # Instantiate a new instance resource object. You must pass the +path+ of
-      # the instance (e.g. /2010-04-01/Accounts/AC123/Calls/CA456) as well as a
-      # +client+ object that responds to #get #post and #delete. This client
-      # is meant to be an instance of Twilio::REST::Client but could just as
-      # well be a mock object if you want to test the interface. The optional
-      # +params+ hash will be converted into attributes on the instantiated
-      # object.
-      def initialize(path, client, params = {})
-        @path, @client = path, client
-        set_up_properties_from params
-      end
-
-      def inspect # :nodoc:
-        "<#{self.class} @path=#{@path}>"
-      end
-
-      ##
-      # Update the properties of this instance resource using the key/value
-      # pairs in +params+. This makes an HTTP POST request to <tt>@path</tt>
-      # to handle the update. For example, to update the +VoiceUrl+ of a Twilio
-      # Application you could write:
-      #
-      #   @app.update voice_url: 'http://my.other.app.com/handle_voice'
-      #
-      # After returning, the object will contain the most recent state of the
-      # instance resource, including the newly updated properties.
-      def update(params = {})
-        raise "Can't update a resource without a REST Client" unless @client
-        set_up_properties_from(@client.post(@path, params))
-        self
-      end
-
-      ##
-      # Refresh the attributes of this instance resource object by fetching it
-      # from Twilio. Calling this makes an HTTP GET request to <tt>@path</tt>.
-      def refresh
-        raise "Can't refresh a resource without a REST Client" unless @client
-        @updated = false
-        set_up_properties_from(@client.get(@path))
-        self
-      end
-
-      ##
-      # Delete an instance resource from Twilio. This operation isn't always
-      # supported. For instance, you can't delete an SMS. Calling this method
-      # makes an HTTP DELETE request to <tt>@path</tt>.
-      def delete
-        raise "Can't delete a resource without a REST Client" unless @client
-        @client.delete @path
-      end
-
-      ##
-      # Lazily load attributes of the instance resource by waiting to fetch it
-      # until an attempt is made to access an unknown attribute.
-      def method_missing(method, *args)
-        super if @updated
-        set_up_properties_from(@client.get(@path))
-        self.send method, *args
-      end
-
-      protected
-
-      def set_up_properties_from(hash)
-        eigenclass = class << self; self; end
-        hash.each do |p,v|
-          property = detwilify p
-          unless ['client', 'updated'].include? property
-            eigenclass.send :define_method, property.to_sym, &lambda { v }
-          end
-        end
-        @updated = !hash.keys.empty?
-      end
-    end
-  end
-end

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

@@ -1,6 +0,0 @@
-module Twilio
-  module REST
-    class Keys < ListResource; end
-    class Key < InstanceResource; end
-  end
-end

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

@@ -1,100 +0,0 @@
-module Twilio
-  module REST
-    class ListResource
-      include Utils
-
-      def initialize(path, client)
-        custom_names = {
-          'Activities' => 'Activity',
-          'Addresses' => 'Address',
-          'Countries' => 'Country',
-          'Feedback' => 'FeedbackInstance',
-          'IpAddresses' => 'IpAddress',
-          'Media' => 'MediaInstance',
-        }
-        @path, @client = path, client
-        resource_name = self.class.name.split('::')[-1]
-        instance_name = custom_names.fetch(resource_name, resource_name.chop)
-
-        # The next line grabs the enclosing module. Necessary for resources
-        # contained in their own submodule like /SMS/Messages
-        parent_module = self.class.to_s.split('::')[-2]
-        full_module_path = if parent_module == "REST"
-          Twilio::REST
-        else
-          Twilio::REST.const_get parent_module
-        end
-
-        @instance_class = full_module_path.const_get instance_name
-        @list_key, @instance_id_key = detwilify(resource_name), 'sid'
-      end
-
-      def inspect # :nodoc:
-        "<#{self.class} @path=#{@path}>"
-      end
-
-      ##
-      # Grab a list of this kind of resource and return it as an array. The
-      # array includes two special methods +previous_page+ and +next_page+
-      # which will return the previous or next page or resources. By default
-      # Twilio will only return 50 resources, and the maximum number of
-      # resources you can request (using the :page_size param) is 1000.
-      #
-      # The optional +params+ hash allows you to filter the list returned. The
-      # filters for each list resource type are defined by Twilio.
-      def list(params={}, full_path=false)
-        raise "Can't get a resource list without a REST Client" unless @client
-        response = @client.get @path, params, full_path
-        resources = response[@list_key]
-        path = full_path ? @path.split('.')[0] : @path
-        resource_list = resources.map do |resource|
-          @instance_class.new "#{path}/#{resource[@instance_id_key]}", @client,
-            resource
-        end
-        # set the +previous_page+ and +next_page+ properties on the array
-        client, list_class = @client, self.class
-        resource_list.instance_eval do
-          eigenclass = class << self; self; end
-          eigenclass.send :define_method, :previous_page, &lambda {
-            if response['previous_page_uri']
-              list_class.new(response['previous_page_uri'], client).list({}, true)
-            else
-              []
-            end
-          }
-          eigenclass.send :define_method, :next_page, &lambda {
-            if response['next_page_uri']
-              list_class.new(response['next_page_uri'], client).list({}, true)
-            else
-              []
-            end
-          }
-        end
-        resource_list
-      end
-
-      ##
-      # Return an empty instance resource object with the proper path. Note that
-      # this will never raise a Twilio::REST::RequestError on 404 since no HTTP
-      # request is made. The HTTP request is made when attempting to access an
-      # attribute of the returned instance resource object, such as
-      # its #date_created or #voice_url attributes.
-      def get(sid)
-        @instance_class.new "#{@path}/#{sid}", @client
-      end
-      alias :find :get # for the ActiveRecord lovers
-
-      ##
-      # Return a newly created resource. Some +params+ may be required. Consult
-      # the Twilio REST API documentation related to the kind of resource you
-      # are attempting to create for details. Calling this method makes an HTTP
-      # POST request to <tt>@path</tt> with the given params
-      def create(params={})
-        raise "Can't create a resource without a REST Client" unless @client
-        response = @client.post @path, params
-        @instance_class.new "#{@path}/#{response[@instance_id_key]}", @client,
-          response
-      end
-    end
-  end
-end

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

@@ -1,17 +0,0 @@
-module Twilio
-  module REST
-    module Lookups
-      class PhoneNumbers < Twilio::REST::NextGenListResource;
-        include Twilio::Util
-        include Twilio::REST::Utils
-
-        def get(number, query={})
-          full_path = "#{@path}/#{URI.encode(number)}"
-          full_path << "?#{url_encode(twilify(query))}" if !query.empty?
-          @instance_class.new full_path, @client
-        end
-      end
-      class PhoneNumber < InstanceResource; end
-    end
-  end
-end

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

@@ -1,99 +0,0 @@
-require 'twilio-ruby/rest/base_client'
-module Twilio
-  module REST
-    class LookupsClient < BaseClient
-      API_VERSION = 'v1'
-
-      attr_reader :phone_numbers
-
-      host 'lookups.twilio.com'
-
-      ##
-      # 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
-
-      ##
-      # 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/messages.rb

@@ -1,22 +0,0 @@
-module Twilio
-  module REST
-    class Messages < ListResource
-      def initialize(path, client)
-        path.gsub! '/SMS', ''
-        super
-      end
-    end
-
-    class Message < InstanceResource
-      def initialize(path, client, params={})
-        super
-        resource :media
-      end
-
-      def redact()
-        update({body: ''})
-      end
-
-    end
-  end
-end

data/lib/twilio-ruby/rest/monitor/alerts.rb

@@ -1,8 +0,0 @@
-module Twilio
-  module REST
-    module Monitor
-      class Alerts < NextGenListResource; end
-      class Alert < InstanceResource; end
-    end
-  end
-end

data/lib/twilio-ruby/rest/monitor/events.rb

@@ -1,8 +0,0 @@
-module Twilio
-  module REST
-    module Monitor
-      class Events < NextGenListResource; end
-      class Event < InstanceResource; end
-    end
-  end
-end

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

@@ -1,101 +0,0 @@
-require 'twilio-ruby/rest/base_client'
-module Twilio
-  module REST
-    class MonitorClient < BaseClient
-      API_VERSION = 'v1'
-
-      attr_reader :events
-      attr_reader :alerts
-
-      host 'monitor.twilio.com'
-
-      ##
-      # Instantiate a new HTTP Monitor client to talk to Twilio. The parameters
-      # +account_sid+, +auth_token+ 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: 'monitor.twilio.com'</tt>
-      #
-      # The domain to which you'd like the client to make HTTP requests. Useful
-      # for testing. Defaults to 'monitor.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::MonitorClient @account_sid=#{@account_sid}>"
-      end
-
-      protected
-
-      ##
-      # Set up +events+ attribute.
-      def set_up_subresources # :doc:
-        @events = Twilio::REST::Monitor::Events.new "/#{API_VERSION}/Events", self
-        @alerts = Twilio::REST::Monitor::Alerts.new "/#{API_VERSION}/Alerts", 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/next_gen_list_resource.rb

@@ -1,36 +0,0 @@
-module Twilio
-  module REST
-    class NextGenListResource < Twilio::REST::ListResource
-      def list(params={}, full_path=false)
-        raise "Can't get a resource list without a REST Client" unless @client
-        response = @client.get @path, params, full_path
-        list_key = response['meta']['key']
-        raise "Couldn't find a list key in response meta" unless list_key
-        resources = response[list_key]
-        resource_list = resources.map do |resource|
-          @instance_class.new "#{@path}/#{resource[@instance_id_key]}", @client,
-                              resource
-        end
-        client, list_class = @client, self.class
-        resource_list.instance_eval do
-          eigenclass = class << self; self; end
-          eigenclass.send :define_method, :next_page, &lambda {
-            if response['meta']['next_page_url']
-              list_class.new(response['meta']['next_page_url'], client).list({})
-            else
-              []
-            end
-          }
-          eigenclass.send :define_method, :previous_page, &lambda {
-            if response['meta']['previous_page_url']
-              list_class.new(response['meta']['previous_page_url'], client).list({})
-            else
-              []
-            end
-          }
-        end
-        resource_list
-      end
-    end
-  end
-end

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

@@ -1,6 +0,0 @@
-module Twilio
-  module REST
-    class Notifications < ListResource; end
-    class Notification < InstanceResource; end
-  end
-end

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

@@ -1,25 +0,0 @@
-module Twilio
-  module REST
-    class OutgoingCallerIds < ListResource
-      def add(phone_number)
-        create phone_number: phone_number
-      end
-      alias :verify :add
-
-      ##
-      # Override ListResource#create to instantiate the proper instance class.
-      # This doesn't actually matter since all properties are lazily loaded into
-      # whatever object is instantiated. But it might matter in the future.
-      def create(params={}) # :nodoc:
-        old_instance_class = @instance_class
-        @instance_class = Twilio::REST::PhoneNumberVerificationRequest
-        verification_request = super
-        @instance_class = old_instance_class
-        verification_request
-      end
-    end
-
-    class OutgoingCallerId < InstanceResource; end
-    class PhoneNumberVerificationRequest < InstanceResource; end
-  end
-end

data/lib/twilio-ruby/rest/pricing/countries.rb

@@ -1,21 +0,0 @@
-module Twilio
-  module REST
-    module Pricing
-      class Countries < NextGenListResource
-        def initialize(path, client)
-          super
-          @list_key = 'countries'
-          @instance_id_key = 'iso_country'
-          @submodule = :Pricing
-        end
-      end
-
-      class Country < InstanceResource
-        def initialize(path, client, params={})
-          super
-          @submodule = :Pricing
-        end
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/pricing/messaging.rb

@@ -1,15 +0,0 @@
-module Twilio
-  module REST
-    module Pricing
-      class Messaging < InstanceResource
-
-        def initialize(path, client, params={})
-          super
-          @submodule = :Pricing
-          resource :countries
-        end
-
-      end
-    end
-  end
-end

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

@@ -1,14 +0,0 @@
-module Twilio
-  module REST
-    module Pricing
-      class PhoneNumbers < InstanceResource
-
-        def initialize(path, client, params={})
-          super
-          @submodule = :Pricing
-          resource :countries
-        end
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/pricing/voice/numbers.rb

@@ -1,19 +0,0 @@
-module Twilio
-  module REST
-    module Pricing
-      class Numbers < NextGenListResource
-        def initialize(path, client)
-          super
-          @submodule = :Pricing
-        end
-      end
-
-      class Number < InstanceResource
-        def initialize(path, client)
-          super
-          @submodule = :Pricing
-        end
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/pricing/voice.rb

@@ -1,15 +0,0 @@
-module Twilio
-  module REST
-    module Pricing
-      class Voice < InstanceResource
-
-        def initialize(path, client, params={})
-          super
-          @submodule = :Pricing
-          resource :countries, :numbers
-        end
-
-      end
-    end
-  end
-end