twilio-ruby 3.11.5 → 5.0.0

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

@@ -1,25 +0,0 @@
-module Twilio
-  module REST
-    module Utils
-
-      def twilify(something)
-        if something.is_a? Hash
-          Hash[*something.to_a.map! {|a| [twilify(a[0]).to_sym, a[1]]}.flatten(1)]
-        else
-          something.to_s.split('_').map! do |s|
-            [s[0,1].capitalize, s[1..-1]].join
-          end.join
-        end
-      end
-
-      def detwilify(something)
-        if something.is_a? Hash
-          Hash[*something.to_a.map! {|pair| [detwilify(pair[0]).to_sym, pair[1]]}.flatten]
-        else
-          something.to_s.gsub(/[A-Z][a-z]*/) {|s| "_#{s.downcase}"}.gsub(/^_/, '')
-        end
-      end
-
-    end
-  end
-end

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

@@ -1,15 +0,0 @@
-module Twilio
-  module TwiML
-    class Response
-
-      attr_reader :text
-
-      def initialize(&block)
-        xml = Builder::XmlMarkup.new
-        xml.instruct!
-        @text = xml.Response &block
-      end
-
-    end
-  end
-end

data/lib/twilio-ruby/util/capability.rb

@@ -1,61 +0,0 @@
-module Twilio
-  module Util
-    class Capability
-
-      include Twilio::Util
-
-      def initialize(account_sid, auth_token)
-        @account_sid = account_sid
-        @auth_token = auth_token
-        @capabilities = []
-      end
-
-      def allow_client_incoming(client_name)
-        @client_name = client_name # stash for use in outgoing
-        scope_params = {'clientName' => client_name}
-        @capabilities << scope_uri_for('client', 'incoming', scope_params)
-      end
-
-      def allow_client_outgoing(app_sid, params = {})
-        @allow_client_outgoing = true
-        @outgoing_scope_params = {'appSid' => app_sid}
-        unless params.empty?
-          @outgoing_scope_params['appParams'] = url_encode params
-        end
-      end
-
-      def allow_event_stream(filters = {})
-        scope_params = {'path' => '/2010-04-01/Events'}
-        scope_params['params'] = filters unless filters.empty?
-        @capabilities << scope_uri_for('stream', 'subscribe', scope_params)
-      end
-
-      def scope_uri_for(service, privilege, params = {})
-        scope_uri = "scope:#{service}:#{privilege}"
-        scope_uri << "?#{url_encode(params)}" unless params.empty?
-      end
-
-      def generate(ttl = 3600)
-
-        capabilities = @capabilities.clone # we need a local copy to work on
-
-        # build the outgoing scope lazily so that we can use @client_name
-        if @allow_client_outgoing
-          params = @outgoing_scope_params
-          params.merge!({'clientName' => @client_name}) if @client_name
-          capabilities << scope_uri_for('client', 'outgoing', params)
-        end
-
-        payload = {
-          'scope' => capabilities.join(' '),
-          'iss' => @account_sid,
-          'exp' => (Time.now.to_i + ttl),
-        }
-
-        JWT.encode payload, @auth_token
-
-      end
-
-    end
-  end
-end

data/lib/twilio-ruby/util/request_validator.rb

@@ -1,22 +0,0 @@
-module Twilio
-  module Util
-    class RequestValidator
-
-      def initialize(auth_token)
-        @auth_token = auth_token
-      end
-
-      def validate(url, params, signature)
-        expected = build_signature_for url, params
-        expected == signature
-      end
-
-      def build_signature_for(url, params)
-        data = url + params.sort.join
-        digest = OpenSSL::Digest.new('sha1')
-        Base64.encode64(OpenSSL::HMAC.digest(digest, @auth_token, data)).strip
-      end
-
-    end
-  end
-end

data/spec/rest/account_spec.rb

