twilio 2.9.0 → 3.0.0

data/spec/fixtures/xml/available_phone_numbers_local_search.xml

@@ -0,0 +1,15 @@
+<TwilioResponse> 
+    <AvailablePhoneNumbers uri="/2010-04-01/Accounts/ACde6f1e11047ebd6fe7a55f120be3a900/AvailablePhoneNumbers/US/Local?Contains=510555****">
+        <AvailablePhoneNumber>
+            <FriendlyName>(510) 555-1214</FriendlyName>
+            <PhoneNumber>+15105551214</PhoneNumber>
+            <Lata>722</Lata>
+            <RateCenter>OKLD0349T</RateCenter>
+            <Latitude>37.806940</Latitude>
+            <Longitude>-122.270360</Longitude>
+            <Region>CA</Region>
+            <PostalCode>94612</PostalCode>
+            <IsoCountry>US</IsoCountry>
+        </AvailablePhoneNumber>
+    </AvailablePhoneNumbers>
+</TwilioResponse>

data/spec/fixtures/xml/available_phone_numbers_toll_free.xml

@@ -0,0 +1,14 @@
+<TwilioResponse>
+    <AvailablePhoneNumbers uri="/2010-04-01/Accounts/ACde6f1e11047ebd6fe7a55f120be3a900/AvailablePhoneNumbers/US/TollFree">
+        <AvailablePhoneNumber>
+            <FriendlyName>(866) 583-8815</FriendlyName>
+            <PhoneNumber>+18665838815</PhoneNumber>
+            <IsoCountry>US</IsoCountry>
+        </AvailablePhoneNumber>
+        <AvailablePhoneNumber>
+            <FriendlyName>(866) 583-0795</FriendlyName>
+            <PhoneNumber>+18665830795</PhoneNumber>
+            <IsoCountry>US</IsoCountry>
+        </AvailablePhoneNumber>
+    </AvailablePhoneNumbers>
+</TwilioResponse>

data/spec/fixtures/xml/available_phone_numbers_toll_free_search.xml

@@ -0,0 +1,10 @@
+<TwilioResponse>
+    <AvailablePhoneNumbers uri="/2010-04-01/Accounts/ACde6f1e11047ebd6fe7a55f120be3a900/AvailablePhoneNumbers/US/TollFree?Contains=STORM">
+        <AvailablePhoneNumber>
+            <FriendlyName>(866) 557-8676</FriendlyName>
+            <PhoneNumber>+18665578676</PhoneNumber>
+            <IsoCountry>US</IsoCountry>
+        </AvailablePhoneNumber>
+    </AvailablePhoneNumbers>
+</TwilioResponse>
+

data/{test → spec}/fixtures/xml/conference.xml

@@ -1,6 +1,6 @@
 <TwilioResponse>
   <Conference>
-    <Sid>CFd0a50bbe038c437e87f6c82db8f37f21</Sid>
+    <Sid>CF9f2ead1ae43cdabeab102fa30d938378</Sid>
     <AccountSid>mysid</AccountSid>
     <FriendlyName>1234</FriendlyName>
     <Status>2</Status>

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+require 'bundler'
+Bundler.setup
+
+require 'twilio'
+
+require 'support/twilio_helpers'
+require 'webmock/rspec'
+
+RSpec.configure do |config|   
+  config.include TwilioHelpers
+  config.before(:suite) do
+    WebMock.disable_net_connect!
+  end
+  config.after(:suite) do
+    WebMock.allow_net_connect!
+  end
+end

data/spec/support/twilio_helpers.rb

