Derferman-twilio 0.1.3

data/Changelog

@@ -0,0 +1,3 @@
+Changelog for Twilio Ruby Gem
+=================================================
+0.1.2 - Renamed gem

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2008 Twilio, Inc.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,26 @@
+Ruby Twilio REST SDK
+
+
+DESCRIPTION
+The Twilio REST SDK simplifies the process of makes calls to the Twilio REST.
+The Twilio REST API lets to you initiate outgoing calls, list previous call,
+and much more.  See http://www.twilio.com/docs for more information.
+
+
+USAGE
+To use the twiliorest.rb library with Rails just copy the twiliorest.rb file
+into the lib directory of your Rails application. Then just require
+"twiliorest.rb" in the controller or code file you wish to use the Twilio REST
+API from. As shown in example.rb, you will need to specify the ACCOUNT_ID and
+ACCOUNT_TOKEN given to you by Twilio before you can make REST requests. In
+addition, you will need to choose a 'Caller' and 'Called' before making
+outgoing calls. See http://www.twilio.com/docs for more information.
+
+
+FILES
+twiliorest.rb -- include this library in your code
+example.rb -- example usage of twiliorest library
+
+
+LICENSE
+The Twilio SDK is distributed under the MIT License

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+
+spec = Gem::Specification.new do |s| 
+  s.name = "twilio"
+  s.version = "0.1.3"
+  s.author = "Kyle Conroy"
+  s.email = "kjconroy@twilio.com"
+  s.homepage = "http://www.twilio.com/docs"
+  s.platform = Gem::Platform::RUBY
+  s.summary = "Some description"
+  s.files = FileList["{lib}/*"].to_a
+  s.require_path = "lib"
+  s.test_files = FileList["{test}/response_spec.rb"].to_a
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README"]
+  s.add_dependency("builder", ">= 2.1.2")
+end
+ 
+Rake::GemPackageTask.new(spec) do |pkg| 
+  pkg.need_tar = true 
+end 
+
+task :default => "pkg/#{spec.name}-#{spec.version}.gem" do
+    puts "generated latest version"
+end

data/example-rest.rb

@@ -0,0 +1,63 @@
+#!/usr/bin/env ruby
+
+require "twiliorest.rb"
+
+# Twilio REST API version
+API_VERSION = '2008-08-01'
+
+# Twilio AccountSid and AuthToken
+ACCOUNT_SID = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
+ACCOUNT_TOKEN = 'YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY'
+
+# Outgoing Caller ID previously validated with Twilio
+CALLER_ID = 'NNNNNNNNNN';
+
+# Create a Twilio REST account object using your Twilio account ID and token
+account = TwilioRest::Account.new(ACCOUNT_SID, ACCOUNT_TOKEN)
+
+# ===========================================================================
+# 1. Initiate a new outbound call to 415-555-1212
+#    uses a HTTP POST
+d = {
+    'Caller' => CALLER_ID,
+    'Called' => '415-555-1212',
+    'Url' => 'http://demo.twilio.com/welcome',
+}
+resp = account.request("/#{API_VERSION}/Accounts/#{ACCOUNT_SID}/Calls",
+    'POST', d)
+resp.error! unless resp.kind_of? Net::HTTPSuccess
+puts "code: %s\nbody: %s" % [resp.code, resp.body]
+
+# ===========================================================================
+# 2. Get a list of recent completed calls (i.e. Status = 2)
+#    uses a HTTP GET
+d = { 'Status' => 2 }
+resp = account.request("/#{API_VERSION}/Accounts/#{ACCOUNT_SID}/Calls",
+    'GET', d)
+resp.error! unless resp.kind_of? Net::HTTPSuccess
+puts "code: %s\nbody: %s" % [resp.code, resp.body]
+
+# ===========================================================================
+# 3. Get a list of recent notification log entries
+#    uses a HTTP GET
+resp = account.request("/#{API_VERSION}/Accounts/#{ACCOUNT_SID}/\
+Notifications", 'GET')
+resp.error! unless resp.kind_of? Net::HTTPSuccess
+puts "code: %s\nbody: %s" % [resp.code, resp.body]
+
+# ===========================================================================
+# 4. Get a list of audio recordings for a certain call
+#    uses a HTTP GET
+d = { 'CallSid' => 'CA5d44cc11756367a4c54e517511484900' }
+resp = account.request("/#{API_VERSION}/Accounts/#{ACCOUNT_SID}/Recordings",
+    'GET', d)
+resp.error! unless resp.kind_of? Net::HTTPSuccess
+puts "code: %s\nbody: %s" % [resp.code, resp.body]
+
+# ===========================================================================
+# 5. Delete a specific recording
+#    uses a HTTP DELETE, no response is returned when using DLETE
+resp = account.request( \
+    "/#{API_VERSION}/Accounts/#{ACCOUNT_SID}/Recordings/\
+RE7b22d733d3e730d234e94242b9697cae", 'DELETE')
+puts "code: %s" % [resp.code]