@@ -1,58 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::REST::Account do
-
-  before do
-    @account = Twilio::REST::Account.new('someUri', 'someClient')
-  end
-
-  it 'sets up incoming phone numbers resources object' do
-    @account.should respond_to(:incoming_phone_numbers)
-    @account.incoming_phone_numbers.instance_variable_get('@path').should == 'someUri/IncomingPhoneNumbers'
-  end
-
-  it 'sets up an available phone numbers resources object' do
-    @account.should respond_to(:available_phone_numbers)
-    @account.available_phone_numbers.instance_variable_get('@path').should == 'someUri/AvailablePhoneNumbers'
-  end
-
-  it 'sets up an outgoing caller ids resources object' do
-    @account.should respond_to(:outgoing_caller_ids)
-    @account.outgoing_caller_ids.instance_variable_get('@path').should == 'someUri/OutgoingCallerIds'
-  end
-
-  it 'sets up a calls resources object' do
-    @account.should respond_to(:calls)
-    @account.calls.instance_variable_get('@path').should == 'someUri/Calls'
-  end
-
-  it 'sets up a conferences resources object' do
-    @account.should respond_to(:conferences)
-    @account.conferences.instance_variable_get('@path').should == 'someUri/Conferences'
-  end
-
-  it 'sets up a queues resources object' do
-    @account.should respond_to(:queues)
-    @account.queues.instance_variable_get('@path').should == 'someUri/Queues'
-  end
-
-  it 'sets up a sms resource object' do
-    @account.should respond_to(:sms)
-    @account.sms.instance_variable_get('@path').should == 'someUri/SMS'
-  end
-
-  it 'sets up a recordings resources object' do
-    @account.should respond_to(:recordings)
-    @account.recordings.instance_variable_get('@path').should == 'someUri/Recordings'
-  end
-
-  it 'sets up a transcriptions resources object' do
-    @account.should respond_to(:transcriptions)
-    @account.transcriptions.instance_variable_get('@path').should == 'someUri/Transcriptions'
-  end
-
-  it 'sets up a notifications resources object' do
-    @account.should respond_to(:notifications)
-    @account.notifications.instance_variable_get('@path').should == 'someUri/Notifications'
-  end
-end

data/spec/rest/call_spec.rb

@@ -1,18 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::REST::Call do
-
-  before do
-    @call = Twilio::REST::Call.new('someUri', 'someClient')
-  end
-
-  it 'sets up a recordings resources object' do
-    @call.should respond_to(:recordings)
-    @call.recordings.instance_variable_get('@path').should == 'someUri/Recordings'
-  end
-
-  it 'sets up a notifications resources object' do
-    @call.should respond_to(:notifications)
-    @call.notifications.instance_variable_get('@path').should == 'someUri/Notifications'
-  end
-end

data/spec/rest/client_spec.rb

