twilio-ruby 3.12.3 → 3.13.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    YTAxY2JmOWY5NjY3MTMyNTA1ZTVhMWE1NmMyZmIxYzI3NjNhYWVlYw==
+    ZDRmNTExMjMzZmVlZGE4ODU1OTAyMjM4YzU2ZjViYjY0ZjA5ODBiMg==
   data.tar.gz: !binary |-
-    NTQwYTVkMDFhMGUzNzAyMzE0NGQyN2U2YmJiMWQ5ZmE2NzZkZjVmNg==
+    NjhkMTg4ODMyNzU4ZjJlODU3YmZjZDJhNDkyZjI1MWMwOTlkMmNhNA==
 SHA512:
   metadata.gz: !binary |-
-    ZjY4MTY2ZmRlY2M0YzJhMzA3OTMxMTBlZmEwZjlkNzgxNWJmMTRiODQ4NDRh
-    OWUxYjEwOWQ5MDczNGI3MTEwZGM3ZmZkNWM5YzU1ZjNiY2NjZGI0ZTIwZTBl
-    N2JiOGQ1YTE5YTE0MDNkYWVjMjI3ZDRhMmQ3YzJhMmFiZGZlZDg=
+    NzMxNzNmNWViMDI5M2E3Yjk4MGUwMzRlZjhkZjY0YzQ5NGE2ODA4OTZkYjU4
+    MTA5MzdjNTk2YWU5NzgzMzYxZjZmNTZiY2Y3MmI3ZWJjNDQyYjc0MDdlMzQw
+    ODE0N2RkZTA1NzM1ZGNmYzYyMDQyMWQ2MzkzNGM0Y2Y4NDY0NzU=
   data.tar.gz: !binary |-
-    YTA2ZWZhZDdiZDRiOWYwY2MxOThjM2RlNDkyMzZjOWUyNWI0ZjI5ZTQ3Mjc3
-    NjAxOWNjMjFlNmVhMWE3OGM5YzExNTJjNWNmNGUzMDFlMGZlYTRjMTk3MGZk
-    MDNlYTUxYzkwNDRiMWVjNDY1YjY3OGVlZjU5NDAwMWMxN2YwNTU=
+    OWY4YWVhYjEzZjYwZmMwMGNhZjM2YzE3MWExZmY0YzFkZWYxZDg0MDk0ZDcw
+    NWE1MGJmNjdmZWI3MGQyNGY2M2I2NDU3NTNlY2ZmNzNhMjUwNGNlMmJhNjdj
+    NDI3OTE1ZTg1MDFkMDFmNjE0NjgxOWUzMjE1ZmU0NmI4ZjgxOGM=

data/CHANGES.md

@@ -1,6 +1,18 @@
 twilio-ruby changelog
 =====================
 
+Version 3.13.0
+--------------
+
+Released September 23, 2014
+
+- Deprecates 1.8.7 support
+- Internal code style changes including:
+    - change symbol hash syntax to Ruby 1.9 style
+    - remove curly braces from hash arguments to methods
+    - add spaces around curly braces in blocks
+    - reduces all lines to less than 80 characters
+
 Version 3.12.3
 --------------
 

data/README.md

@@ -57,9 +57,9 @@ end
 
 ``` ruby
 @client.messages.create(
-  :from => '+14159341234',
-  :to => '+16105557069',
-  :body => 'Hey there!'
+  from: '+14159341234',
+  to: '+16105557069',
+  body: 'Hey there!'
 )
 ```
 
@@ -67,10 +67,10 @@ end
 
 ``` ruby
 @client.messages.create(
-  :from => '+14159341234',
-  :to => '+16105557069',
-  :body => 'Hey there!',
-  :media_url => 'http://example.com/smileyface.jpg',
+  from: '+14159341234',
+  to: '+16105557069',
+  body: 'Hey there!',
+  media_url: 'http://example.com/smileyface.jpg'
 )
 ```
 
@@ -79,9 +79,9 @@ end
 ``` ruby
 # make a new outgoing call
 @call = @client.calls.create(
-  :from => '+14159341234',
-  :to => '+18004567890',
-  :url => 'http://example.com/call-handler',
+  from: '+14159341234',
+  to: '+18004567890',
+  url: 'http://example.com/call-handler'
 )
 
 # hangup a ringing call, but don't touch it if it's connected
@@ -109,13 +109,13 @@ end
 ``` ruby
 # print some available numbers
 @numbers = @client.available_phone_numbers.get('US').local.list(
-  :contains => 'AWESOME'
+  contains: 'AWESOME'
 )
 @numbers.each {|num| puts num.phone_number}
 
 # buy the first one
 @number = @numbers[0].phone_number