data/example-twiml.rb

@@ -0,0 +1,72 @@
+require "twilio.rb"
+
+# Say, Dial, and Play
+@r = Twilio::Response.new
+@r.append(Twilio::Say.new "Hello World", :voice => "man", :loop => "10")
+@r.append(Twilio::Dial.new("5305451766", :timeLimit => "45"))
+@r.append(Twilio::Play.new("http://www.mp3.com"))
+puts @r.respond
+
+# @r.respond; outputs:
+#<Response>
+#	<Say voice="man" loop="10">Hello World</Say>
+#	<Play>http://www.mp3.com</Play>
+#	<Dial timeLimit="45">5305451766</Dial>
+#</Response>
+
+
+# Gather, Redirect 
+@r = Twilio::Response.new;
+@g = @r.append(Twilio::Gather.new(:numDigits => "10"))
+@g.append(Twilio::Say.new("Press 1"))
+@r.append(Twilio::Redirect.new())
+puts @r.respond
+
+
+#<Response>
+#	<Gather numDigits="1">
+#		<Say>Press 1</Say>
+#	</Gather>
+#	<Redirect/>
+#</Response>
+
+
+
+# Add a Say verb multiple times
+@r = Twilio::Response.new
+@say = Twilio::Say.new("Press 1")
+@r.append(@say);
+@r.append(@say);
+puts @r.respond
+
+#<Response>
+#	<Say>Press 1</Say>
+#	<Say>Press 1</Say>
+#</Response>
+
+
+# Set any attribute / value pair
+	
+@r = Twilio::Response.new
+@r.append(Twilio::Redirect.new(:__crazy => "delicious"))
+puts @r.respond
+
+
+#<Response>
+#	<Redirect crazy="delicious"/>
+#<Response>
+
+# Convenience methods
+@r = Twilio::Response.new
+@r.addSay "Hello World", :voice => "man", :language => "fr", :loop => "10"
+@r.addDial "5305451766", :timeLimit => "45"
+@r.addPlay "http://www.mp3.com"
+puts @r.respond
+
+# @r.respond; outputs:
+#<Response>
+#	<Say voice="man" language="fr" loop="10">Hello World</Say>
+#	<Play>http://www.mp3.com</Play>
+#	<Dial timeLimit="45">5305451766</Dial>
+#</Response>
+

data/lib/twilio.rb

