twilio-ruby 3.11.5 → 4.0.0

data/lib/twilio-ruby.rb

@@ -5,20 +5,28 @@ require 'multi_json'
 require 'cgi'
 require 'openssl'
 require 'base64'
+require 'forwardable'
 require 'jwt'
 
 require 'twilio-ruby/version' unless defined?(Twilio::VERSION)
 require 'twilio-ruby/util'
+require 'twilio-ruby/util/client_config'
+require 'twilio-ruby/util/configuration'
 require 'twilio-ruby/util/request_validator'
 require 'twilio-ruby/util/capability'
 require 'twilio-ruby/twiml/response'
+require 'twilio-ruby/task_router'
+require 'twilio-ruby/task_router/capability'
 require 'twilio-ruby/rest/errors'
 require 'twilio-ruby/rest/utils'
 require 'twilio-ruby/rest/list_resource'
+require 'twilio-ruby/rest/next_gen_list_resource'
 require 'twilio-ruby/rest/instance_resource'
 require 'twilio-ruby/rest/sandbox'
 require 'twilio-ruby/rest/accounts'
 require 'twilio-ruby/rest/calls'
+require 'twilio-ruby/rest/call_feedback'
+require 'twilio-ruby/rest/call_feedback_summary'
 require 'twilio-ruby/rest/sms'
 require 'twilio-ruby/rest/sms/short_codes'
 require 'twilio-ruby/rest/sms/messages'
@@ -30,6 +38,20 @@ require 'twilio-ruby/rest/sip/credential_lists'
 require 'twilio-ruby/rest/sip/credential_lists/credentials'
 require 'twilio-ruby/rest/sip/ip_access_control_lists'
 require 'twilio-ruby/rest/sip/ip_access_control_lists/ip_addresses'
+require 'twilio-ruby/rest/task_router/statistics'
+require 'twilio-ruby/rest/task_router/activities'
+require 'twilio-ruby/rest/task_router/events'
+require 'twilio-ruby/rest/task_router/reservations'
+require 'twilio-ruby/rest/task_router/task_queues'
+require 'twilio-ruby/rest/task_router/task_queues_statistics'
+require 'twilio-ruby/rest/task_router/tasks'
+require 'twilio-ruby/rest/task_router/workers'
+require 'twilio-ruby/rest/task_router/workers_statistics'
+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'
@@ -54,5 +76,31 @@ require 'twilio-ruby/rest/usage/records'
 require 'twilio-ruby/rest/usage/triggers'
 require 'twilio-ruby/rest/recordings'
 require 'twilio-ruby/rest/transcriptions'
+require 'twilio-ruby/rest/tokens'
 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
+  extend SingleForwardable
+
+  def_delegators :configuration, :account_sid, :auth_token
+
+  ##
+  # Pre-configure with account SID and auth token so that you don't need to
+  # pass them to various initializers each time.
+  def self.configure(&block)
+    yield configuration
+  end
+
+  ##
+  # Returns an existing or instantiates a new configuration object.
+  def self.configuration
+    @configuration ||= Util::Configuration.new
+  end
+  private_class_method :configuration
+end

data/spec/rack/twilio_webhook_authentication_spec.rb

@@ -0,0 +1,110 @@
+require 'spec_helper'
+require 'rack/mock'
+
+describe Rack::TwilioWebhookAuthentication do
+  before do
+    @app = lambda {|env| [200, {'Content-Type' => 'text/plain'}, ['Hello']] }
+  end
+
+  describe 'new' do
+    it 'should initialize with an app, auth token and a path' do
+      expect {
+        Rack::TwilioWebhookAuthentication.new(@app, 'ABC', /\/voice/)
+      }.not_to raise_error
+    end
+
+    it 'should initialize with an app, auth token and paths' do
+      expect {
+        Rack::TwilioWebhookAuthentication.new(@app, 'ABC', /\/voice/, /\/sms/)
+      }.not_to raise_error
+    end
+
+    it 'should initialize with an app, dynamic token and paths' do
+      expect {
+        Rack::TwilioWebhookAuthentication.new(@app, nil, /\/voice/, /\/sms/)
+      }.not_to raise_error
+    end
+  end
+
+  describe 'calling against one path with dynamic auth token' do
+    it 'should allow a request through if it validates' do
+      auth_token = 'qwerty'
+      account_sid = 12345
+      expect_any_instance_of(Rack::Request).to receive(:post?).and_return(true)
+      expect_any_instance_of(Rack::Request).to receive(:POST).and_return({'AccountSid' => account_sid})
+      @middleware = Rack::TwilioWebhookAuthentication.new(@app, nil, /\/voice/) { |asid| auth_token}
+      request_validator = double('RequestValidator')
+      expect(Twilio::Util::RequestValidator).to receive(:new).with(auth_token).and_return(request_validator)
+      expect(request_validator).to receive(:validate).and_return(true)
+      request = Rack::MockRequest.env_for('/voice')
+      status, headers, body = @middleware.call(request)
+      expect(status).to be(200)
+    end
+  end
+
+  describe 'calling against one path' do
+    before do
+      @middleware = Rack::TwilioWebhookAuthentication.new(
+        @app, 'ABC', /\/voice/
+      )
+    end
+
+    it 'should not intercept when the path doesn\'t match' do
+      expect(Twilio::Util::RequestValidator).to_not receive(:validate)
+      request = Rack::MockRequest.env_for('/sms')
+      status, headers, body = @middleware.call(request)
+      expect(status).to be(200)
+    end
+
+    it 'should allow a request through if it validates' do
+      expect_any_instance_of(Twilio::Util::RequestValidator).to(
+        receive(:validate).and_return(true)
+      )
+      request = Rack::MockRequest.env_for('/voice')
+      status, headers, body = @middleware.call(request)
+      expect(status).to be(200)
+    end
+
+    it 'should short circuit a request to 403 if it does not validate' do
+      expect_any_instance_of(Twilio::Util::RequestValidator).to(
+        receive(:validate).and_return(false)
+      )
+      request = Rack::MockRequest.env_for('/voice')
+      status, headers, body = @middleware.call(request)
+      expect(status).to be(403)
+    end
+  end
+
+  describe 'calling against many paths' do
+    before do
+      @middleware = Rack::TwilioWebhookAuthentication.new(
+        @app, 'ABC', /\/voice/, /\/sms/
+      )
+    end
+
+    it 'should not intercept when the path doesn\'t match' do
+      expect(Twilio::Util::RequestValidator).to_not receive(:validate)
+      request = Rack::MockRequest.env_for('icesms')
+      status, headers, body = @middleware.call(request)
+      expect(status).to be(200)
+    end
+
+    it 'shold allow a request through if it validates' do
+      expect_any_instance_of(Twilio::Util::RequestValidator).to(
+        receive(:validate).and_return(true)
+      )
+      request = Rack::MockRequest.env_for('/sms')
+      status, headers, body = @middleware.call(request)
+      expect(status).to be(200)
+    end
+
+    it 'should short circuit a request to 403 if it does not validate' do
+      expect_any_instance_of(Twilio::Util::RequestValidator).to(
+        receive(:validate).and_return(false)
+      )
+      request = Rack::MockRequest.env_for('/sms')
+      status, headers, body = @middleware.call(request)
+      expect(status).to be(403)
+    end
+  end
+end