-@client.incoming_phone_numbers.create(:phone_number => @number)
+@client.incoming_phone_numbers.create(phone_number: @number)
 ```
 
 ## Getting Started With Client Capability Tokens
@@ -158,8 +158,8 @@ require 'twilio-ruby'
 
 # build up a response
 response = Twilio::TwiML::Response.new do |r|
-  r.Say 'hello there', :voice => 'alice'
-  r.Dial :callerId => '+14159992222' do |d|
+  r.Say 'hello there', voice: 'alice'
+  r.Dial callerId: '+14159992222' do |d|
     d.Client 'jenny'
   end
 end

data/Rakefile

@@ -6,5 +6,5 @@ require 'rspec/core/rake_task'
 desc 'Run all specs'
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
-task :test => :spec
+task default: :spec
+task test: :spec

data/docs/faq.rst

@@ -34,9 +34,9 @@ Then you can convert user input to phone numbers like this:
     def convert_to_e164(raw_phone)
         Phony.format(
             raw_phone,
-            :format => :international,
-            :spaces => ''
+            format: :international,
+            spaces: ''
         ).gsub(/\s+/, "") # Phony won't remove all spaces
-    end 
+    end
 
     puts convert_to_e164('212 555 1234')   # prints +12125551234

data/docs/getting-started.rst

@@ -19,8 +19,11 @@ Make a Call
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @call = @client.calls.create({:to => "9991231234", :from => "9991231234",
-        :url => "http://twimlets.com/holdmusic?Bucket=com.twilio.music.ambient"})
+    @call = @client.calls.create(
+      to: "9991231234",
+      from: "9991231234",
+      url: "http://twimlets.com/holdmusic?Bucket=com.twilio.music.ambient"
+    )
     puts @call.length
     puts @call.sid
 
@@ -38,10 +41,11 @@ Send an SMS
 
     @client = Twilio::REST::Client.new account_sid, auth_token
 
-    @message = @client.messages.create({:to => "+12316851234",
-                                       :from => "+15555555555",
-                                       :body => "Hello there!"})
-
+    @message = @client.messages.create(
+      to: "+12316851234",
+      from: "+15555555555",
+      body: "Hello there!"
+    )
 
 Send an MMS
 ===========
@@ -56,11 +60,12 @@ Send an MMS
 
     @client = Twilio::REST::Client.new account_sid, auth_token
 
-    @message = @client.messages.create({:to => "+15558676309",
-                                       :from => "+15555555555",
-                                       :body => "Jenny I need you!",
-                                       :media_url => "http://twilio.com/heart.jpg"})
-
+    @message = @client.messages.create(
+      to: "+15558676309",
+      from: "+15555555555",
+      body: "Jenny I need you!",
+      media_url: "http://twilio.com/heart.jpg"
+    )
 
 Generating TwiML
 =================
@@ -72,7 +77,7 @@ to easily create such responses.
 .. code-block:: ruby
 
     Twilio::TwiML::Response do |r|
-        r.Play "https://api.twilio.com/cowbell.mp3", :loop => 5
+        r.Play "https://api.twilio.com/cowbell.mp3", loop: 5
     end.text
 
 .. code-block:: xml

data/docs/usage/accounts.rst

@@ -28,7 +28,7 @@ Right now the only valid attribute is :attr:`friendly_name`.
 
     @client = Twilio::REST::Client.new account_sid, auth_token
     @account = @client.accounts.get(account_sid)
-    @account.update({:friendly_name => "My Awesome Account"})
+    @account.update(friendly_name: "My Awesome Account")
 
 
 Creating Subaccounts
@@ -45,7 +45,7 @@ Subaccounts are easy to make.
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @subaccount = @client.accounts.create({:name => "My Awesome SubAccount"})
+    @subaccount = @client.accounts.create(name: "My Awesome SubAccount")
 
 
 Managing Subaccounts
@@ -70,20 +70,20 @@ Client X hasn't paid you recently, so let's suspend their account.
 
 .. code-block:: ruby
 
-    @subaccount.update({:status => 'suspended'}
+    @subaccount.update(status: 'suspended')
 
 If it was just a misunderstanding, reenable their account.
 
 .. code-block:: ruby
 
-    @subaccount.update({:status => 'active'}
+    @subaccount.update(status: 'active')
 
 Otherwise, close their account permanently.
 
 .. code-block:: ruby
 
-    @subaccount.update({:status => 'closed'}
+    @subaccount.update(status: 'closed')
 
 .. warning::
-    This action can't be undone. 
+    This action can't be undone.
 

data/docs/usage/applications.rst

@@ -45,7 +45,7 @@ You can filter applications by FriendlyName
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @client.applications.list({:friendly_name => 'FOO'})}.each do |app|
+    @client.applications.list(friendly_name: 'FOO').each do |app|
         puts app.sid
     end
 
@@ -66,8 +66,9 @@ accepts many other arguments for url configuration.
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @application = @client.applications.create({:friendly_name => "My New App"})
-
+    @application = @client.applications.create(
+      friendly_name: "My New App"
+    )
 
 Updating an Application
 ------------------------
@@ -86,8 +87,7 @@ Updating an Application
     app_sid = 'AP123' # the app you'd like to update
 
     @application = @client.applications.get(app_sid)
-    @application.update({:voice_url => url})
-
+    @application.update(voice_url: url)
 
 Deleting an Application
 -------------------------

data/docs/usage/basics.rst

@@ -70,7 +70,7 @@ The following will return page 3 with page size of 25.
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-	@calls = @client.calls.list(:page=>3, :page_size=>25)
+	@calls = @client.calls.list(page: 3, page_size: 25)
 
 
 Get an Individual Resource

data/docs/usage/caller-ids.rst

@@ -19,7 +19,9 @@ Validating a phone number is quick and easy.
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @response = @client.outgoing_caller_ids.create(:phone_number => "+44 9876543212")
+    @response = @client.outgoing_caller_ids.create(
+        phone_number: "+44 9876543212"
+    )
     puts @response.validation_code
 
 Twilio will call the provided number and wait for the validation code to be
@@ -40,6 +42,6 @@ Deleting a phone number is quick and easy.
 
     @client = Twilio::REST::Client.new account_sid, auth_token
 
-    @response = @client.outgoing_caller_ids.list(:phone_number => "+15555555555")
+    @response = @client.outgoing_caller_ids.list(phone_number: "+15555555555")
     @callerid = response[0]
     @callerid.delete()

data/docs/usage/conferences.rst

@@ -43,7 +43,7 @@ will return a list of all in-progress conferences and print their friendly name.
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @conferences = @client.conferences.list({:status => "in-progress"})
+    @conferences = @client.conferences.list(status: "in-progress")
 
     @conference.each do |conference|
         puts conference.friendly_name

data/docs/usage/errors.rst

@@ -20,9 +20,9 @@ handled appropriately.
     begin
         @client = Twilio::REST::Client.new account_sid, auth_token
         client.messages.create({
-            :from => '+1234567890',
-            :to => '+1234567890',
-            :body => 'Hello world'
+            from: '+1234567890',
+            to: '+1234567890',
+            body: 'Hello world'
         })
     rescue Twilio::REST::RequestError => e
         puts e.message

data/docs/usage/messages.rst

@@ -24,9 +24,11 @@ Send a text message in only a few lines of code.
 
     @client = Twilio::REST::Client.new account_sid, auth_token
 
-    @message = @client.messages.create({:to => "+13216851234",
-                                       :from => "+15555555555",
-                                       :body => "Hello!"})
+    @message = @client.messages.create(
+      to: "+13216851234",
+      from: "+15555555555",
+      body: "Hello!"
+    )
 
 If you want to send a message from a `short code
 <http://www.twilio.com/api/sms/short-codes>`_ on Twilio, just set :attr:`from`
