twilio_resource 0.1.0

data/README.md

@@ -0,0 +1,78 @@
+Description
+-----------
+
+TwilioResource is a wrapper around the [Twilio API](http://www.twilio.com/docs/api/2008-08-01/rest/)
+using Rails' ActiveResource. This allows you to treat Twilio objects
+as if they're local ActiveRecord models:
+
+    phone = TwilioResource::LocalIncomingPhoneNumber.new(:url => 'http://www.example.com',
+                                                         :area_code => '206',
+                                                         :method => 'GET',
+                                                         :friendly_name =g> "My First Phone Number",
+                                                         :account_id => Twilio::Base.user)
+    phone.save
+
+
+The wrapper doesn't support the entire Twilio API, but it should be
+simple enough to add new functionality as needed by following the 
+models that are already built.
+
+Supported Functionality
+=======================
+- Requesting, listing, and deleting new local and toll-free numbers
+- Placing and listing calls made to a phone number
+
+Todo
+----
+- Conference resource
+- Redirecting calls
+- Support data returned in xml attributes
+- SMS resource
+- Recordings, Transcriptions, and Notifications
+- Wrap more exceptions
+- Add documentation on supported attributes to the ActiveResource models
+
+Setup
+=====
+
+Before you start using TwilioResource, you have to give it your Twilio
+login credentials. You can do this in your Rails initializer:
+
+    require 'twilio_resource'
+    TwilioResource.setup('token', 'sid')
+
+Examples
+========
+
+Requesting a new phone number:
+
+    phone = TwilioResource::LocalIncomingPhoneNumber.new(:url => 'http://www.example.com',
+                                                         :area_code => '206',
+                                                         :method => 'GET',
+                                                         :friendly_name => "My First Phone Number",
+                                                         :account_id => Twilio::Base.user)
+    phone.save
+
+Requesting a new toll-free phone number:
+
+    phone = TwilioResource::TollFreeIncomingPhoneNumber.new(:url => 'http://www.example.com',
+                                                            :area_code => '206',
+                                                            :method => 'GET',
+                                                            :friendly_name => "My First Phone Number",
+                                                            :account_id => Twilio::Base.user)
+    phone.save
+
+Retrieving a list of completed calls to a given phone number:
+
+    TwilioResource::Call.find(:all, :params => {
+      :account_id => Twilio::Base.user, 
+      :status => Twilio::Call::COMPLETE,
+      :called => '2065551212'})
+
+Placing a call:
+
+    TwilioResource::Call.new({
+      :account_id => Twilio::Base.user, 
+      :caller => '2065551111',
+      :called => '2065551212',
+      :url => 'http://example.com/call.xml'})

data/lib/twilio_resource.rb

@@ -0,0 +1,27 @@
+require 'logger'
+require 'activeresource'
+
+require 'twilio_resource/twilio_format'
+require 'twilio_resource/exceptions'
+
+module TwilioResource
+  
+  class << self
+    attr_accessor :logger
+  end
+
+  # Sets up the credentials the ActiveResources will use to access the
+  # twilio API. Optionally takes a +logger+, which defaults to +STDOUT+.
+  def self.setup(sid, token, logger = nil)
+    @logger = logger || Logger.new(STDOUT) 
+    TwilioResource::Base.sid = sid
+    TwilioResource::Base.token = token
+  end
+end
+
+require 'twilio_resource/base'
+require 'twilio_resource/account'
+require 'twilio_resource/call'
+require 'twilio_resource/incoming_phone_number'
+require 'twilio_resource/local_incoming_phone_number'
+require 'twilio_resource/toll_free_incoming_phone_number'

data/lib/twilio_resource/account.rb

@@ -0,0 +1,6 @@
+
+# Encapsulates a Twilio account. Not much to do here.  Documentation
+# can be found at
+# http://www.twilio.com/docs/api/2008-08-01/rest/account
+class TwilioResource::Account < TwilioResource::Base
+end

data/lib/twilio_resource/base.rb

@@ -0,0 +1,83 @@
+# Encapsulates the changes that need to be made to active_resource's
+# defaults in order to communicate with Twilio. There are a few main
+# issues with ActiveResource's defaults:
+#
+# 1. Twilio's urls don't take an extension. ActiveResource requires
+#    endpoints to have an extension corresponding to the type of data,
+#    for example: +resource.xml+ or +resource.json+. Twilio's are
+#    always xml, but have no extension.
+# 
+# 2. Twilio uses capitalized names in their URLs. For instance,
+#    instead of '/account/1/calls/1', they use '/Account/1/Calls/1'.
+# 
+# 3. Twilio takes form encoded params, like token=blah&sid=foo, but
+#    returns data in XML. These changes are encapsulated in
+#    ActiveResource::Formats::TwilioFormat.
+# 
+# All of the Twilio ActiveResource classes inherit from this class.
+class TwilioResource::Base < ActiveResource::Base
+
+  class << self
+    attr_accessor :sid
+    attr_accessor :token
+
+    alias_method :user, :sid
+    alias_method :user=, :sid=
+    alias_method :password, :token
+    alias_method :password=, :token=
+  end
+  
+  # Have to override this to make empty extensions work (without the dot)
+  def self.element_path(id, prefix_options = {}, query_options = nil)
+    prefix_options, query_options = split_options(prefix_options) if query_options.nil?
+    extension = format.extension.blank? ? "" : ".#{format.extension}"
+    path = "#{prefix(prefix_options)}#{collection_name}/#{id}#{extension}#{query_string(query_options)}"
+    TwilioResource.logger.info("Request: #{path}")
+    path
+  end
+
+  # Have to override this to make empty extensions work (without the dot)
+  def self.collection_path(prefix_options = {}, query_options = nil)
+    prefix_options, query_options = split_options(prefix_options) if query_options.nil?
+    extension = format.extension.blank? ? "" : ".#{format.extension}"
+    path = "#{prefix(prefix_options)}#{collection_name}#{extension}#{query_string(query_options)}"
+    TwilioResource.logger.info("Request: #{path}")
+    path
+  end
+
+  # Have to override this to make empty extensions work (without the dot)
+  def self.custom_method_collection_url(method_name, options = {})
+    prefix_options, query_options = split_options(options)
+    extension = format.extension.blank? ? "" : ".#{format.extension}"
+    path = "#{prefix(prefix_options)}#{collection_name}/#{method_name}#{extension}#{query_string(query_options)}"
+    TwilioResource.logger.info("Request: #{path}")
+    path
+  end
+
+  # Twilio uses capitalized path names
+  def self.element_name
+    super.camelize
+  end
+
+  def self.query_string(params)
+    # camelize all the param keys, because that's what Twilio expects
+    fixed_params_list = params.map {|k, v| [k.to_s.camelize, v]}.flatten
+    fixed_params_hash = Hash[*fixed_params_list] # Hash really needs a decent #map
+    super(fixed_params_hash)
+  end
+
+  # we should wrap the exceptions we can
+  def save(*params)
+    begin
+      super(*params)
+    rescue => e
+      raise TwilioResource::Exception.find_exception(e)
+    end
+
+  end
+
+
+  self.site = "https://api.twilio.com"
+  self.prefix = '/2008-08-01/'
+  self.format = :twilio
+end

data/lib/twilio_resource/call.rb

@@ -0,0 +1,20 @@
+
+# Encapsulates a Twilio call resource. Documentation:
+# - http://www.twilio.com/docs/api/2008-08-01/rest/call
+# - http://www.twilio.com/docs/api/2008-08-01/rest/making_calls
+class TwilioResource::Call < TwilioResource::Base
+  self.prefix = superclass.prefix_source + 'Accounts/:account_id/'
+
+  NOT_DIALED = 0
+  IN_PROGRESS = 1
+  COMPLETE = 2
+
+  # Returns the status of the call. Can be
+  # TwilioResource::Call::NOT_DIALED,
+  # TwilioResource::Call::IN_PROGRESS, or
+  # TwilioResource::Call::COMPLETE
+  def status
+    attributes["status"].to_i if attributes["status"]
+  end
+ 
+end

data/lib/twilio_resource/exceptions.rb

@@ -0,0 +1,39 @@
+module TwilioResource
+end
+
+# Wraps Twilio exceptions with a ruby exception class. Currently supports:
+#   
+#    - Error 21452 - No Phone Numbers Found
+class TwilioResource::Exception < StandardError
+
+  # Given a twilio error xml response, returns the corresponding
+  # exception if it is mapped, or the xml response otherwise.
+  def self.find_exception(e)
+    new_exception = if e.respond_to?(:response)
+      exception_data = Hash.from_xml(e.response.body)
+
+      
+      code = exception_data['twilio_response'] && 
+          exception_data['twilio_response']['rest_exception'] && 
+          exception_data['twilio_response']['rest_exception']['code']
+      exception_klass = twilio_exceptions[code.to_i] if code
+      exception_klass.nil? ? e : exception_klass.new
+    else
+      e
+    end
+  end
+  
+  # Hash mapping error codes to exception classes.
+  def self.twilio_exceptions
+    {
+      21452 => TwilioResource::NoPhoneNumbersFoundException,
+    }
+  end
+  
+end
+
+class TwilioResource::NoPhoneNumbersFoundException < TwilioResource::Exception
+  def message
+    "No phone numbers found"
+  end
+end

data/lib/twilio_resource/incoming_phone_number.rb

@@ -0,0 +1,6 @@
+# Represents a Twilio-controlled phone number that can receive
+# incoming phone calls. Documentation is at
+# http://www.twilio.com/docs/api/2008-08-01/rest/incoming-phone-numbers
+class TwilioResource::IncomingPhoneNumber < TwilioResource::Base
+  self.prefix = superclass.prefix_source + 'Accounts/:account_id/'
+end

data/lib/twilio_resource/local_incoming_phone_number.rb

@@ -0,0 +1,14 @@
+# Represents a Twilio-controlled "local" phone number that can receive
+# incoming phone calls. If there are no numbers available in the
+# specified area code, #save will throw a
+# TwilioResource::NoPhoneNumbersFoundException. Documentation is at
+# http://www.twilio.com/docs/api/2008-08-01/rest/incoming-phone-numbers
+class TwilioResource::LocalIncomingPhoneNumber < TwilioResource::IncomingPhoneNumber
+  
+  self.prefix = superclass.prefix_source + 'IncomingPhoneNumbers/'
+
+  def self.collection_name
+    'Local'
+  end
+
+end

data/lib/twilio_resource/toll_free_incoming_phone_number.rb

@@ -0,0 +1,14 @@
+# Represents a Twilio-controlled toll-free phone number that can receive
+# incoming phone calls. If there are no numbers available in the
+# specified area code, #save will throw a
+# TwilioResource::NoPhoneNumbersFoundException. Documentation is at
+# http://www.twilio.com/docs/api/2008-08-01/rest/incoming-phone-numbers
+class TwilioResource::TollFreeIncomingPhoneNumber < TwilioResource::IncomingPhoneNumber
+  
+  self.prefix = superclass.prefix_source + 'IncomingPhoneNumbers/'
+
+  def self.collection_name
+    'TollFree'
+  end
+
+end

data/lib/twilio_resource/twilio_format.rb

@@ -0,0 +1,56 @@
+module ActiveResource
+  module Formats
+    module TwilioFormat
+      extend self
+      
+      def extension
+        ""
+      end
+      
+      def mime_type
+        'application/x-www-form-urlencoded'
+      end
+      
+      # twilio uses camelcase for all of its params, and uses a query string for posts.
+      def encode(hash, options = {})
+        camelized_hash = ActiveSupport::OrderedHash.new
+        hash.each do |k, v| 
+          camelized_hash[k.camelize] = v
+        end
+
+        TwilioResource.logger.info("Request: #{camelized_hash.to_query}")
+        camelized_hash.to_query
+      end
+      
+      def decode(xml)
+        TwilioResource.logger.debug("Response: #{xml}")
+        from_xml_data(Hash.from_xml(xml))
+      end
+      
+      private
+      # Manipulate from_xml Hash, because twilio doesn't format their
+      # xml in the way active_resource expects it.
+      def from_xml_data(data)
+        if data.is_a?(Hash) && data['twilio_response']
+          from_xml_data(data['twilio_response'])
+        else
+          data.each do |k, v|
+            # convert array-like things to actual arrays. twilio
+            # paginates their arrays, so it's easy to detect here.  If
+            # it's the empty set, initialize it to an array so
+            # active_resource doesn't throw a fit.
+            if v["page"]
+              array_data = v[k.singularize] 
+              data[k] = [array_data].flatten.compact
+            elsif v.blank?
+              data[k] = []
+            end
+          end
+          # now we have "calls" => [c1, c2, ...], but active_resource
+          # expects [c1, c2, c3]
+          data.values.first
+        end
+      end
+    end
+  end
+end

data/test/account_test.rb

@@ -0,0 +1,17 @@
+require 'test_helper'
+require 'twilio_mock'
+
+class TwilioResource::AccountTest < Test::Unit::TestCase
+
+  def setup
+    super
+    TwilioMock.setup_remote_fixtures
+  end
+  
+  def test_find_account
+    TwilioResource::Base.user = 1
+    account = TwilioResource::Account.find(1)
+    assert_equal "2", account.status
+  end
+
+end

data/test/call_test.rb

@@ -0,0 +1,33 @@
+require 'test_helper'
+require 'twilio_mock'
+
+class TwilioResource::CallTest < Test::Unit::TestCase
+
+  def setup
+    super
+    TwilioMock.setup_remote_fixtures
+  end
+
+  def test_find_all
+    calls = TwilioResource::Call.find(:all, :params => {:account_id => 1})
+    assert_equal 2, calls.length
+  end
+
+  # what the hell, twilio? who uses capitalization to distinguish
+  # between param types? you, that's who.
+  def test_find_by_status
+    calls = TwilioResource::Call.find(:all, :params => {:account_id => 1, :status => TwilioResource::Call::COMPLETE})
+    assert_equal TwilioResource::Call::COMPLETE, calls.first.status
+  end
+
+  def test_find_by_start_time
+    calls = TwilioResource::Call.find(:all, :params => {:account_id => 1, :start_time => '2009-09-01'})
+    assert_equal 1, calls.length
+  end
+
+  def test_no_results
+    calls = TwilioResource::Call.find(:all, :params => {:account_id => 1, :status => TwilioResource::Call::COMPLETE, :start_time => '2009-09-01'})
+    assert_equal 0, calls.length
+  end
+
+end

data/test/incoming_phone_number_test.rb

@@ -0,0 +1,20 @@
+require 'test_helper'
+require 'twilio_mock'
+
+class TwilioResource::IncomingPhoneNumberTest < Test::Unit::TestCase
+
+  def setup
+    super
+    TwilioMock.setup_remote_fixtures
+  end
+
+  def test_find
+    local_number = TwilioResource::IncomingPhoneNumber.find(1, :params => {:account_id => 1})
+    assert_equal '4158675309', local_number.phone_number
+  end
+
+  def test_delete_from_class
+    assert TwilioResource::IncomingPhoneNumber.delete(1, :account_id => 1)
+  end
+  
+end

data/test/local_incoming_phone_number_test.rb

@@ -0,0 +1,39 @@
+require 'test_helper'
+require 'twilio_mock'
+
+class TwilioResource::LocalIncomingPhoneNumberTest < Test::Unit::TestCase
+
+  def setup
+    super
+    TwilioMock.setup_remote_fixtures
+  end
+  
+  def test_provision_local_number
+    phone = TwilioResource::LocalIncomingPhoneNumber.new(:url => "http://example.com/calls",
+                                                 :area_code => "206",
+                                                 :method => 'POST',
+                                                 :friendly_name => "My Local Number",
+                                                 :account_id => 1)
+    assert_equal "AreaCode=206&FriendlyName=My+Local+Number&Method=POST&Url=http%3A%2F%2Fexample.com%2Fcalls", phone.encode
+    phone.save
+
+    assert_equal '2064567890', phone.phone_number
+  end
+
+  def test_save_with_unavailable_number_throws_exception
+    TwilioResource::Base.user = 2
+    phone = TwilioResource::LocalIncomingPhoneNumber.new(:url => "http://example.com/calls",
+                                                 :area_code => "815",
+                                                 :method => 'POST',
+                                                 :friendly_name => "My Local Number",
+                                                 :account_id => TwilioResource::Base.user)
+    assert_equal "AreaCode=815&FriendlyName=My+Local+Number&Method=POST&Url=http%3A%2F%2Fexample.com%2Fcalls", phone.encode
+    assert_raises TwilioResource::NoPhoneNumbersFoundException do 
+      phone.save
+    end
+
+  end
+
+  # test find, update
+
+end

data/test/test_helper.rb

@@ -0,0 +1,7 @@
+require 'test/unit'
+require 'rubygems'
+require 'activeresource'
+require 'twilio_resource'
+
+TwilioResource.setup('1', '1')
+TwilioResource.logger.level = Logger::WARN

data/test/toll_free_incoming_phone_number_test.rb

@@ -0,0 +1,25 @@
+require 'test_helper'
+require 'twilio_mock'
+
+class TwilioResource::TollFreeIncomingPhoneNumberTest < Test::Unit::TestCase
+
+  def setup
+    super
+    TwilioMock.setup_remote_fixtures
+  end
+  
+  def test_provision_toll_free_number
+    TwilioResource::Base.user = 1
+    phone = TwilioResource::TollFreeIncomingPhoneNumber.new(:url => "http://example.com/calls",
+                                                    :method => 'POST',
+                                                    :friendly_name => "My Local Number",
+                                                    :account_id => TwilioResource::Base.user)
+    assert_equal "FriendlyName=My+Local+Number&Method=POST&Url=http%3A%2F%2Fexample.com%2Fcalls", phone.encode
+    phone.save
+
+    assert_equal '8774567890', phone.phone_number
+  end
+
+  # test find, update
+
+end

data/test/twilio_mock.rb

@@ -0,0 +1,334 @@
+require 'active_resource/http_mock'
+
+class TwilioMock
+  
+  def self.setup_remote_fixtures
+    ActiveResource::HttpMock.respond_to do |mock|
+      mock.get '/2008-08-01/Accounts/1', auth_get(1), main_account
+      mock.post '/2008-08-01/Accounts/1/IncomingPhoneNumbers/Local', auth_post(1), local_number_provision_success
+      mock.post '/2008-08-01/Accounts/2/IncomingPhoneNumbers/Local', auth_post(2), no_local_number, 400
+      mock.post '/2008-08-01/Accounts/1/IncomingPhoneNumbers/TollFree', auth_post(1), toll_free_number_provision_success
+
+      mock.get '/2008-08-01/Accounts/1/Calls', auth_get(1), all_calls
+      mock.get '/2008-08-01/Accounts/1/Calls?StartTime=2009-09-01', auth_get(1), recent_calls      
+      mock.get '/2008-08-01/Accounts/1/Calls?Status=2', auth_get(1), succeeded_recent_calls
+      mock.get '/2008-08-01/Accounts/1/Calls?StartTime=2009-09-01&Status=2', auth_get(1), no_calls
+
+      mock.get '/2008-08-01/Accounts/1/IncomingPhoneNumbers/1', auth_get(1), phone_number_data
+      mock.delete '/2008-08-01/Accounts/1/IncomingPhoneNumbers/1', auth_delete(1), phone_number_delete_success
+      mock.delete '/2008-08-01/Accounts/2/IncomingPhoneNumbers/2', auth_delete(2), "", 404
+
+    end
+
+  end
+
+  def self.auth_delete(account_id)
+    old_account_id = TwilioResource::Base.user
+    TwilioResource::Base.user = account_id
+    auth = TwilioResource::Account.connection.send(:build_request_headers, {}, :delete)
+    TwilioResource::Base.user = old_account_id
+    auth
+  end
+
+  def self.auth_post(account_id)
+    old_account_id = TwilioResource::Base.user
+    TwilioResource::Base.user = account_id
+    auth = TwilioResource::Account.connection.send(:build_request_headers, {}, :post)
+    TwilioResource::Base.user = old_account_id
+    auth
+  end
+
+  def self.auth_get(account_id)
+    old_account_id = TwilioResource::Base.user
+    TwilioResource::Base.user = account_id
+    auth = TwilioResource::Account.connection.send(:build_request_headers, {}, :get)
+    TwilioResource::Base.user = old_account_id
+    auth
+  end
+
+  def self.phone_number_data
+<<END
+<TwilioResponse> 
+    <IncomingPhoneNumber> 
+        <Sid>PNe536dfda7c6184afab78d980cb8cdf43</Sid> 
+        <AccountSid>AC35542fc30a091bed0c1ed511e1d9935d</AccountSid> 
+        <FriendlyName>My Home Phone Number</FriendlyName> 
+        <PhoneNumber>4158675309</PhoneNumber> 
+        <Url>http://mycompany.com/handleMainLineCall.asp</Url>
+        <Method>GET</Method>
+        <DateCreated>Tue, 01 Apr 2008 11:26:32 -0700</DateCreated> 
+        <DateUpdated>Tue, 01 Apr 2008 11:26:32 -0700</DateUpdated> 
+    </IncomingPhoneNumber> 
+</TwilioResponse>
+END
+  end
+
+  def self.main_account
+<<END
+<TwilioResponse>
+    <Account>  
+        <Sid>AC309475e5fede1b49e100272a8640f438</Sid>  
+        <FriendlyName>My Twilio Account</FriendlyName>
+        <Status>2</Status>
+        <StatusText>Active</StatusText>  
+        <DateCreated>Wed, 02 Apr 2008 17:33:38 -0700</DateCreated>
+        <DateUpdated>Wed, 02 Apr 2008 17:34:18 -0700</DateUpdated>  
+        <AuthToken>3a2630a909aadbf60266234756fb15a0</AuthToken>  
+    </Account>
+</TwilioResponse>   
+END
+  end
+
+  def self.phone_number_delete_success
+<<END
+ <TwilioResponse />
+END
+  end
+
+  def self.all_calls
+<<END
+<TwilioResponse>  
+    <Calls page="0" numpages="1" pagesize="50" total="38" start="0" end="37">  
+        <Call>  
+            <Sid>CA42ed11f93dc08b952027ffbc406d0868</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid/>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>4159633717</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>PN01234567890123456789012345678900</PhoneNumberSid>  
+            <Status>2</Status>  
+            <StartTime>Thu, 03 Apr 2008 04:36:33 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 04:36:47 -0400</EndTime>  
+            <Duration>14</Duration>  
+            <Price/>  
+            <Flags>1</Flags>  
+        </Call>  
+        <Call>  
+            <Sid>CA751e8fa0a0105cf26a0d7a9775fb4bfb</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid/>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>2064287985</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>PNd59c2ba27ef48264773edb90476d1674</PhoneNumberSid>  
+            <Status>2</Status>  
+            <StartTime>Thu, 03 Apr 2008 01:37:05 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 01:37:40 -0400</EndTime>  
+            <Duration>35</Duration>  
+            <Price/>  
+            <Flags>1</Flags>
+        </Call>  
+    </Calls> 
+</TwilioResponse>  
+END
+  end
+
+  def self.succeeded_calls
+<<END
+<TwilioResponse>  
+    <Calls page="0" numpages="1" pagesize="50" total="38" start="0" end="37">  
+        <Call>  
+            <Sid>CA42ed11f93dc08b952027ffbc406d0868</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid/>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>4159633717</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>PN01234567890123456789012345678900</PhoneNumberSid>  
+            <Status>2</Status>  
+            <StartTime>Thu, 03 Apr 2008 04:36:33 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 04:36:47 -0400</EndTime>  
+            <Duration>14</Duration>  
+            <Price/>  
+            <Flags>1</Flags>  
+        </Call>  
+        <Call>  
+            <Sid>1000</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid>10001</CallSegmentSid>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>4159633717</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>ABC123</PhoneNumberSid>  
+            <Status>2</Status>  
+            <StartTime>Thu, 03 Apr 2008 04:36:33 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 04:36:47 -0400</EndTime>  
+            <Duration>14</Duration>  
+            <Price/>  
+            <Flags>1</Flags>  
+        </Call>
+        <Call>  
+            <Sid>1001</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid>10002</CallSegmentSid>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>4159633717</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>ABC123</PhoneNumberSid>  
+            <Status>2</Status>
+            <StartTime>Thu, 03 Apr 2008 04:36:33 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 04:36:47 -0400</EndTime>  
+            <Duration>14</Duration>  
+            <Price/>  
+            <Flags>1</Flags>  
+        </Call>
+        <Call>  
+            <Sid>1002</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid>10003</CallSegmentSid>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>4159633717</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>ABC123</PhoneNumberSid>  
+            <Status>2</Status>
+            <StartTime>Thu, 03 Apr 2008 04:36:33 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 04:36:47 -0400</EndTime>  
+            <Duration>14</Duration>  
+            <Price/>  
+            <Flags>1</Flags>  
+        </Call>
+        <Call>  
+            <Sid>1003</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid>10004</CallSegmentSid>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>4159633717</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>UNKNOWN</PhoneNumberSid>  
+            <Status>2</Status>
+            <StartTime>Thu, 03 Apr 2008 04:36:33 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 04:36:47 -0400</EndTime>  
+            <Duration>14</Duration>  
+            <Price/>  
+            <Flags>1</Flags>  
+        </Call>
+        <Call>  
+            <Sid>AVENDORIDAVENDORIDAVENDORID</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid>10004</CallSegmentSid>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>4159633717</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>ABC123</PhoneNumberSid>  
+            <Status>2</Status>
+            <StartTime>Thu, 03 Apr 2008 04:36:33 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 04:36:47 -0400</EndTime>  
+            <Duration>14</Duration>  
+            <Price/>  
+            <Flags>1</Flags>  
+        </Call>
+    </Calls> 
+</TwilioResponse>  
+END
+  end
+
+  def self.recent_calls
+    <<END
+<TwilioResponse>  
+    <Calls page="0" numpages="1" pagesize="50" total="38" start="0" end="37">  
+        <Call>  
+            <Sid>CA42ed11f93dc08b952027ffbc406d0868</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid/>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>4159633717</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>PN01234567890123456789012345678900</PhoneNumberSid>  
+            <Status>1</Status>  
+            <StartTime>Thu, 03 Apr 2008 04:36:33 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 04:36:47 -0400</EndTime>  
+            <Duration>14</Duration>  
+            <Price/>  
+            <Flags>1</Flags>  
+        </Call>
+    </Calls> 
+</TwilioResponse>  
+END
+  end
+
+
+  def self.succeeded_recent_calls
+    <<END
+<TwilioResponse>  
+    <Calls page="0" numpages="1" pagesize="50" total="38" start="0" end="37">  
+        <Call>  
+            <Sid>CA42ed11f93dc08b952027ffbc406d0868</Sid>  
+            <DateCreated>Sat, 07 Feb 2009 13:15:19 -0800</DateCreated>
+            <DateUpdated>Sat, 07 Feb 2009 13:15:19 -0800</DateUpdated>
+            <CallSegmentSid>8142ed11f93dc08b952027ffbc406d0868</CallSegmentSid>  
+            <AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>  
+            <Called>4159633717</Called>  
+            <Caller>4156767925</Caller>  
+            <PhoneNumberSid>PN01234567890123456789012345678900</PhoneNumberSid>  
+            <Status>2</Status>  
+            <StartTime>Thu, 03 Apr 2008 04:36:33 -0400</StartTime>  
+            <EndTime>Thu, 03 Apr 2008 04:36:47 -0400</EndTime>  
+            <Duration>14</Duration>  
+            <Price/>  
+            <Flags>1</Flags>  
+        </Call>
+    </Calls> 
+</TwilioResponse>  
+END
+  end
+
+  def self.no_calls
+<<END
+<TwilioResponse>  
+    <Calls page="0" numpages="1" pagesize="50" total="38" start="0" end="37">  
+    </Calls> 
+</TwilioResponse>  
+END
+  end
+
+  def self.local_number_provision_success
+<<END
+<TwilioResponse> 
+    <IncomingPhoneNumber> 
+        <Sid>PNe536dfda7c6184afab78d980cb8cdf43</Sid> 
+        <AccountSid>AC35542fc30a091bed0c1ed511e1d9935d</AccountSid> 
+        <FriendlyName>My Local Number</FriendlyName> 
+        <PhoneNumber>2064567890</PhoneNumber> 
+        <Url>http://example.com/calls</Url>
+        <Method>GET</Method>
+        <DateCreated>Tue, 01 Apr 2008 11:26:32 -0700</DateCreated> 
+        <DateUpdated>Tue, 01 Apr 2008 11:26:32 -0700</DateUpdated> 
+    </IncomingPhoneNumber> 
+</TwilioResponse>   
+END
+  end
+
+  def self.toll_free_number_provision_success
+<<END
+<TwilioResponse> 
+    <IncomingPhoneNumber> 
+        <Sid>PNe536dfda7c6184afab78d980cb8cdf43</Sid> 
+        <AccountSid>AC35542fc30a091bed0c1ed511e1d9935d</AccountSid> 
+        <FriendlyName>My Toll Free Number</FriendlyName> 
+        <PhoneNumber>8774567890</PhoneNumber> 
+        <Url>http://example.com/calls</Url>
+        <Method>GET</Method>
+        <DateCreated>Tue, 01 Apr 2008 11:26:32 -0700</DateCreated> 
+        <DateUpdated>Tue, 01 Apr 2008 11:26:32 -0700</DateUpdated> 
+    </IncomingPhoneNumber> 
+</TwilioResponse>   
+END
+  end
+
+  def self.no_local_number
+<<END
+<TwilioResponse><RestException><Status>400</Status><Message>No phone numbers found</Message><Code>21452</Code><MoreInfo>http://www.twilio.com/docs/errors/21452</MoreInfo></RestException></TwilioResponse>
+END
+  end
+
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification 
+name: twilio_resource
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Justin Weiss
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-16 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activeresource
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 3
+        - 2
+        version: 2.3.2
+  type: :runtime
+  version_requirements: *id001
+description: 
+email: justin@uberweiss.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- lib/twilio_resource/account.rb
+- lib/twilio_resource/base.rb
+- lib/twilio_resource/call.rb
+- lib/twilio_resource/exceptions.rb
+- lib/twilio_resource/incoming_phone_number.rb
+- lib/twilio_resource/local_incoming_phone_number.rb
+- lib/twilio_resource/toll_free_incoming_phone_number.rb
+- lib/twilio_resource/twilio_format.rb
+- lib/twilio_resource.rb
+- test/account_test.rb
+- test/call_test.rb
+- test/incoming_phone_number_test.rb
+- test/local_incoming_phone_number_test.rb
+- test/test_helper.rb
+- test/toll_free_incoming_phone_number_test.rb
+- test/twilio_mock.rb
+- README.md
+has_rdoc: true
+homepage: http://github.com/justinweiss/twilio_resource
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: An ActiveResource API wrapper for Twilio
+test_files: 
+- test/account_test.rb
+- test/call_test.rb
+- test/incoming_phone_number_test.rb
+- test/local_incoming_phone_number_test.rb
+- test/toll_free_incoming_phone_number_test.rb