@@ -1,100 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::REST::Client do
-  it 'should not raise an error if the response body is empty' do
-    FakeWeb.register_uri(:any, %r/api\.twilio\.com/, :body => '')
-    twilio = Twilio::REST::Client.new('someSid', 'someToken')
-    Twilio::REST::IncomingPhoneNumber.new('/phone_number', twilio).delete
-  end
-
-  it 'should not raise an error if the response body is nil' do
-    response = double(:response, :body => nil)
-    connection = double(:connection, :request => response)
-    twilio = Twilio::REST::Client.new('someSid', 'someToken')
-    twilio.instance_variable_set(:@connection, connection)
-    Twilio::REST::IncomingPhoneNumber.new('/phone_number', twilio).delete
-  end
-
-  it 'should set up a new client instance with the given sid and token' do
-    twilio = Twilio::REST::Client.new('someSid', 'someToken')
-    twilio.account_sid.should == 'someSid'
-    twilio.instance_variable_get('@auth_token').should == 'someToken'
-  end
-  
-  it 'should set up the proper default http ssl connection' do
-    twilio = Twilio::REST::Client.new('someSid', 'someToken')
-    connection = twilio.instance_variable_get('@connection')
-    connection.address.should == 'api.twilio.com'
-    connection.port.should == 443
-    connection.use_ssl?.should == true
-  end
-  
-  it 'should set up the requested ssl verification ca_file if provided' do
-    twilio = Twilio::REST::Client.new('someSid', 'someToken', :ssl_ca_file => '/path/to/ca/file')
-    connection = twilio.instance_variable_get('@connection')
-    connection.ca_file.should == '/path/to/ca/file'
-  end
-
-  it 'should set up the proper http ssl connection when a different domain is given' do
-    twilio = Twilio::REST::Client.new('someSid', 'someToken', :host => 'api.faketwilio.com')
-    connection = twilio.instance_variable_get('@connection')
-    connection.address.should == 'api.faketwilio.com'
-    connection.port.should == 443
-    connection.use_ssl?.should == true
-  end
-
-  it 'should adjust the open and read timeouts on the underlying Net::HTTP object when asked' do
-    timeout = rand(30)
-    twilio = Twilio::REST::Client.new('someSid', 'someToken', :timeout => timeout)
-    connection = twilio.instance_variable_get('@connection')
-    connection.port.should == 443
-    connection.use_ssl?.should == true
-    connection.open_timeout.should == timeout
-    connection.read_timeout.should == timeout
-  end
-
-  it 'should set up the proper http ssl connection when a proxy_host is given' do
-    twilio = Twilio::REST::Client.new('someSid', 'someToken', :host => 'api.faketwilio.com', :proxy_addr => 'localhost')
-    connection = twilio.instance_variable_get('@connection')
-    connection.proxy?.should == true
-    connection.proxy_address.should == 'localhost'
-    connection.proxy_port.should == 80
-    connection.address.should == 'api.faketwilio.com'
-    connection.port.should == 443
-    connection.use_ssl?.should == true
-  end
-
-  it 'should set up the proper http ssl connection when a proxy_host and proxy_port are given' do
-    twilio = Twilio::REST::Client.new('someSid', 'someToken', :host => 'api.faketwilio.com', :proxy_addr => 'localhost', :proxy_port => 13128)
-    connection = twilio.instance_variable_get('@connection')
-    connection.proxy?.should == true
-    connection.proxy_address.should == 'localhost'
-    connection.proxy_port.should == 13128
-    connection.address.should == 'api.faketwilio.com'
-    connection.port.should == 443
-    connection.use_ssl?.should == true
-  end
-
-  it 'should set up an accounts resources object' do
-    twilio = Twilio::REST::Client.new('someSid', 'someToken')
-    twilio.should respond_to(:accounts)
-    twilio.accounts.instance_variable_get('@path').should == '/2010-04-01/Accounts'
-  end
-
-  it 'should set up an account object with the given sid' do
-    twilio = Twilio::REST::Client.new('someSid', 'someToken')
-    twilio.should respond_to(:account)
-    twilio.account.instance_variable_get('@path').should == '/2010-04-01/Accounts/someSid'
-  end
-
-  it 'should convert all parameter names to Twilio-style names' do
-    twilio = Twilio::REST::Client.new('someSid', 'someToken')
-    untwilified = {:sms_url => 'someUrl', 'voiceFallbackUrl' => 'anotherUrl',
-      'Status_callback' => 'yetAnotherUrl'}
-    twilified = {:SmsUrl => 'someUrl', :VoiceFallbackUrl => 'anotherUrl',
-      :StatusCallback => 'yetAnotherUrl'}
-    twilio.instance_eval do
-      twilify(untwilified).should == twilified
-    end
-  end
-end

data/spec/rest/conference_spec.rb

@@ -1,9 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::REST::Conference do
-  it 'should set up a participants resources object' do
-    conference = Twilio::REST::Conference.new('someUri', 'someClient')
-    conference.should respond_to(:participants)
-    conference.participants.instance_variable_get('@path').should == 'someUri/Participants'
-  end
-end

data/spec/rest/instance_resource_spec.rb

