twilio-ruby 3.7.1 → 3.8.0

data/README.md

@@ -50,7 +50,7 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 @call = @client.account.calls.create(
   :from => '+14159341234',
   :to => '+18004567890',
-  :url => 'http://myapp.com/call-handler'
+  :url => 'http://example.com/call-handler'
 )
 
 # hangup a ringing call, but don't touch it if it's connected
@@ -60,7 +60,7 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 @call = @client.account.calls.get('CA386025c9bf5d6052a1d1ea42b4d16662')
 
 # redirect an in-progress call
-@call.redirect_to('http://myapp.com/call-redirect')
+@call.redirect_to('http://example.com/call-redirect')
 
 # hangup a call, no matter whether it is ringing or connected
 @call.hangup

data/examples/examples.rb

@@ -32,7 +32,7 @@ end
 @account.calls.get('CAXXXXXXX').recordings.list.each do {|r| puts r.wav}
 
 # make a new outgoing call. returns a call object just like calls.get
-@call = @account.calls.create({:from => '+14159341234', :to => '+18004567890', :url => 'http://myapp.com/call-handler'})
+@call = @account.calls.create({:from => '+14159341234', :to => '+18004567890', :url => 'http://example.com/call-handler'})
 
 # cancel the call if not already in progress
 @account.calls.get(@call.sid).update({:status => 'canceled'})
@@ -42,10 +42,10 @@ end
 @call.cancel
 
 # redirect and then terminate a call
-@account.calls.get('CA386025c9bf5d6052a1d1ea42b4d16662').update({:url => 'http://myapp.com/call-redirect'})
+@account.calls.get('CA386025c9bf5d6052a1d1ea42b4d16662').update({:url => 'http://example.com/call-redirect'})
 @account.calls.get('CA386025c9bf5d6052a1d1ea42b4d16662').update({:status => 'completed'})
 # or, use the aliases...
-@call.redirect_to('http://myapp.com/call-redirect')
+@call.redirect_to('http://example.com/call-redirect')
 @call.hangup
 
 ################ SMS MESSAGES ################
@@ -74,7 +74,7 @@ puts @account.sms.messages.get('SMXXXXXXXX').body
 @account.incoming_phone_numbers.create(:phone_number => @numbers[0].phone_number)
 
 # update an existing phone number's voice url
-@account.incoming_phone_numbers.get('PNdba508c5616a7f5e141789f44f022cc3').update({:voice_url => 'http://myapp.com/voice'})
+@account.incoming_phone_numbers.get('PNdba508c5616a7f5e141789f44f022cc3').update({:voice_url => 'http://example.com/voice'})
 
 ################ CONFERENCES  ################
 
@@ -91,3 +91,24 @@ puts @account.sms.messages.get('SMXXXXXXXX').body
 
 # and, since we're lazy loading, this would only incur one http request
 @account.conferences.get('CFbbe46ff1274e283f7e3ac1df0072ab39').participants.get('CA386025c9bf5d6052a1d1ea42b4d16662').update({:muted => 'true'})
+
+################ QUEUES ###################
+
+# create a new queue
+@queue = @account.queues.create(:friendly_name => 'MyQueue', :max_size => 50)
+
+# get a list of queues for this account
+@queues = @account.queues.list
+
+# get a particular queue and its members
+@queue = @account.queues.get("QQb6765b0458714964970a73dcaf55efd1")
+@members = @queue.members
+
+#list members
+@members.list.each do |m|
+  puts m.wait_time
+end
+
+# dequeue a particular user and run twiml at a specific url
+@member = @members.get('CA386025c9bf5d6052a1d1ea42b4d16662')
+@member.dequeue('http://myapp.com/deque')

data/lib/twilio-ruby.rb

@@ -33,6 +33,8 @@ require 'twilio-ruby/rest/available_phone_numbers/local'
 require 'twilio-ruby/rest/available_phone_numbers/toll_free'
 require 'twilio-ruby/rest/conferences'
 require 'twilio-ruby/rest/conferences/participants'
+require 'twilio-ruby/rest/queues'
+require 'twilio-ruby/rest/queues/members'
 require 'twilio-ruby/rest/recordings'
 require 'twilio-ruby/rest/transcriptions'
 require 'twilio-ruby/rest/notifications'

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

@@ -8,7 +8,7 @@ module Twilio
         resource :sandbox, :available_phone_numbers, :incoming_phone_numbers,
           :calls, :outgoing_caller_ids, :conferences, :sms, :recordings,
           :transcriptions, :notifications, :applications, :connect_apps,