@@ -0,0 +1,52 @@
+module TwilioHelpers #:nodoc:
+  
+  def stub_http_request(http_method, fixture_name, *opts)    
+    if opts
+      request_options = opts.pop if opts.last.is_a?(Hash)
+      resource = opts.pop
+    end
+    
+    fake_response = fixture(fixture_name)         
+    url = twilio_url(resource)
+    
+    if request_options
+      stub_request(http_method, url).with(request_options).to_return(:body => fake_response)
+    else
+      stub_request(http_method, url).to_return(:body => fake_response)
+    end
+    
+    return fake_response, url
+  end
+    
+  def stub_get(fixture, *opts)
+    stub_http_request(:get, fixture, *opts)  
+  end
+  
+  def stub_post(fixture, *opts)
+    stub_http_request(:post, fixture, *opts)
+  end
+  
+  def stub_put(fixture, *opts)
+    stub_http_request(:put, fixture, *opts)
+  end
+  
+  def stub_delete(fixture, *opts)
+    stub_http_request(:delete, fixture, *opts)
+  end
+
+  def verb_response(verb)
+    path = File.join(File.dirname(__FILE__), "../fixtures/yml/verb_responses.yml")
+    YAML.load_file(path)[verb.to_s]['response']
+  end
+      
+  private
+  
+    def twilio_url(url=nil)
+      "https://mysid:mytoken@api.twilio.com:443/2010-04-01/Accounts/mysid#{'/' + url if url}"
+    end
+
+    def fixture(filename)
+      path = File.join(File.dirname(__FILE__), "../fixtures/xml/#{filename}.xml")
+      File.read path
+    end
+end

data/spec/twilio/account_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe 'Account' do  
+  before(:all) do
+    Twilio.connect('mysid', 'mytoken')
+  end
+    
+  it "gets an account" do    
+    response, url = stub_get(:account)
+    
+    Twilio::Account.get.should == response
+    WebMock.should have_requested(:get, twilio_url)
+  end
+  
+  it "updates name" do
+    response, url = stub_put(:account_renamed)
+    
+    Twilio::Account.update_name('Bubba').should == response
+    WebMock.should have_requested(:put, twilio_url).with(:body => {:FriendlyName => 'Bubba'})
+  end
+end

data/spec/twilio/available_phone_numbers_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+describe "Available Phone Numbers" do  
+  before(:all) do
+    Twilio.connect('mysid', 'mytoken')
+  end
+    
+  context "Local Number" do
+    it "is searchable" do      
+      response, url = stub_get(:available_phone_numbers_local, 'AvailablePhoneNumbers/US/Local')
+      
+      Twilio::AvailablePhoneNumbers.search_local.should == response
+      WebMock.should have_requested(:get, url)
+    end
+    
+    it "is searchable by area code" do      
+      response, url = stub_get(:available_phone_numbers_local_search, 'AvailablePhoneNumbers/US/Local?AreaCode=510')
+      
+      Twilio::AvailablePhoneNumbers.search_local(:area_code => 510).should == response
+      WebMock.should have_requested(:get, url)
+    end
+    
+    it "is searchable by postal code" do      
+      response, url = stub_get(:available_phone_numbers_local_search, 'AvailablePhoneNumbers/US/Local?InPostalCode=94612')
+      
+      Twilio::AvailablePhoneNumbers.search_local(:postal_code => 94612).should == response
+      WebMock.should have_requested(:get, url)
+    end
+    
+    it "is searchable using multiple parameters" do      
+      response, url = stub_get(:available_phone_numbers_local_search, 'AvailablePhoneNumbers/US/Local?NearLatLong=37.806940%2C-122.270360&InRateCenter=OKLD0349T&NearNumber=15105551213&Distance=50&InRegion=CA&InLata=722&Contains=510555****')
+      
+      Twilio::AvailablePhoneNumbers.search_local(:in_region => 'CA', :contains => '510555****', :near_lat_long => '37.806940,-122.270360', :near_number => '15105551213', :in_lata => 722, :in_rate_center => 'OKLD0349T', :distance => 50).should == response
+      WebMock.should have_requested(:get, url)
+    end
+  end
+
+  context "Toll-free Number" do
+    it "is searchable" do      
+      response, url = stub_get(:available_phone_numbers_toll_free, 'AvailablePhoneNumbers/US/TollFree')
+      
+      Twilio::AvailablePhoneNumbers.search_toll_free.should == response
+      WebMock.should have_requested(:get, url)
+    end
+    
+    it "is searchable as a vanity number" do      
+      response, url = stub_get(:available_phone_numbers_toll_free_search, 'AvailablePhoneNumbers/US/TollFree?Contains=STORM')
+      
+      Twilio::AvailablePhoneNumbers.search_toll_free(:contains => 'STORM').should == response
+      WebMock.should have_requested(:get, url)
+    end
+  end
+end