@@ -1,15 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::REST::InstanceResource do
-  it 'should set up an internal reference to the uri and client' do
-    resource = Twilio::REST::InstanceResource.new('some/uri', 'someClient')
-    resource.instance_variable_get('@path').should == 'some/uri'
-    resource.instance_variable_get('@client').should == 'someClient'
-  end
-
-  it 'should set up object properties if passed' do
-    params = {'SomeKey' => 'someValue'}
-    resource = Twilio::REST::InstanceResource.new('uri', 'client', params)
-    resource.some_key.should == 'someValue'
-  end
-end

data/spec/rest/message_spec.rb

@@ -1,12 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::REST::Message do
-  before do
-    @message = Twilio::REST::Message.new('someUri', 'someClient')
-  end
-
-  it 'sets up a media resources object' do
-    @message.should respond_to(:media)
-    @message.media.instance_variable_get('@path').should == 'someUri/Media'
-  end
-end

data/spec/rest/numbers_spec.rb

@@ -1,46 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::REST::Country do
-
-  before do
-    @country = Twilio::REST::Country.new('someUri', 'someClient')
-  end
-
-  it 'sets up a local resources object' do
-    @country.should respond_to(:local)
-    @country.local.instance_variable_get('@path').should == 'someUri/Local'
-  end
-
-  it 'sets up a toll_free resources object' do
-    @country.should respond_to(:toll_free)
-    @country.toll_free.instance_variable_get('@path').should == 'someUri/TollFree'
-  end
-
-  it 'sets up a mobile resources object' do
-    @country.should respond_to(:mobile)
-    @country.mobile.instance_variable_get('@path').should == 'someUri/Mobile'
-  end
-
-end
-
-describe Twilio::REST::NumberType do
-
-  before do
-    @incoming_phone_numbers = Twilio::REST::IncomingPhoneNumbers.new('someUri', 'someClient')
-  end
-
-  it 'sets up a local resources object' do
-    @incoming_phone_numbers.should respond_to(:local)
-    @incoming_phone_numbers.local.instance_variable_get('@path').should == 'someUri/Local'
-  end
-
-  it 'sets up a toll_free resources object' do
-    @incoming_phone_numbers.should respond_to(:toll_free)
-    @incoming_phone_numbers.toll_free.instance_variable_get('@path').should == 'someUri/TollFree'
-  end
-
-  it 'sets up a mobile resources object' do
-    @incoming_phone_numbers.should respond_to(:mobile)
-    @incoming_phone_numbers.mobile.instance_variable_get('@path').should == 'someUri/Mobile'
-  end
-end

data/spec/rest/queue_spec.rb

@@ -1,9 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::REST::Queue do
-  it 'should set up a members resources object' do
-    queue = Twilio::REST::Queue.new('someUri', 'someClient')
-    queue.should respond_to(:members)
-    queue.members.instance_variable_get('@path').should == 'someUri/Members'
-  end
-end

data/spec/rest/recording_spec.rb

@@ -1,9 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::REST::Recording do
-  it 'should set up a transcriptions resources object' do
-    call = Twilio::REST::Recording.new('someUri', 'someClient')
-    call.should respond_to(:transcriptions)
-    call.transcriptions.instance_variable_get('@path').should == 'someUri/Transcriptions'
-  end
-end

data/spec/util/capability_spec.rb