-          :authorized_connect_apps
+          :authorized_connect_apps, :queues
       end
     end
   end

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

@@ -216,6 +216,7 @@ module Twilio
             raise Twilio::REST::ServerError
           end
         rescue Exception
+          raise if request.class == Net::HTTP::Post
           if retries_left > 0 then retries_left -= 1; retry else raise end
         end
         if response.body and !response.body.empty?

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

@@ -0,0 +1,12 @@
+module Twilio
+  module REST
+    class Queues < ListResource; end
+
+    class Queue < InstanceResource
+      def initialize(uri, client, params={})
+        super uri, client, params
+        resource :members
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/queues/members.rb

@@ -0,0 +1,29 @@
+module Twilio
+  module REST
+    class Members < ListResource
+      def initialize(uri, client)
+        super
+        # hard-code the json keys since members are special
+        @list_key, @instance_id_key = 'queue_members', 'call_sid'
+      end
+
+      def front
+        @instance_class.new "#{@uri}/Front", @client
+      end
+
+      def front!
+        front.refresh
+      end
+
+      def dequeue(url, method='POST')
+        front.dequeue url, method
+      end
+    end
+
+    class Member < InstanceResource
+      def dequeue(url, method='POST')
+        update :url => url, :method => method
+      end
+    end
+  end
+end

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-  VERSION = '3.7.1'
+  VERSION = '3.8.0'
 end

data/spec/rest/account_spec.rb

@@ -31,6 +31,12 @@ describe Twilio::REST::Account do
     account.conferences.instance_variable_get('@uri').should == 'someUri/Conferences'
   end
 
+  it 'should set up a queues resources object' do
+    account = Twilio::REST::Account.new('someUri', 'someClient')
+    account.respond_to?(:queues).should == true
+    account.queues.instance_variable_get('@uri').should == 'someUri/Queues'
+  end
+
   it 'should set up a sms resource object' do
     account = Twilio::REST::Account.new('someUri', 'someClient')
     account.respond_to?(:sms).should == true
@@ -54,4 +60,4 @@ describe Twilio::REST::Account do
     account.respond_to?(:notifications).should == true
     account.notifications.instance_variable_get('@uri').should == 'someUri/Notifications'
   end
-end
+end

data/spec/rest/conference_spec.rb

@@ -2,8 +2,8 @@ require 'spec_helper'
 
 describe Twilio::REST::Conference do
   it 'should set up a participants resources object' do
-    call = Twilio::REST::Conference.new('someUri', 'someClient')
-    call.respond_to?(:participants).should == true
-    call.participants.instance_variable_get('@uri').should == 'someUri/Participants'
+    conference = Twilio::REST::Conference.new('someUri', 'someClient')
+    conference.respond_to?(:participants).should == true
+    conference.participants.instance_variable_get('@uri').should == 'someUri/Participants'
   end
-end
+end

data/spec/rest/queue_spec.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: twilio-ruby
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 39
   prerelease: 
   segments: 
   - 3
-  - 7
-  - 1
-  version: 3.7.1
+  - 8
+  - 0
+  version: 3.8.0
 platform: ruby
 authors: 
 - Andrew Benton
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-08-01 00:00:00 -07:00
+date: 2012-08-09 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -168,6 +168,8 @@ files:
 - lib/twilio-ruby/rest/list_resource.rb
 - lib/twilio-ruby/rest/notifications.rb
 - lib/twilio-ruby/rest/outgoing_caller_ids.rb
+- lib/twilio-ruby/rest/queues.rb
+- lib/twilio-ruby/rest/queues/members.rb
 - lib/twilio-ruby/rest/recordings.rb
 - lib/twilio-ruby/rest/sandbox.rb
 - lib/twilio-ruby/rest/sms.rb
@@ -185,6 +187,7 @@ files:
 - spec/rest/client_spec.rb
 - spec/rest/conference_spec.rb
 - spec/rest/instance_resource_spec.rb
+- spec/rest/queue_spec.rb
 - spec/rest/recording_spec.rb
 - spec/spec_helper.rb
 - spec/util/capability_spec.rb
@@ -231,6 +234,7 @@ specification_version: 3
 summary: A simple library for communicating with the Twilio REST API, building TwiML, and generating Twilio Client Capability Tokens
 test_files: 
 - spec/spec_helper.rb
+- spec/rest/queue_spec.rb
 - spec/rest/call_spec.rb
 - spec/rest/conference_spec.rb
 - spec/rest/account_spec.rb