data/spec/rest/account_spec.rb

@@ -7,52 +7,83 @@ describe Twilio::REST::Account do
   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'
+    expect(@account).to respond_to(:incoming_phone_numbers)
+    expect(@account.incoming_phone_numbers.instance_variable_get('@path')).to(
+      eq('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'
+    expect(@account).to respond_to(:available_phone_numbers)
+    expect(@account.available_phone_numbers.instance_variable_get('@path')).to(
+      eq('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'
+    expect(@account).to respond_to(:outgoing_caller_ids)
+    expect(@account.outgoing_caller_ids.instance_variable_get('@path')).to eq(
+      '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'
+    expect(@account).to respond_to(:calls)
+    expect(@account.calls.instance_variable_get('@path')).to eq('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'
+    expect(@account).to respond_to(:conferences)
+    expect(@account.conferences.instance_variable_get('@path')).to eq(
+      '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'
+    expect(@account).to respond_to(:queues)
+    expect(@account.queues.instance_variable_get('@path')).to eq(
+      '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'
+    expect(@account).to respond_to(:sms)
+    expect(@account.sms.instance_variable_get('@path')).to eq('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'
+    expect(@account).to respond_to(:recordings)
+    expect(@account.recordings.instance_variable_get('@path')).to eq(
+      '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'
+    expect(@account).to respond_to(:transcriptions)
+    expect(@account.transcriptions.instance_variable_get('@path')).to eq(
+      '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'
+    expect(@account).to respond_to(:notifications)
+    expect(@account.notifications.instance_variable_get('@path')).to eq(
+      'someUri/Notifications'
+    )
   end
+
+  it 'sets up a tokens resources object' do
+    expect(@account).to respond_to(:tokens)
+    expect(@account.tokens.instance_variable_get('@path')).to eq(
+      'someUri/Tokens'
+    )
+  end
+
+  it 'sets up an addresses resources object' do
+    expect(@account).to respond_to(:addresses)
+    expect(@account.addresses.instance_variable_get('@path')).to eq(
+      'someUri/Addresses'
+    )
+  end
+
 end

data/spec/rest/address_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe Twilio::REST::Address do
+  it 'should set up a dependent phone numbers resources object' do
+    address = Twilio::REST::Address.new('someUri', 'someClient')
+    expect(address).to respond_to(:dependent_phone_numbers)
+    expect(address.dependent_phone_numbers.instance_variable_get('@path')).to eq(
+      'someUri/DependentPhoneNumbers'
+    )
+  end
+end

data/spec/rest/call_feedback_spec.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+
+describe Twilio::REST::Feedback do
+  before do
+    @call = Twilio::REST::Call.new('someUri', 'someClient')
+  end
+
+  it 'sets up a feedback resources object' do
+    expect(@call).to respond_to(:feedback)
+    expect(@call.feedback.instance_variable_get('@path')).to eq('someUri/Feedback')
+  end
+end

data/spec/rest/call_feedback_summary_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe Twilio::REST::FeedbackSummary do
+  it 'creates a feedback summary object' do
+    calls = Twilio::REST::Calls.new('someUri', 'someClient')
+    expect(calls).to respond_to(:feedback_summary)
+    expect(calls.feedback_summary.instance_variable_get('@path')).to eq('someUri/FeedbackSummary')
+  end
+end

data/spec/rest/call_spec.rb

@@ -7,12 +7,16 @@ describe Twilio::REST::Call do
   end
 
   it 'sets up a recordings resources object' do
-    @call.should respond_to(:recordings)
-    @call.recordings.instance_variable_get('@path').should == 'someUri/Recordings'
+    expect(@call).to respond_to(:recordings)
+    expect(@call.recordings.instance_variable_get('@path')).to eq(
+      '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'
+    expect(@call).to respond_to(:notifications)
+    expect(@call.notifications.instance_variable_get('@path')).to eq(
+      'someUri/Notifications'
+    )
   end
 end