@@ -48,24 +50,27 @@ To send a picture, set :attr:`media_url` to the url of the picture you wish to s
 
     @client = Twilio::REST::Client.new account_sid, auth_token
 
-    @message = @client.messages.create({:to => "+15558676309",
-                                       :from => "+15555555555",
-                                       :body => "Jenny I need you!",
-                                       :media_url => "http://twilio.com/heart.jpg"})
+    @message = @client.messages.create(
+      to: "+15558676309",
+      from: "+15555555555",
+      body: "Jenny I need you!",
+      media_url: "http://twilio.com/heart.jpg"
+    )
 
 You can send multiple pictures in the same message by setting :attr:`media_url` to
 an array of urls.
 
 .. code-block:: ruby
 
-    @message = @client.messages.create({:to => "+15558676309",
-                                       :from => "+15555555555",
-                                       :body => "Jenny I need you!",
-                                       :media_url => [
-                                            "http://twilio.com/heart.jpg",
-                                            "http://twilio.com/rose.jpg"
-                                        ]})
-
+    @message = @client.messages.create(
+      to: "+15558676309",
+      from: "+15555555555",
+      body: "Jenny I need you!",
+      media_url: [
+        "http://twilio.com/heart.jpg",
+        "http://twilio.com/rose.jpg"
+      ]
+    )
 
 Retrieving Sent Messages
 -------------------------
@@ -101,7 +106,10 @@ The following will only show messages to "+5466758723" on January 1st, 2011.
 
     @client = Twilio::REST::Client.new account_sid, auth_token
 