data/spec/twilio/call_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+
+describe "Call" do
+  before(:all) do
+    Twilio.connect('mysid', 'mytoken')
+    @call_sid = 'CA42ed11f93dc08b952027ffbc406d0868'
+  end
+  
+  it "can be made" do
+    response, url = stub_post(:call_new, 'Calls')
+    
+    Twilio::Call.make('4158675309', '4155551212', 'http://localhost:3000/call_handler').should == response
+    WebMock.should have_requested(:post, url)
+  end
+  
+  it "can be redirected" do
+    response, url = stub_post(:call_redirected, "Calls/#{@call_sid}")
+    
+    Twilio::Call.redirect(@call_sid, 'http://localhost:3000/redirect_handler').should == response
+    WebMock.should have_requested(:post, url)
+  end
+  
+  it "gets a list of calls" do
+    response, url = stub_get(:calls, 'Calls')
+    
+    Twilio::Call.list.should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  it "gets a specific call" do
+    response, url = stub_get(:calls, "Calls/#{@call_sid}")
+    
+    Twilio::Call.get(@call_sid).should == response
+    WebMock.should have_requested(:get, url)
+  end
+    
+  it "gets a list of call segments" do
+    response, url = stub_get(:calls, "Calls/#{@call_sid}/Segments")
+    
+    Twilio::Call.segments(@call_sid).should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  it "gets a specific call segment" do
+    response, url = stub_get(:calls, "Calls/#{@call_sid}/Segments/abc123")
+    
+    Twilio::Call.segments(@call_sid, 'abc123').should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  it "gets a list of call recordings" do
+    response, url = stub_get(:recordings, "Calls/#{@call_sid}/Recordings")
+    
+    Twilio::Call.recordings(@call_sid).should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  it "gets a list of call notifications" do
+    response, url = stub_get(:notifications, "Calls/#{@call_sid}/Notifications")
+    
+    Twilio::Call.notifications(@call_sid).should == response
+    WebMock.should have_requested(:get, url)
+  end
+end

data/spec/twilio/conference_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+describe "Conference" do
+  before(:all) do
+    Twilio.connect('mysid', 'mytoken')
+    @conference_sid = 'CF9f2ead1ae43cdabeab102fa30d938378'
+    @call_sid = 'CA9ae8e040497c0598481c2031a154919e'
+  end
+  
+  it "gets a list of conferences" do
+    response, url = stub_get(:conferences, 'Conferences')
+    
+    Twilio::Conference.list.should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  it "gets a specific conference" do
+    response, url = stub_get(:conference, "Conferences/#{@conference_sid}")
+    
+    Twilio::Conference.get(@conference_sid).should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  it "gets a list of participants" do
+    response, url = stub_get(:conference_participants, "Conferences/#{@conference_sid}/Participants")
+    
+    Twilio::Conference.participants(@conference_sid).should == response
+    WebMock.should have_requested(:get, url)
+  end
+
+  it "gets a specific participant" do
+    response, url = stub_get(:conference_participant, "Conferences/#{@conference_sid}/Participants/#{@call_sid}")
+    
+    Twilio::Conference.participant(@conference_sid, @call_sid).should == response
+    WebMock.should have_requested(:get, url)
+  end
+
+  it "can mute a particant" do
+    response, url = stub_post(:conference_participant_muted, "Conferences/#{@conference_sid}/Participants/#{@call_sid}", :body => 'Muted=true')
+    
+    Twilio::Conference.mute_participant(@conference_sid, @call_sid).should == response
+    WebMock.should have_requested(:post, url)
+  end
+
+  it "can unmute a participant" do
+    response, url = stub_post(:conference_participant, "Conferences/#{@conference_sid}/Participants/#{@call_sid}", :body => 'Muted=false')
+    
+    Twilio::Conference.unmute_participant(@conference_sid, @call_sid).should == response
+    WebMock.should have_requested(:post, url)
+  end
+
+  it "can be kicked" do
+    response, url = stub_delete(:conference_participant, "Conferences/#{@conference_sid}/Participants/#{@call_sid}")
+    
+    Twilio::Conference.kick_participant(@conference_sid, @call_sid).should == response
+    WebMock.should have_requested(:delete, url)
+  end
+end

