twilio-ruby 4.13.0 → 5.0.0.alpha1

data/lib/twilio-ruby/rest/addresses/dependent_phone_numbers.rb

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

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

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

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

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

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

@@ -1,13 +0,0 @@
-module Twilio
-  module REST
-    class AvailablePhoneNumbers < ListResource
-      def initialize(path, client)
-        @path, @client = path, client
-        @instance_class = Twilio::REST::Country
-        @list_key, @instance_id_key = 'countries', 'country_code'
-      end
-    end
-
-    class AvailablePhoneNumber < InstanceResource; end
-  end
-end

data/lib/twilio-ruby/rest/available_phone_numbers/country.rb

@@ -1,10 +0,0 @@
-module Twilio
-  module REST
-    class Country < InstanceResource
-      def initialize(path, client, params={})
-        super path, client, params
-        resource :local, :toll_free, :mobile
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/available_phone_numbers/local.rb

@@ -1,11 +0,0 @@
-module Twilio
-  module REST
-    class Local < ListResource
-      def initialize(path, client)
-        @path, @client = path, client
-        @instance_class = Twilio::REST::AvailablePhoneNumber
-        @list_key, @instance_id_key = 'available_phone_numbers', 'sid'
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/available_phone_numbers/mobile.rb

@@ -1,11 +0,0 @@
-module Twilio
-  module REST
-    class Mobile < ListResource
-      def initialize(path, client)
-        @path, @client = path, client
-        @instance_class = Twilio::REST::AvailablePhoneNumber
-        @list_key, @instance_id_key = 'available_phone_numbers', 'sid'
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/available_phone_numbers/toll_free.rb

@@ -1,11 +0,0 @@
-module Twilio
-  module REST
-    class TollFree < ListResource
-      def initialize(path, client)
-        @path, @client = path, client
-        @instance_class = Twilio::REST::AvailablePhoneNumber
-        @list_key, @instance_id_key = 'available_phone_numbers', 'sid'
-      end
-    end
-  end
-end

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

@@ -1,131 +0,0 @@
-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})"
-      }
-
-      ##
-      # Override the default host for a REST Client (api.twilio.com)
-      def self.host(host=nil)
-        return @host unless host
-        @host = host
-      end
-
-      attr_reader :account_sid, :last_request, :last_response
-
-      def initialize(*args)
-        options = args.last.is_a?(Hash) ? args.pop : {}
-        options[:host] ||= self.class.host
-        @config = Twilio::Util::ClientConfig.new options
-
-        @username = args[0] || Twilio.account_sid
-        @auth_token = args[1] || Twilio.auth_token
-        @account_sid = (args.size > 2 && args[2].is_a?(String) ? args[2] : args[0]) || Twilio.account_sid
-        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(@username, @auth_token)
-          request.form_data = params if [:post, :put].include?(method)
-          connect_and_send(request)
-        end
-      end
-
-      protected
-
-      ##
-      # 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
-          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
-        elsif response.kind_of? Net::HTTPBadRequest
-          object = { message: 'Bad request', code: 400 }
-        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/call_feedback.rb

@@ -1,28 +0,0 @@
-module Twilio
-  module REST
-    class Feedback < ListResource;
-
-      ##
-      # Get this feedback object.
-      #
-      # Overridden because GETS to /Feedback
-      # returns an instance, not a list.
-      def get(params={}, full_path=false)
-        raise "Can't fetch feedback without a REST Client" unless @client
-        response = @client.get @path, params, full_path
-        path = full_path ? @path.split('.')[0] : @path
-        @instance_class.new path, @client, response
-      end
-
-      ##
-      # Creates a new Feedback object.
-      def create(params={})
-        raise "Can't create feedback without a REST Client" unless @client
-        response = @client.post @path, params
-        @instance_class.new @path, @client, response
-      end
-    end
-
-    class FeedbackInstance < InstanceResource; end
-  end
-end

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

@@ -1,13 +0,0 @@
-module Twilio
-  module REST
-    class FeedbackSummary < ListResource
-      def initialize(path, client)
-        @path, @client = path, client
-        @instance_class = Twilio::REST::FeedbackSummaryInstance
-        @list_key, @instance_id_key = 'feedback_summary', 'sid'
-      end
-    end
-
-    class FeedbackSummaryInstance < InstanceResource; end
-  end
-end

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

@@ -1,33 +0,0 @@
-module Twilio
-  module REST
-    class Calls < ListResource
-      def initialize(path, client)
-        super
-        resource :feedback_summary
-      end
-
-      def make(from, to, url)
-        create from: from, to: to, url: url
-      end
-    end
-
-    class Call < InstanceResource
-      def initialize(path, client, params={})
-        super path, client, params
-        resource :recordings, :notifications, :feedback
-      end
-
-      def redirect_to(url)
-        update url: url
-      end
-
-      def cancel
-        update status: 'canceled'
-      end
-
-      def hangup
-        update status: 'completed'
-      end
-    end
-  end
-end

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

@@ -1,12 +0,0 @@
-module Twilio
-  module REST
-    class Conferences < ListResource; end
-
-    class Conference < InstanceResource
-      def initialize(path, client, params={})
-        super path, client, params
-        resource :participants
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/conferences/participants.rb

@@ -1,23 +0,0 @@
-module Twilio
-  module REST
-    class Participants < ListResource
-      def initialize(path, client)
-        super
-        # hard-code the json key since participants don't have sids
-        @instance_id_key = 'call_sid'
-      end
-    end
-
-    class Participant < InstanceResource
-      def mute
-        update muted: 'true'
-      end
-
-      def unmute
-        update muted: 'false'
-      end
-
-      alias :kick :delete
-    end
-  end
-end

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

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

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

@@ -1,14 +0,0 @@
-module Twilio
-  module REST
-    class ServerError < StandardError; end
-
-    class RequestError < StandardError
-      attr_reader :code
-
-      def initialize(message, code=nil);
-        super message
-        @code = code
-      end
-    end
-  end
-end

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

@@ -1,17 +0,0 @@
-module Twilio
-  module REST
-    class IncomingPhoneNumbers < ListResource
-      def initialize(path, client)
-        super
-        @submodule = :NumberType
-        resource :mobile, :local, :toll_free
-      end
-
-      def buy(phone_number)
-        create phone_number: phone_number
-      end
-    end
-
-    class IncomingPhoneNumber < InstanceResource; end
-  end
-end

data/lib/twilio-ruby/rest/incoming_phone_numbers/local.rb

@@ -1,13 +0,0 @@
-module Twilio
-  module REST
-    module NumberType
-      class Local < ListResource
-        def initialize(path, client)
-          @path, @client = path, client
-          @instance_class = Twilio::REST::IncomingPhoneNumber
-          @list_key, @instance_id_key = 'incoming_phone_numbers', 'sid'
-        end
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/incoming_phone_numbers/mobile.rb

@@ -1,13 +0,0 @@
-module Twilio
-  module REST
-    module NumberType
-      class Mobile < ListResource
-        def initialize(path, client)
-          @path, @client = path, client
-          @instance_class = Twilio::REST::IncomingPhoneNumber
-          @list_key, @instance_id_key = 'incoming_phone_numbers', 'sid'
-        end
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/incoming_phone_numbers/toll_free.rb

@@ -1,13 +0,0 @@
-module Twilio
-  module REST
-    module NumberType
-      class TollFree < ListResource
-        def initialize(path, client)
-          @path, @client = path, client
-          @instance_class = Twilio::REST::IncomingPhoneNumber
-          @list_key, @instance_id_key = 'incoming_phone_numbers', 'sid'
-        end
-      end
-    end
-  end
-end

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