-    @messages = @client.messages.list({:to => "+5466758723", :date_sent => "2011-01-01"})
+    @messages = @client.messages.list(
+      to: "+5466758723",
+      date_sent: "2011-01-01"
+    )
 
     @messages.each do |message|
         puts message.body

data/docs/usage/phone-calls.rst

@@ -25,9 +25,11 @@ outputs valid `TwiML <http://www.twilio.com/docs/api/twiml/>`_.
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @call = @client.calls.create({:to => "9991231234",
-                                  :from => "9991231234",
-                                  :url => "http://foo.com/call.xml"})
+    @call = @client.calls.create(
+      to: "9991231234",
+      from: "9991231234",
+      url: "http://foo.com/call.xml"
+    )
     puts @call.length
     puts @call.sid
 
@@ -89,9 +91,9 @@ However, what if you only have a `CallSid`, and not the actual
 
     @client = Twilio::REST::Client.new account_sid, auth_token
     sid = "CA24234"
-    puts @client.notifications.list({:call => sid})
-    puts @client.recordings.list({:call => sid})
-    puts @client.transcriptions.list({:call => sid})
+    puts @client.notifications.list(call: sid)
+    puts @client.recordings.list(call: sid)
+    puts @client.transcriptions.list(call: sid)
 
 
 Modifying Live Calls
@@ -109,7 +111,7 @@ redirect them as necessary
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @calls = @client.calls.list({:status => "in-progress"})
+    @calls = @client.calls.list(status: "in-progress")
 
     @calls.each do |call|
         call.redirect_to("http://twimlets.com/holdmusic?Bucket=com.twilio.music.ambient")
@@ -127,7 +129,7 @@ Ending all live calls is also possible
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @calls = @client.calls.list({:status => "in-progress"})
+    @calls = @client.calls.list(status: "in-progress")
 
     @calls.each do |call|
         call.hangup()

data/docs/usage/phone-numbers.rst

@@ -27,7 +27,7 @@ Once we find one, we'll purchase it for our account.
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    numbers = @client.available_phone_numbers.list(:area_code=>"530")
+    numbers = @client.available_phone_numbers.list(area_code: "530")
 
     if numbers:
         numbers[0].purchase()
@@ -67,13 +67,13 @@ The following example will find any phone number with "FOO" in it.
 
 .. code-block:: ruby
 
-	numbers = @client.available_phone_numbers.list(:contains=>"FOO")
+	numbers = @client.available_phone_numbers.list(contains: "FOO")
 
 You can use the ''*'' wildcard to match any character. The following example finds any phone number that matches the pattern ''D*D''.
 
 .. code-block:: ruby
 
-	numbers = @client.available_phone_numbers.list(:contains=>"D*D")
+	numbers = @client.available_phone_numbers.list(contains: "D*D")
 
 
 International Numbers
@@ -85,7 +85,7 @@ international numbers.
 
 .. code-block:: ruby
 
-	numbers = @client.available_phone_numbers.list(:country=>"FR")
+	numbers = @client.available_phone_numbers.list(country: "FR")
 
 
 :meth:`PhoneNumbers.search` method has plenty of other options to augment your search :
@@ -115,7 +115,9 @@ If you've found a phone number you want, you can purchase the number.
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @number = @client.available_phone_numbers.purchase({:phone_number => "+15305431234"})
+    @number = @client.available_phone_numbers.purchase(
+      phone_number: "+15305431234"
+    )
 
 However, it's easier to purchase numbers after finding them using search (as
 shown in the first example).
@@ -138,11 +140,13 @@ listed in the `IncomingPhoneNumbers Resource documentation
     auth_token = "YYYYYYYYYYYYYYYYYY"
 
     @client = Twilio::REST::Client.new account_sid, auth_token
-    @client.available_phone_numbers.list(api_version="2010-04-01").each do |number|
-        number.update({:voice_url => "http://twimlets.com/holdmusic?" +
-            "Bucket=com.twilio.music.ambient",
-            :status_callback => "http://example.com/callback"})
-
+    @client.available_phone_numbers.list.each do |number|
+      number.update(
+        voice_url: "http://twimlets.com/holdmusic?" \
+                   "Bucket=com.twilio.music.ambient",
+        status_callback: "http://example.com/callback"
+      )
+    end
 
 Changing Applications
 ----------------------
@@ -162,7 +166,7 @@ An :class:`Application` encapsulates all necessary URLs for use with phone numbe
     phone_sid = "PNXXXXXXXXXXXXXXXXX"
 
     @number = @client.available_phone_numbers.get(phone_sid)
-    @number.update(:sms_application_sid => "APXXXXXXXXXXXXXXXXXX")
+    @number.update(sms_application_sid: "APXXXXXXXXXXXXXXXXXX")
 
 See :doc:`/usage/applications` for instructions on updating and maintaining Applications.