@@ -0,0 +1,342 @@
+=begin
+Copyright (c) 2009 Twilio, Inc.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+=end
+
+module Twilio
+    require 'net/http'
+    require 'net/https'
+    require 'uri'
+    require 'cgi'
+    require 'rubygems'
+    require 'builder'
+    
+    TWILIO_API_URL = 'https://api.twilio.com'
+    
+    class RestAccount
+        
+        #initialize a twilio account object
+        #
+        #@param [String, String] Your Twilio Acount SID/ID and Auth Token
+        #@return [Object] Twilio account object
+        def initialize(id, token)
+            @id = id
+            @token = token
+        end
+        
+        #sends a request and gets a response from the Twilio REST API
+        #
+        #@param [String, String, Hash] 
+        #path, the URL (relative to the endpoint URL, after the /v1
+        #method, the HTTP method to use, defaults to POST
+        #vars, for POST or PUT, a dict of data to send
+        #
+        #@return Twilio response XML
+        #@raises [ArgumentError] Invalid path parameter
+        #@raises [NotImplementedError] Method given is not implemented
+        def request(path, method=nil, vars={})
+            if !path || path.length < 1
+                raise ArgumentError, 'Invalid path parameter'
+            end
+            if method && !['GET', 'POST', 'DELETE', 'PUT'].include?(method)
+                raise NotImplementedError, 'HTTP %s not implemented' % method
+            end
+            
+            if path[0, 1] == '/'
+                uri = TWILIO_API_URL + path
+            else
+                uri = TWILIO_API_URL + '/' + path
+            end
+            
+            return fetch(uri, vars, method)
+        end
+        
+        #enocde the parameters into a URL friendly string
+        #
+        #@param [Hash] URL key / values        
+        #@return [String] Encoded URL
+        protected
+        def urlencode(params)
+            params.to_a.collect! \
+                { |k, v| "#{k}=#{CGI.escape(v.to_s)}" }.join("&")
+        end
+        
+        # Create the uri for the REST call
+        #
+        #@param [String, Hash] Base URL and URL parameters        
+        #@return [String] URI for the REST call
+        def build_get_uri(uri, params)
+            if params && params.length > 0
+                if uri.include?('?')
+                    if uri[-1, 1] != '&'
+                        uri += '&'
+                    end
+                    uri += urlencode(params)
+                else
+                    uri += '?' + urlencode(params)
+                end
+            end
+            return uri
+        end
+        
+        # Returns a http request for the given url and parameters
+        #
+        #@param [String, Hash, String] Base URL, URL parameters, optional METHOD string        
+        #@return [String] URI for the REST call
+        def fetch(url, params, method=nil)
+            if method && method == 'GET'
+                url = build_get_uri(url, params)
+            end
+            uri = URI.parse(url)
+            
+            http = Net::HTTP.new(uri.host, uri.port)
+            http.use_ssl = true
+            
+            if method && method == 'GET'
+                req = Net::HTTP::Get.new(uri.request_uri)
+            elsif method && method == 'DELETE'
+                req = Net::HTTP::Delete.new(uri.request_uri)
+            elsif method && method == 'PUT'
+                req = Net::HTTP::Put.new(uri.request_uri)
+                req.set_form_data(params)
+            else
+                req = Net::HTTP::Post.new(uri.request_uri)
+                req.set_form_data(params)
+            end
+            req.basic_auth(@id, @token)
+            
+            return http.request(req)
+        end
+    end
+       
+    module Verb
+	    module ClassMethods
+	      @attributes = []
+	      @allowed_verbs = []
+	      attr_accessor :attributes
+	
+	      def allowed_verbs(*verbs)
+	        return @allowed_verbs if verbs == []
+	        @allowed_verbs = [] if @allowed_verbs.nil?
+	        verbs.each do |verb|
+	          @allowed_verbs << verb.to_s.capitalize
+	        end
+	        @allowed_verbs = @allowed_verbs.uniq
+	      end
+	
+	      def attributes(*attrs)
+	        return @attributes if attrs == []
+	        @attributes = [] if @attributes.nil?
+	        @attributes = (@attributes + attrs).uniq
+	        attr_accessor(*@attributes)
+	        @attributes
+	      end
+	    end
+	
+	    def attributes
+	      self.class.attributes
+	    end
+	
+	    #test if a given verb is allowed to be nested
+        #
+        #@param [Object] Verb to be appended
+        #@return [true, false]
+	    def allowed?(verb)
+	      self.class.allowed_verbs.nil? ? false : self.class.allowed_verbs.include?(verb.class.name.split('::')[1])
+	    end
+	       
+	    #initialize a twilio response object
+        #
+        #@param [String, Hash] Body of the verb, and a hash of the attributes
+        #@return [Object] Twilio Verb object
+        #
+        #@raises [ArgumentError] Invalid Argument
+	    def initialize(body = nil, params = {})
+	      @children = []
+	      if body.class == String
+	        @body = body
+	      else
+	        @body = nil
+	        params = body || {}
+	      end
+	      params.each do |k,v|
+	        if !self.class.attributes.nil? && self.class.attributes.include?(k)
+	          send(k.to_s+"=",v)
+	        else
+	          raise ArgumentError, "Attribute Not Supported"
+	        end
+	      end
+	    end
+
+	    #set an attribute key / value
+        #no error checking 
+        #
+        #@param [Hash] Hash of options
+        #@return void	    
+	    def set(params = {})
+	      params.each do |k,v|
+	        self.class.attributes k.to_s
+	        send(k.to_s+"=",v)
+	      end     
+	    end
+
+	    #output valid Twilio markup
+        #
+        #@param [Hash] Hash of options
+        #@return [String] Twilio Markup (in XML)	
+	    def respond(opts = {})
+	      opts[:builder]  ||= Builder::XmlMarkup.new(:indent => opts[:indent])
+	      b = opts[:builder]
+	      attrs = {}
+	      #attributes.each {|a| puts send(a) } unless attributes.nil?
+	      attributes.each {|a| attrs[a] = send(a) unless send(a).nil? } unless attributes.nil?
+	
+	      if @children and @body.nil?
+	        b.__send__(self.class.to_s.split(/::/)[-1], attrs) do
+	          @children.each {|e|e.respond( opts.merge(:skip_instruct => true) )}
+	        end
+	      elsif @body and @children == []
+	        b.__send__(self.class.to_s.split(/::/)[-1], @body, attrs)
+	      else
+	        raise ArgumentError, "Cannot have children and a body at the same time"
+	      end
+	    end
+	    
+	    #output valid Twilio markup encoded for inclusion in a URL
+        #
+        #@param []
+        #@return [String] URL encoded Twilio Markup (XML)
+	    def to_URLstring()
+	      CGI::escape(self.respond)
+	    end
+	    
+	    def append(verb)
+	      if(allowed?(verb))
+	        @children << verb
+	        @children[-1]
+	      else
+	        raise ArgumentError, "Verb Not Supported"
+	      end    
+	    end
+	    
+	    ##### Verb Convenience Methods #####
+	    def addSay(string_to_say = nil, opts = {})
+	      append(Twilio::Say.new(string_to_say, opts))
+	    end
+	
+	    def addPlay(file_to_play = nil, opts = {})
+	      append Twilio::Play.new(file_to_play, opts)
+	    end
+	
+	    def addGather(opts = {})
+	      append Twilio::Gather.new(opts)
+	    end
+	
+	    def addRecord(opts = {})
+	      append Twilio::Record.new(opts)
+	    end
+	
+	    def addDial(number = nil, opts = {})
+	      append Twilio::Dial.new(number, opts)
+	    end
+	
+	    def addRedirect(url = nil, opts = {})
+	      append Twilio::Redirect.new(url, opts)
+	    end
+	
+	    def addPause(opts = {})
+	      append Twilio::Pause.new(opts)
+	    end
+	
+	    def addHangup
+	      append Twilio::Hangup.new 
+	    end
+	
+	    def addNumber(number, opts = {})
+	      append Twilio::Number.new(number, opts)
+	    end
+	
+	  end
+	
+	  class Say
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	    attributes :voice, :language, :loop
+	  end
+	
+	  class Play
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	    attributes :loop
+	  end
+	
+	  class Gather
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	    attributes :action, :method, :timeout, :finishOnKey, :numDigits
+	    allowed_verbs :play, :say, :pause
+	  end
+	
+	  class Record
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	    attributes :action, :method, :timeout, :finishOnKey, :maxLength, :transcribe, :transcribeCallback
+	  end
+	
+	  class Dial
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	    attributes :action, :method, :timeout, :hangupOnStar, :timeLimit, :callerId
+	    allowed_verbs :number
+	  end
+	
+	  class Redirect
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	    attributes :method
+	  end
+	
+	  class Pause
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	    attributes :length
+	  end
+	
+	  class Hangup
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	  end
+	
+	  class Number
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	    attributes :sendDigits, :url
+	  end
+	
+	  class Response
+	    extend Twilio::Verb::ClassMethods
+	    include Twilio::Verb
+	    allowed_verbs :say, :play, :gather, :record, :dial, :redirect, :pause, :hangup
+	  end
+
+end