@@ -1,137 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::Util::Capability do
-  before :each do
-    @capability = Twilio::Util::Capability.new 'myAccountSid', 'myAuthToken'
-  end
-
-  def queries(q)
-    q.scan(/scope:client:(incoming|outgoing)\?(\S+)/).map{|(type, query)| [type, Rack::Utils.parse_query(query)]}
-  end
-
-  it 'should return a valid jwt when #generate is called' do
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    decoded['scope'].should_not be_nil
-    decoded['iss'].should_not be_nil
-    decoded['exp'].should_not be_nil
-  end
-
-  it 'should properly set the iss key in the payload' do
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    decoded['iss'].should == 'myAccountSid'
-  end
-
-  it 'should properly set the exp key based on the default hour ttl' do
-    seconds = Time.now.to_i
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    decoded['exp'].should == seconds + 3600
-  end
-
-  it 'should properly set the exp key based on the ttl passed to #generate' do
-    ttl = rand 10000
-    seconds = Time.now.to_i
-    token = @capability.generate ttl
-    decoded = JWT.decode token, 'myAuthToken'
-    decoded['exp'].should == seconds + ttl
-  end
-
-  it 'should generate a proper incoming client scope string' do
-    @capability.allow_client_incoming 'andrew'
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    queries(decoded['scope']).should == [['incoming', {'clientName' => 'andrew'}]]
-  end
-
-  it 'should generate multiple proper incoming client scope strings' do
-    @capability.allow_client_incoming 'andrew'
-    @capability.allow_client_incoming 'bridget'
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    queries(decoded['scope']).should == [
-      ['incoming', {'clientName' => 'andrew'}],
-      ['incoming', {'clientName' => 'bridget'}]
-    ]
-  end
-
-  it 'should generate a proper outgoing client scope string' do
-    @capability.allow_client_outgoing 'myAppSid'
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    queries(decoded['scope']).should == [['outgoing', {'appSid' => 'myAppSid'}]]
-  end
-
-  it 'should generate a proper outgoing client scope string with parameters' do
-    app_params_hash = {'key' => 'a value', :foo => 'bar/baz'}
-    @capability.allow_client_outgoing 'myAppSid', app_params_hash
-    app_params = @capability.instance_eval {url_encode(app_params_hash)}
-    params_hash = {'appSid' => 'myAppSid', 'appParams' => app_params}
-    @capability.instance_eval {url_encode(params_hash)}
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    queries(decoded['scope']).should == [['outgoing', params_hash]]
-  end
-
-  it 'should generate a proper outgoing client scope string based on the ' +
-       'client name when calling #allow_client_incoming first' do
-    @capability.allow_client_incoming 'andrew'
-    @capability.allow_client_outgoing 'myAppSid'
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    queries(decoded['scope']).should == [
-      ['incoming', {'clientName' => 'andrew'}],
-      ['outgoing', {'clientName' => 'andrew', 'appSid' => 'myAppSid'}]
-    ]
-  end
-
-  it 'should generate a proper outgoing client scope string based on the ' +
-       'client name when calling #allow_client_incoming second' do
-    @capability.allow_client_outgoing 'myAppSid'
-    @capability.allow_client_incoming 'andrew'
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    queries(decoded['scope']).should == [["incoming", {"clientName"=>"andrew"}], ["outgoing", {"clientName"=>"andrew", "appSid"=>"myAppSid"}]]
-  end
-
-  it 'should generate a proper outgoing client scope string with parameters ' +
-       'and a client name when calling #allow_client_incoming first' do
-    @capability.allow_client_incoming 'andrew'
-    app_params_hash = {'key' => 'a value', :foo => 'bar/baz'}
-    @capability.allow_client_outgoing 'myAppSid', app_params_hash
-    app_params = @capability.instance_eval {url_encode(app_params_hash)}
-    params_hash = {'appSid' => 'myAppSid', 'appParams' => app_params, 'clientName' => 'andrew'}
-    @capability.instance_eval {url_encode(params_hash)}
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    scopes = queries(decoded['scope'])
-    scopes.shift.should == ["incoming", {"clientName"=>"andrew"}]
-    scope = scopes.shift
-    scope.first.should == 'outgoing'
-    Rack::Utils.parse_query(scope.last['appParams']).should == {'key' => 'a value', 'foo' => 'bar/baz'}
-    scope.last["clientName"].should == "andrew"
-    scope.last["appSid"].should == "myAppSid"
-    scopes.should be_empty
-  end
-
-  it 'should generate a proper outgoing client scope string with parameters ' +
-       'and a client name when calling #allow_client_incoming second' do
-    app_params_hash = {'key' => 'a value', :foo => 'bar/baz'}
-    @capability.allow_client_outgoing 'myAppSid', app_params_hash
-    @capability.allow_client_incoming 'andrew'
-    app_params = @capability.instance_eval {url_encode(app_params_hash)}
-    params_hash = {'appSid' => 'myAppSid', 'appParams' => app_params, 'clientName' => 'andrew'}
-    @capability.instance_eval {url_encode(params_hash)}
-    token = @capability.generate
-    decoded = JWT.decode token, 'myAuthToken'
-    scopes = queries(decoded['scope'])
-    scopes.shift.should == ["incoming", {"clientName"=>"andrew"}]
-    scope = scopes.shift
-    scope.first.should == 'outgoing'
-    Rack::Utils.parse_query(scope.last['appParams']).should == {'key' => 'a value', 'foo' => 'bar/baz'}
-    scope.last["clientName"].should == "andrew"
-    scope.last["appSid"].should == "myAppSid"
-    scopes.should be_empty
-  end
-end