data/spec/twilio/incoming_phone_number_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe "Incoming Phone Number" do
+  before(:all) do
+    Twilio.connect('mysid', 'mytoken')
+    @incoming_sid = 'PNe536dfda7c6184afab78d980cb8cdf43'
+  end
+  
+  it "gets a specific phone number" do
+    response, url = stub_get(:incoming_phone_number, "IncomingPhoneNumbers/#{@incoming_sid}")
+    
+    Twilio::IncomingPhoneNumber.get(@incoming_sid).should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  it "gets a list of phone numbers" do
+    response, url = stub_get(:incoming_phone_numbers, 'IncomingPhoneNumbers')
+    
+    Twilio::IncomingPhoneNumber.list.should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  context "creating" do
+    it "is created" do
+      response, url = stub_post(:incoming_phone_number, 'IncomingPhoneNumbers')
+
+      Twilio::IncomingPhoneNumber.create(:PhoneNumber => '8055551212').should == response
+      WebMock.should have_requested(:post, url)
+    end
+    
+    it "raises an exception if PhoneNumber or AreaCode are not set" do
+      expect { Twilio::IncomingPhoneNumber.create(:FriendlyName => 'Booyah') }.to raise_exception
+    end
+  end
+  
+  it "is deleted" do
+    response, url = stub_delete(:incoming_phone_number, "IncomingPhoneNumbers/#{@incoming_sid}")
+    
+    Twilio::IncomingPhoneNumber.delete(@incoming_sid).should == response
+    WebMock.should have_requested(:delete, url)
+  end
+end

data/spec/twilio/live_connection_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+# uncomment and add your own tests here
+=begin  
+describe "testing with a live connection" do
+  before(:all) do
+    WebMock.allow_net_connect!
+    @sid = 'abc123'
+    @token = '123'
+    Twilio.connect(@sid, @token)
+  end
+  
+  after(:all) do
+    WebMock.disable_net_connect!
+  end
+    
+  it "gets real account" do
+    Twilio::Account.get.should include("TwilioResponse")
+  end
+end
+=end

data/spec/twilio/notification_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe "Notification" do
+  before(:all) do
+    Twilio.connect('mysid', 'mytoken')
+    @notification_sid = 'NO1fb7086ceb85caed2265f17d7bf7981c'
+  end
+
+  it "gets a list of notifications" do
+    response, url = stub_get(:notifications, 'Notifications')
+    
+    Twilio::Notification.list.should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  it "gets a specific notification" do
+    response, url = stub_get(:notification, "Notifications/#{@notification_sid}")
+      
+    Twilio::Notification.get(@notification_sid).should == response
+    WebMock.should have_requested(:get, url)
+  end
+  
+  it "is deleted" do
+    response, url = stub_delete(:notification, "Notifications/#{@notification_sid}")
+    
+    Twilio::Notification.delete(@notification_sid).should == response
+    WebMock.should have_requested(:delete, url)
+  end
+end