data/tests/response_spec.rb

@@ -0,0 +1,366 @@
+require File.dirname(__FILE__) + '/../twilio-rb/twilio.rb'
+
+module AccountExampleHelperMethods
+
+  def bad_append(verb)
+    
+    lambda {verb.append(Twilio::Response)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Say)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Play)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Gather)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Record)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Redirect)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Hangup)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Pause)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Number)}.should raise_error(ArgumentError)     
+    
+  end
+  
+  def bad_attr(verb)
+    lambda {verb.new(:crazy => 'delicious')}.should raise_error(ArgumentError) 
+  end
+
+end
+
+describe Twilio::Response do
+  include AccountExampleHelperMethods
+  
+  it "should be an empty response" do
+    @r = Twilio::Response.new
+    @r.respond.should == '<Response></Response>'
+  end
+  
+  it "add attribute" do
+    @r = Twilio::Response.new
+    @r.set :crazy => 'delicious'
+    @r.respond.should == '<Response crazy="delicious"></Response>'
+  end
+  
+  it "bad attribute" do
+    bad_attr(Twilio::Response)
+  end
+  
+end
+
+describe Twilio::Say do
+  include AccountExampleHelperMethods
+
+  it "should say hello monkey" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Say.new("Hello Monkey"))
+    @r.respond.should == '<Response><Say>Hello Monkey</Say></Response>'
+  end
+  
+  it "should say hello monkey and loop 3 times" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Say.new("Hello Monkey", :loop => 3))
+    @r.respond.should == '<Response><Say loop="3">Hello Monkey</Say></Response>'
+  end
+  
+  it "should say have a woman say hello monkey and loop 3 times" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Say.new("Hello Monkey", :voice => 'woman'))
+    @r.respond.should == '<Response><Say voice="woman">Hello Monkey</Say></Response>'
+  end
+  
+  it "should say have a woman say hello monkey and loop 3 times and be in french" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Say.new("Hello Monkey", :language => 'fr'))
+    @r.respond.should == '<Response><Say language="fr">Hello Monkey</Say></Response>'
+  end
+  
+  it "convenience method: should say have a woman say hello monkey and loop 3 times and be in french" do
+    @r = Twilio::Response.new
+    @r.addSay "Hello Monkey", :language => 'fr'
+    @r.respond.should == '<Response><Say language="fr">Hello Monkey</Say></Response>'
+  end
+  
+  it "should raises exceptions for wrong appending" do
+    @r = Twilio::Response.new
+    @s = @r.append(Twilio::Say.new("Hello Monkey"))
+    bad_append @s
+  end
+  
+  it "add attribute" do
+    @r = Twilio::Say.new
+    @r.set :crazy => 'delicious'
+    @r.respond.should == '<Say crazy="delicious"></Say>'
+  end
+
+end
+
+describe Twilio::Play do
+  include AccountExampleHelperMethods
+  
+  it "should play hello monkey" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Play.new("Hello Monkey.mp3"))
+    @r.respond.should == '<Response><Play>Hello Monkey.mp3</Play></Response>'
+  end
+  
+  it "should play hello monkey" do 
+    @r = Twilio::Response.new
+    @r.append(Twilio::Play.new("Hello Monkey.mp3", :loop => '3'))
+    @r.respond.should == '<Response><Play loop="3">Hello Monkey.mp3</Play></Response>'
+  end
+  
+  it "convenience method: should play hello monkey" do 
+    @r = Twilio::Response.new
+    @r.addPlay "Hello Monkey.mp3", :loop => '3'
+    @r.respond.should == '<Response><Play loop="3">Hello Monkey.mp3</Play></Response>'
+  end
+  
+  it "should raises exceptions for wrong appending" do
+    @r = Twilio::Response.new
+    @s = @r.append(Twilio::Play.new("Hello Monkey.mp3", :loop => '3'))
+    bad_append @s
+  end
+  
+  it "add attribute" do
+    @r = Twilio::Play.new
+    @r.set :crazy => 'delicious'
+    @r.respond.should == '<Play crazy="delicious"></Play>'
+  end
+
+end
+
+describe Twilio::Record do
+  include AccountExampleHelperMethods
+  
+  it "should record" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Record.new())
+    @r.respond.should == '<Response><Record></Record></Response>'
+  end
+  
+  it "should record with an action and a get method" do 
+    r = Twilio::Response.new
+    r.append(Twilio::Record.new(:action => "example.com", :method => 'GET'))
+    r.respond.should == '<Response><Record action="example.com" method="GET"></Record></Response>'
+  end
+  
+  it "should record with an maxlength, finishonkey, and timeout" do 
+    r = Twilio::Response.new
+    r.append(Twilio::Record.new(:timeout => "4", :finishOnKey => '#', :maxLength => "30"))
+    r.respond.should == '<Response><Record timeout="4" finishOnKey="#" maxLength="30"></Record></Response>'
+  end
+  
+  it "should record with a transcribe and transcribeCallback" do 
+    r = Twilio::Response.new
+    r.append(Twilio::Record.new(:transcribeCallback => 'example.com'))
+    r.respond.should == '<Response><Record transcribeCallback="example.com"></Record></Response>'
+  end
+  
+  it "convenience methods: should record with a transcribe and transcribeCallback" do 
+    r = Twilio::Response.new
+    r.addRecord :transcribeCallback => 'example.com'
+    r.respond.should == '<Response><Record transcribeCallback="example.com"></Record></Response>'
+  end
+  
+  it "should raises exceptions for wrong appending" do
+    @r = Twilio::Response.new
+    @s = @r.append(Twilio::Record.new())
+    bad_append @s
+  end
+  
+  it "add attribute" do
+    @r = Twilio::Record.new
+    @r.set :crazy => 'delicious'
+    @r.respond.should == '<Record crazy="delicious"></Record>'
+  end
+
+end
+
+
+describe Twilio::Redirect do
+  include AccountExampleHelperMethods
+  
+  it "should redirect" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Redirect.new())
+    @r.respond.should == '<Response><Redirect></Redirect></Response>'
+  end
+  
+  it "should redirect to a url via POST" do 
+    @r = Twilio::Response.new
+    @r.append(Twilio::Redirect.new("example.com", :method => "POST"))
+    @r.respond.should == '<Response><Redirect method="POST">example.com</Redirect></Response>'
+  end
+ 
+  it "convenience: should redirect to a url via POST" do 
+    @r = Twilio::Response.new
+    @r.addRedirect "example.com", :method => "POST"
+    @r.respond.should == '<Response><Redirect method="POST">example.com</Redirect></Response>'
+  end 
+
+  it "should raises exceptions for wrong appending" do
+    @r = Twilio::Response.new
+    @s = @r.append(Twilio::Redirect.new())
+    bad_append @s
+  end
+  
+  it "add attribute" do
+    @r = Twilio::Redirect.new
+    @r.set :crazy => 'delicious'
+    @r.respond.should == '<Redirect crazy="delicious"></Redirect>'
+  end
+
+
+end
+
+describe Twilio::Hangup do
+  include AccountExampleHelperMethods
+  
+  it "should redirect" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Hangup.new())
+    @r.respond.should == '<Response><Hangup></Hangup></Response>'
+  end
+ 
+  it "convenience: should Hangup to a url via POST" do 
+    @r = Twilio::Response.new
+    @r.addHangup
+    @r.respond.should == '<Response><Hangup></Hangup></Response>'
+  end 
+
+  it "should raises exceptions for wrong appending" do
+    @r = Twilio::Response.new
+    @s = @r.append(Twilio::Hangup.new())
+    bad_append @s
+  end
+  
+  it "add attribute" do
+    @r = Twilio::Hangup.new
+    @r.set :crazy => 'delicious'
+    @r.respond.should == '<Hangup crazy="delicious"></Hangup>'
+  end
+
+end
+
+describe Twilio::Pause do
+  include AccountExampleHelperMethods
+  
+  it "should redirect" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Pause.new())
+    @r.respond.should == '<Response><Pause></Pause></Response>'
+  end
+ 
+  it "convenience: should Pause to a url via POST" do 
+    @r = Twilio::Response.new
+    @r.addPause :length => '4'
+    @r.respond.should == '<Response><Pause length="4"></Pause></Response>'
+  end 
+
+  it "should raises exceptions for wrong appending" do
+    @r = Twilio::Response.new
+    @s = @r.append(Twilio::Pause.new())
+    bad_append @s
+  end
+  
+  it "add attribute" do
+    @r = Twilio::Pause.new
+    @r.set :crazy => 'delicious'
+    @r.respond.should == '<Pause crazy="delicious"></Pause>'
+  end
+
+end
+
+describe Twilio::Dial do
+  include AccountExampleHelperMethods
+  
+  it "should redirect" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Dial.new("1231231234"))
+    @r.respond.should == '<Response><Dial>1231231234</Dial></Response>'
+  end
+ 
+  it "convenience: should Hangup to a url via POST" do 
+    @r = Twilio::Response.new
+    @r.addDial
+    @r.respond.should == '<Response><Dial></Dial></Response>'
+  end 
+
+  it "add a number to a dial" do
+    @r = Twilio::Response.new
+    @d = @r.append(Twilio::Dial.new())
+    @d.append(Twilio::Number.new("1231231234"))
+    @r.respond.should == '<Response><Dial><Number>1231231234</Number></Dial></Response>'
+  end
+  
+  it "convenience: add a number to a dial" do
+    @r = Twilio::Response.new
+    @d = @r.addDial
+    @d.addNumber "1231231234"
+    @r.respond.should == '<Response><Dial><Number>1231231234</Number></Dial></Response>'
+  end
+  
+  it "add attribute" do
+    @r = Twilio::Dial.new
+    @r.set :crazy => 'delicious'
+    @r.respond.should == '<Dial crazy="delicious"></Dial>'
+  end
+  
+  it "bad append" do
+    verb = Twilio::Dial.new
+    lambda {verb.append(Twilio::Response)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Say)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Play)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Gather)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Record)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Redirect)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Hangup)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Pause)}.should raise_error(ArgumentError)     
+  end
+
+end
+
+describe Twilio::Gather do
+  include AccountExampleHelperMethods
+  
+  it "should redirect" do
+    @r = Twilio::Response.new
+    @r.append(Twilio::Gather.new("1231231234"))
+    @r.respond.should == '<Response><Gather>1231231234</Gather></Response>'
+  end
+ 
+  it "convenience: should Hangup to a url via POST" do 
+    @r = Twilio::Response.new
+    @r.addGather
+    @r.respond.should == '<Response><Gather></Gather></Response>'
+  end 
+
+  it "add a number to a Gather" do
+    @r = Twilio::Response.new
+    @g = @r.append(Twilio::Gather.new)
+    @g.append(Twilio::Say.new("Hello World"))
+    @g.append(Twilio::Play.new("Hello World.mp3"))
+    @g.append(Twilio::Pause.new)
+    @r.respond.should == '<Response><Gather><Say>Hello World</Say><Play>Hello World.mp3</Play><Pause></Pause></Gather></Response>'
+  end
+  
+  it "convenience: add a number to a Gather" do
+    @r = Twilio::Response.new
+    @g = @r.addGather
+    @g.addSay "Hello World"
+    @g.addPlay "Hello World.mp3"
+    @g.addPause
+    @r.respond.should == '<Response><Gather><Say>Hello World</Say><Play>Hello World.mp3</Play><Pause></Pause></Gather></Response>'
+  end
+  
+  it "add attribute" do
+    @r = Twilio::Gather.new
+    @r.set :crazy => 'delicious'
+    @r.respond.should == '<Gather crazy="delicious"></Gather>'
+  end
+  
+  it "bad append" do
+    verb = Twilio::Gather.new
+    lambda {verb.append(Twilio::Response)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Gather)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Record)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Redirect)}.should raise_error(ArgumentError)
+    lambda {verb.append(Twilio::Hangup)}.should raise_error(ArgumentError)   
+  end
+
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: Derferman-twilio
+version: !ruby/object:Gem::Version 
+  version: 0.1.3
+platform: ruby
+authors: 
+- Kyle Conroy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-16 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: builder
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.1.2
+    version: 
+description: 
+email: kjconroy@twilio.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- LICENSE
+- README
+- Changelog
+- example-rest.rb
+- example-twiml.rb
+- lib/twilio.rb
+- Rakefile
+has_rdoc: true
+homepage: http://www.twilio.com/docs
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Some description
+test_files: 
+- tests/response_spec.rb