data/spec/util/request_validator_spec.rb

@@ -1,65 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::Util::RequestValidator do
-  it 'should properly validate a Twilio Voice request' do
-    token = '2bd9e9638872de601313dc77410d3b23'
-    validator = Twilio::Util::RequestValidator.new token
-    url = 'http://twiliotests.heroku.com/validate/voice'
-    params = {
-      'ToState' => 'California',
-      'CalledState' => 'California',
-      'Direction' => 'inbound',
-      'FromState' => 'CA',
-      'AccountSid' => 'ACba8bc05eacf94afdae398e642c9cc32d',
-      'Caller' => '+14153595711',
-      'CallerZip' => '94108',
-      'CallerCountry' => 'US',
-      'From' => '+14153595711',
-      'FromCity' => 'SAN FRANCISCO',
-      'CallerCity' => 'SAN FRANCISCO',
-      'To' => '+14157669926',
-      'FromZip' => '94108',
-      'FromCountry' => 'US',
-      'ToCity' => '',
-      'CallStatus' => 'ringing',
-      'CalledCity' => '',
-      'CallerState' => 'CA',
-      'CalledZip' => '',
-      'ToZip' => '',
-      'ToCountry' => 'US',
-      'CallSid' => 'CA136d09cd59a3c0ec8dbff44da5c03f31',
-      'CalledCountry' => 'US',
-      'Called' => '+14157669926',
-      'ApiVersion' => '2010-04-01',
-      'ApplicationSid' => 'AP44efecad51364e80b133bb7c07eb8204'
-    }
-    signature = 'oVb2kXoVy8GEfwBDjR8bk/ZZ6eA='
-    validator.validate(url, params, signature).should == true
-  end
-
-  it 'should properly validate a Twilio SMS request' do
-    token = '2bd9e9638872de601313dc77410d3b23'
-    validator = Twilio::Util::RequestValidator.new token
-    url = 'http://twiliotests.heroku.com/validate/sms'
-    params = {
-      'ToState' => 'CA',
-      'FromState' => 'CA',
-      'AccountSid' => 'ACba8bc05eacf94afdae398e642c9cc32d',
-      'SmsMessageSid' => 'SM2003cbd5e6a3701999aa3e5f20ff2787',
-      'Body' => 'Orly',
-      'From' => '+14159354345',
-      'FromCity' => 'SAN FRANCISCO',
-      'SmsStatus' => 'received',
-      'FromZip' => '94107',
-      'FromCountry' => 'US',
-      'To' => '+14158141819',
-      'ToCity' => 'SAN FRANCISCO',
-      'ToZip' => '94105',
-      'ToCountry' => 'US',
-      'ApiVersion' => '2010-04-01',
-      'SmsSid' => 'SM2003cbd5e6a3701999aa3e5f20ff2787'
-    }
-    signature = 'mxeiv65lEe0b8L6LdVw2jgJi8yw='
-    validator.validate(url, params, signature).should == true
-  end
-end