twilio-ruby 3.11.5 → 5.71.0

data/README.md

@@ -1,18 +1,46 @@
-[![Build Status](https://travis-ci.org/twilio/twilio-ruby.png?branch=master)](https://travis-ci.org/twilio/twilio-ruby)
-[![Gem Version](https://badge.fury.io/rb/twilio-ruby.png)](http://badge.fury.io/rb/twilio-ruby)
-
 # twilio-ruby
 
-A module for using the Twilio REST API and generating valid
-[TwiML](http://www.twilio.com/docs/api/twiml/ "TwiML - Twilio Markup Language").
-[Click here to read the full documentation.][documentation]
+[![Tests](https://github.com/twilio/twilio-ruby/actions/workflows/test-and-deploy.yml/badge.svg)][github-actions]
+[![Gem Version](https://img.shields.io/gem/v/twilio-ruby.svg)](https://rubygems.org/gems/twilio-ruby)
+[![Learn with TwilioQuest](https://img.shields.io/static/v1?label=TwilioQuest&message=Learn%20to%20contribute%21&color=F22F46&labelColor=1f243c&style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAMAAAD04JH5AAAASFBMVEUAAAAZGRkcHBwjIyMoKCgAAABgYGBoaGiAgICMjIyzs7PJycnMzMzNzc3UoBfd3d3m5ubqrhfrMEDu7u739/f4vSb/3AD///9tbdyEAAAABXRSTlMAAAAAAMJrBrEAAAKoSURBVHgB7ZrRcuI6EESdyxXGYoNFvMD//+l2bSszRgyUYpFAsXOeiJGmj4NkuWx1Qeh+Ekl9DgEXOBwOx+Px5xyQhDykfgq4wG63MxxaR4ddIkg6Ul3g84vCIcjPBA5gmUMeXESrlukuoK33+33uID8TWeLAdOWsKpJYzwVMB7bOzYSGOciyUlXSn0/ABXTosJ1M1SbypZ4O4MbZuIDMU02PMbauhhHMHXbmebmALIiEbbbbbUrpF1gwE9kFfRNAJaP+FQEXCCTGyJ4ngDrjOFo3jEL5JdqjF/pueR4cCeCGgAtwmuRS6gDwaRiGvu+DMFwSBLTE3+jF8JyuV1okPZ+AC4hDFhCHyHQjdjPHUKFDlHSJkHQXMB3KpSwXNGJPcwwTdZiXlRN0gSp0zpWxNtM0beYE0nRH6QIbO7rawwXaBYz0j78gxjokDuv12gVeUuBD0MDi0OQCLvDaAho4juP1Q/jkAncXqIcCfd+7gAu4QLMACCLxpRsSuQh0igu0C9Svhi7weAGZg50L3IE3cai4IfkNZAC8dfdhsUD3CgKBVC9JE5ABAFzg4QL/taYPAAWrHdYcgfLaIgAXWJ7OV38n1LEF8tt2TH29E+QAoDoO5Ve/LtCQDmKM9kPbvCEBApK+IXzbcSJ0cIGF6e8gpcRhUDogWZ8JnaWjPXc/fNnBBUKRngiHgTUSivSzDRDgHZQOLvBQgf8rRt+VdBUUhwkU6VpJ+xcOwQUqZr+mR0kvBUgv6cB4+37hQAkXqE8PwGisGhJtN4xAHMzrsgvI7rccXqSvKh6jltGlrOHA3Xk1At3LC4QiPdX9/0ndHpGVvTjR4bZA1ypAKgVcwE5vx74ulwIugDt8e/X7JgfkucBMIAr26ndnB4UCLnDOqvteQsHlgX9N4A+c4cW3DXSPbwAAAABJRU5ErkJggg==)](https://twil.io/learn-open-source)
+
+## Documentation
+
+The documentation for the Twilio API can be found [here][apidocs].
+
+The Ruby library documentation can be found [here][libdocs] and individual releases [here][refdocs].
+
+## Versions
+
+`twilio-ruby` uses a modified version of [Semantic Versioning](https://semver.org) for all changes. [See this document](VERSIONS.md) for details.
+
+### Supported Ruby Versions
+
+This library supports the following Ruby implementations:
+
+* Ruby 2.4
+* Ruby 2.5
+* Ruby 2.6
+* Ruby 2.7
+* Ruby 3.0
+* Ruby 3.1
+
+### Migrating from 4.x
+
+[Upgrade Guide][upgrade]
+
+## Installation
+
+To install using [Bundler][bundler] grab the latest stable version:
 
-## Install
+```ruby
+gem 'twilio-ruby', '~> 5.71.0'
+```
 
-Via rubygems.org:
+To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby
+gem install twilio-ruby -v 5.71.0
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -23,12 +51,11 @@ cd twilio-ruby
 make install
 ```
 
-## Getting Started With REST
+## Getting Started
 
 ### Setup Work
 
-``` ruby
-require 'rubygems' # not necessary with ruby 1.9 but included for completeness
+```ruby
 require 'twilio-ruby'
 
 # put your own credentials here
@@ -39,124 +66,168 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 @client = Twilio::REST::Client.new account_sid, auth_token
 ```
 
-### Send an SMS
+### Use An API Key
 
-``` ruby
-@client.account.messages.create(
-  :from => '+14159341234',
-  :to => '+16105557069',
-  :body => 'Hey there!'
-)
+```ruby
+require 'twilio-ruby'
+
+# put your own credentials here
+account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+api_key_sid = 'zzzzzzzzzzzzzzzzzzzzzz'
+api_key_secret = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
+
+# set up a client to talk to the Twilio REST API using an API Key
+@client = Twilio::REST::Client.new api_key_sid, api_key_secret, account_sid
+```
+
+### Specify a Region and/or Edge
+
+To take advantage of Twilio's [Global Infrastructure](https://www.twilio.com/docs/global-infrastructure), specify the target Region and/or Edge for the client:
+
+```ruby
+# set up a client to talk to the Twilio REST API over a specific region and edge
+@client = Twilio::REST::Client.new account_sid, auth_token, nil, 'au1'
+@client.edge = 'sydney'
+
+# you may also specify the region and/or edge after client creation
+@client = Twilio::REST::Client.new account_sid, auth_token
+@client.region = 'au1'
+@client.edge = 'sydney'
 ```
 
-### Send an MMS
+This will result in the `hostname` transforming from `api.twilio.com` to `api.sydney.au1.twilio.com`.
+
+### Enable Debug logging
 
-``` ruby
-@client.account.messages.create(
-  :from => '+14159341234',
-  :to => '+16105557069',
-  :body => 'Hey there!',
-  :media_url => 'http://example.com/smileyface.jpg',
+In order to enable debug logging, pass in a 'logger' instance to the client with the level set to at least 'DEBUG'
+
+```ruby
+@client = Twilio::REST::Client.new account_sid, auth_token
+myLogger = Logger.new(STDOUT)
+myLogger.level = Logger::DEBUG
+@client.logger = myLogger
+
+@client = Twilio::REST::Client.new account_sid, auth_token
+myLogger = Logger.new('my_log.log')
+myLogger.level = Logger::DEBUG
+@client.logger = myLogger
+```
+
+### Make a Call
+
+```ruby
+@client.calls.create(
+  from: '+14159341234',
+  to: '+16105557069',
+  url: 'http://example.com'
 )
 ```
 
-### Do Some Stuff With Calls
+### Send an SMS
 
-``` ruby
-# make a new outgoing call
-@call = @client.account.calls.create(
-  :from => '+14159341234',
-  :to => '+18004567890',
-  :url => 'http://example.com/call-handler',
+```ruby
+@client.messages.create(
+  from: '+14159341234',
+  to: '+16105557069',
+  body: 'Hey there!'
 )
+```
 
-# hangup a ringing call, but don't touch it if it's connected
-@call.cancel
+### List your SMS Messages
 
-# if you have the call sid, you can fetch a call object via:
-@call = @client.account.calls.get('CA386025c9bf5d6052a1d1ea42b4d16662')
+```ruby
+@client.messages.list(limit: 20)
+```
 
-# redirect an in-progress call
-@call.redirect_to('http://example.com/call-redirect')
+### Fetch a single SMS message by Sid
 
-# hangup a call, no matter whether it is ringing or connected
-@call.hangup
+```ruby
+# put the message sid you want to retrieve here:
+message_sid = 'SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+@client.messages(message_sid).fetch
 ```
 
-### List Calls after a certain time
+### Customizing your HTTP Client
+
+`twilio-ruby` uses [Faraday][faraday] to make HTTP requests. You can tell `Twilio::REST::Client` to use any of the Faraday adapters like so:
 
-``` ruby
-# list calls made or received on or after May 13, 2013
-@client.account.calls.list("start_time>" => "2013-05-13") # Notice we omit the "=" in the "start_time>=" parameter because it is automatically added
+```ruby
+@client.http_client.adapter = :typhoeus
 ```
 
-### Buy a Phone Number
+To use a custom HTTP client with this helper library, please see the [Twilio documentation](https://www.twilio.com/docs/libraries/ruby/custom-http-clients).
 
-``` ruby
-# print some available numbers
-@numbers = @client.account.available_phone_numbers.get('US').local.list(
-  :contains => 'AWESOME'
-)
-@numbers.each {|num| puts num.phone_number}
+To apply customizations such as middleware, you can use the `configure_connection` method like so:
 
-# buy the first one
-@number = @numbers[0].phone_number
-@client.account.incoming_phone_numbers.create(:phone_number => @number)
+```ruby
+@client.http_client.configure_connection do |faraday|
+  faraday.use SomeMiddleware
+end
 ```
 
-## Getting Started With Client Capability Tokens
+### Handling Errors
+
+```ruby
+begin
+  messages = @client.messages.list(limit: 20)
+rescue Twilio::REST::RestError => e
+  puts e.message
+end
+```
+
+For more descriptive exception types, please see the [Twilio documentation](https://www.twilio.com/docs/libraries/ruby/usage-guide#error-handling).
+
+### Getting Started With Client Capability Tokens
 
-If you just need to generate a Capability Token for use with Twilio Client, you
-can do this:
+If you just need to generate a Capability Token for use with Twilio Client, you can do this:
 
-``` ruby
-require 'rubygems' # not necessary with ruby 1.9 but included for completeness
+```ruby
 require 'twilio-ruby'
 
 # put your own account credentials here:
-account_sid = 'AC043dcf9844e13758bc3a36a84c29761'
-auth_token = '62ea81de3a5b413254eb263595357c69'
+account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 
 # set up
-capability = Twilio::Util::Capability.new account_sid, auth_token
+capability = Twilio::JWT::ClientCapability.new account_sid, auth_token
 
 # allow outgoing calls to an application
-capability.allow_client_outgoing 'AP89a0180a1a4ddf1da954efca349b7a20'
+outgoing_scope = Twilio::JWT::ClientCapability::OutgoingClientScope.new 'AP11111111111111111111111111111111'
+capability.add_scope(outgoing_scope)
 
 # allow incoming calls to 'andrew'
-capability.allow_client_incoming 'andrew'
+incoming_scope = Twilio::JWT::ClientCapability::IncomingClientScope.new 'andrew'
+capability.add_scope(incoming_scope)
 
 # generate the token string
-@token = capability.generate
+@token = capability.to_s
 ```
 
-There is a slightly more detailed document in the [Capability][capability]
-section of the wiki.
+There is a slightly more detailed document in the [Capability][capability] section of the wiki.
+
+### Generating TwiML
 
-## Getting Started With TwiML
+To control phone calls, your application needs to output [TwiML][twiml].
 
-TwiML support is based on the [builder][builder] library. You can construct a
-TwiML response like this:
+You can construct a TwiML response like this:
 
-``` ruby
-require 'rubygems' # not necessary with ruby 1.9 but included for completeness
+```ruby
 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|
-    d.Client 'jenny'
+response = Twilio::TwiML::VoiceResponse.new do |r|
+  r.say(message: 'hello there', voice: 'alice')
+  r.dial(caller_id: '+14159992222') do |d|
+    d.client 'jenny'
   end
 end
 
 # print the result
-puts response.text
+puts response.to_s
 ```
 
 This will print the following (except for the whitespace):
 
-```
+```xml
 <?xml version="1.0" encoding="UTF-8"?>
 <Response>
   <Say voice="alice">hello there</Say>
@@ -166,16 +237,26 @@ This will print the following (except for the whitespace):
 </Response>
 ```
 
-## More Information
+## Docker Image
+
+The `Dockerfile` present in this repository and its respective `twilio/twilio-ruby` Docker image are currently used by Twilio for testing purposes only.
+
+## Getting help
 
-There are more detailed examples in the included [examples][examples]
-directory.
+If you need help installing or using the library, please check the [Twilio Support Help Center](https://support.twilio.com) first, and [file a support ticket](https://twilio.com/help/contact) if you don't find an answer to your question.
 
-The [upgrade guide][upgrade] is available in the [twilio-ruby github wiki][wiki].
+If you've instead found a bug in the library or would like new features added, go ahead and open issues or pull requests against this repo!
 
-[capability]:https://github.com/twilio/twilio-ruby/wiki/Capability
-[builder]:http://builder.rubyforge.org/
-[examples]:https://github.com/twilio/twilio-ruby/blob/master/examples
-[documentation]:http://twilio-ruby.readthedocs.org/en/latest
-[upgrade]:https://github.com/twilio/twilio-ruby/wiki/UpgradeGuide
-[wiki]:https://github.com/twilio/twilio-ruby/wiki
+[apidocs]: https://www.twilio.com/docs/api
+[twiml]: https://www.twilio.com/docs/api/twiml
+[libdocs]: https://www.twilio.com/docs/libraries/ruby
+[refdocs]: https://twilio.github.io/twilio-ruby
+[capability]: https://github.com/twilio/twilio-ruby/wiki/JWT-Tokens
+[wiki]: https://github.com/twilio/twilio-ruby/wiki
+[bundler]: https://bundler.io
+[rubygems]: https://rubygems.org
+[gem]: https://rubygems.org/gems/twilio
+[github-actions]: https://github.com/twilio/twilio-ruby/actions/workflows/test-and-deploy.yml
+[upgrade]: https://github.com/twilio/twilio-ruby/wiki/Ruby-Version-5.x-Upgrade-Guide
+[issues]: https://github.com/twilio/twilio-ruby/issues
+[faraday]: https://github.com/lostisland/faraday

data/Rakefile

@@ -1,12 +1,10 @@
-require 'rubygems'
-require 'rubygems/package_task'
-require 'rspec/core/rake_task'
-
-spec = eval(File.read('twilio-ruby.gemspec'))
+require 'bundler'
+Bundler.setup
+Bundler::GemHelper.install_tasks
 
-Gem::PackageTask.new(spec) do |p|
-  p.gem_spec = spec
-end
+require 'rspec/core/rake_task'
+desc 'Run all specs'
+RSpec::Core::RakeTask.new(:spec)
 
-RSpec::Core::RakeTask.new
-task :default => :spec
+task default: :spec
+task test: :spec

data/UPGRADE.md

@@ -0,0 +1,30 @@
+# Upgrade Guide
+
+_After `5.0.0` all `MINOR` and `MAJOR` version bumps will have upgrade notes
+posted here._
+
+[2017-09-29] 5.x.x to 5.3.x
+---------------------------
+
+### CHANGED - `Body` parameter on Chat `Message` creation is no longer required.
+
+#### Rationale
+This was changed to add support for sending media in Chat messages, users can now either provide a `body` or a `media_sid`.
+
+#### 5.x.x
+```ruby
+require 'twilio-ruby'
+
+@client = Twilio::REST::Client.new "AC123", "auth"
+@client.chat.v2.service('IS123').channel('CH123').message.create("this is the body", "from")
+```
+
+#### 5.3.x
+```ruby
+require 'twilio-ruby'
+
+@client = Twilio::REST::Client.new "AC123", "auth"
+@client.chat.v2.service('IS123').channel('CH123').message.create("from", body:"this is the body")
+```
+
+

data/VERSIONS.md

@@ -0,0 +1,35 @@
+# Versioning Strategy
+
+`twilio-ruby` uses a modified version of [Semantic Versioning][semver] for
+all changes to the helper library. It is strongly encouraged that you pin at
+least the major version and potentially the minor version to avoid pulling in
+breaking changes.
+
+Semantic Versions take the form of `MAJOR.MINOR.PATCH`
+
+When bugs are fixed in the library in a backwards-compatible way, the `PATCH`
+level will be incremented by one. When new features are added to the library
+in a backwards-compatible way, the `PATCH` level will be incremented by one.
+`PATCH` changes should _not_ break your code and are generally safe for upgrade.
+
+When a new large feature set comes online or a small breaking change is
+introduced, the `MINOR` version will be incremented by one and the `PATCH`
+version reset to zero. `MINOR` changes _may_ require some amount of manual code
+change for upgrade. These backwards-incompatible changes will generally be
+limited to a small number of function signature changes.
+
+The `MAJOR` version is used to indicate the family of technology represented by
+the helper library. Breaking changes that require extensive reworking of code
+will cause the `MAJOR` version to be incremented by one, and the `MINOR` and
+`PATCH` versions will be reset to zero. Twilio understands that this can be very
+disruptive, so we will only introduce this type of breaking change when
+absolutely necessary. New `MAJOR` versions will be communicated in advance with
+`Release Candidates` and a schedule.
+
+## Supported Versions
+
+Only the current `MAJOR` version of `twilio-ruby` is supported. New
+features, functionality, bug fixes, and security updates will only be added to
+the current `MAJOR` version.
+
+[semver]: https://semver.org

data/examples/examples.rb

@@ -1,124 +1,137 @@
-# examples version 3
+# examples version
 
-@account_sid = 'AC043dcf9844e04758bc3a36a84c29761'
-@auth_token = '62ea81de3a5b414154eb263595357c69'
+@account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+@auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 # set up a client
 @client = Twilio::REST::Client.new(@account_sid, @auth_token)
 
 ################ ACCOUNTS ################
 
 # shortcut to grab your account object (account_sid is inferred from the client's auth credentials)
-@account = @client.account 
+@account = @client.api.account
 
 # list your (sub)accounts
-@client.accounts.list
+@accounts = @client.api.accounts.each do |account|
+  puts(account)
+end
 
 # grab an account instance resource if you know the sid
-@account = @client.accounts.get(@account_sid)
-# http round trip happens here
-puts @account.friendly_name
+@account = @client.api.accounts(account_sid).fetch
+puts(@account.friendly_name)
 
 # update an account's friendly name
-@client.accounts.get(@account_sid).update(:friendly_name => 'A Fabulous Friendly Name')
+@client.api.accounts(account_sid).update(friendly_name: 'A Fabulous Friendly Name')
 
 ################ CALLS ################
 
 # print a list of calls (all parameters optional)
-@account.calls.list({:page => 0, :page_size => 1000, :start_time => '2010-09-01'}).each do |call|
+@client.calls.list(limit: 10, start_time: '2010-09-01').each do |call|
   puts call.sid
 end
 
 # get a particular call and list its recording urls
-@account.calls.get('CAXXXXXXX').recordings.list.each do |r|
+@client.calls('CAXXXXXXX').recordings.each do |r|
   puts r.wav
 end
 
 # make a new outgoing call. returns a call object just like calls.get
-@call = @account.calls.create({:from => '+14159341234', :to => '+18004567890', :url => 'http://example.com/call-handler'})
+@call = @client.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'})
-# or equivalently
-@call.update({:status => 'canceled'})
-# or simply
-@call.cancel
+@client.calls(@call.sid).update(status: 'canceled')
 
 # redirect and then terminate a call
-@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://example.com/call-redirect')
-@call.hangup
+@call = client.calls('CAXXXXXXX')
+@call.update(url: 'http://example.com/call-redirect')
+@call.update(status: 'completed')
 
 ################ SMS MESSAGES ################
 
-# print a list of messages
-@account.messages.list({:date_sent => '2010-09-01'}).each do |message|
-  puts message.body
+@client.messages.list(date_sent: '2010-09-01').each do |message|
+  puts message.date_created
 end
 
 # print a particular sms message
-puts @account.messages.get('SMXXXXXXXX').body
+puts @client.messages('SMXXXXXXXX').fetch.body
 
 # send an sms
-@account.messages.create(:from => '+14159341234', :to => '+16105557069', :body => 'Hey there!')
+@client.messages.create(
+  from: '+14159341234',
+  to: '+16105557069',
+  body: 'Hey there!'
+)
 
 # send an mms
-@account.messages.create(:from => '+14159341234', :to => '+16105557069', :media_urls => 'http://example.com/media.png')
+@client.messages.create(
+  from: '+14159341234',
+  to: '+16105557069',
+  media_url: 'http://example.com/media.png'
+)
 
 ################ PHONE NUMBERS ################
 
 # get a list of supported country codes
-@account.available_phone_numbers.list
+@client.available_phone_numbers.list
 
 # print some available numbers
-@numbers = @account.available_phone_numbers.get('US').local.list({:contains => 'AWESOME'})
-@numbers.each {|num| puts num.phone_number}
+@client.available_phone_numbers('US').local.list.each do |num|
+  puts num
+end
+
+@numbers = @client.available_phone_numbers('US').local.list(area_code: '908')
+@numbers.each { |num| puts num.phone_number }
 
 # buy the first one
-@account.incoming_phone_numbers.create(:phone_number => @numbers[0].phone_number)
+@client.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://example.com/voice'})
+@client.incoming_phone_numbers('PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx').update(voice_url: 'http://example.com/voice')
 
 # decommission an existing phone number
-numbers = @account.incoming_phone_numbers.list(:friendly_name => 'A Fabulous Friendly Name') 
-numbers[0].delete
+numbers = @client.incoming_phone_numbers.list(friendly_name: 'A Fabulous Friendly Name')
+number = numbers[0].sid
+@client.incoming_phone_numbers(number).delete
+
 ################ CONFERENCES  ################
 
 # get a particular conference's participants object and stash it
-@participants = @account.conferences.get('CFbbe46ff1274e283f7e3ac1df0072ab39').participants
+conference = @client.conferences('CFxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx').fetch
+@participants = conference.participants
 
 # list participants
-@participants.list.each do |p|
+@participants.each do |p|
   puts p.sid
 end
 
 # update a conference participant
-@participants.get('CA386025c9bf5d6052a1d1ea42b4d16662').update({:muted => 'true'})
-# or an easier way
-@participants.get('CA386025c9bf5d6052a1d1ea42b4d16662').mute
-
-# and, since we're lazy loading, this would only incur one http request
-@account.conferences.get('CFbbe46ff1274e283f7e3ac1df0072ab39').participants.get('CA386025c9bf5d6052a1d1ea42b4d16662').update({:muted => 'true'})
+@client
+  .conferences('CFxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx')
+  .participants('CAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx')
+  .update(muted: 'true')
 
 ################ QUEUES ###################
 
 # create a new queue
-@queue = @account.queues.create(:friendly_name => 'MyQueue', :max_size => 50)
+@queue = @client.queues.create(friendly_name: 'MyQueue', max_size: 50)
 
 # get a list of queues for this account
-@queues = @account.queues.list
+@queues = @client.queues.list
 
 # get a particular queue and its members
-@queue = @account.queues.get("QQb6765b0458714964970a73dcaf55efd1")
+@queue = @client.queues('QQxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx').fetch
 @members = @queue.members
 
-#list 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')
+@client
+  .queues('QQxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx')
+  .members('CAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx')
+  .update(url: 'http://myapp.com/deque', method: 'POST')

data/examples/{print-call-log.rb → print_call_log.rb}

@@ -1,4 +1,3 @@
-require 'rubygems'
 require 'twilio-ruby'
 
 # print a list of all phone calls, what phone number each was to/from, and how
@@ -7,18 +6,19 @@ require 'twilio-ruby'
 # put your Twilio credentials here. you can find your AccountSid and AuthToken
 # at the top of your account dashboard page located at:
 #   https://www.twilio.com/user/account
-account_sid = 'AC043dcf9844e04758bc3a36a84c29761'
-auth_token = '62ea81de3a5b414154eb263595357c69'
+account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 
 # set up a client
 client = Twilio::REST::Client.new(account_sid, auth_token)
 
-calls = client.account.calls.list
+calls = client.calls.list
 
-begin
+loop do
   calls.each do |call|
     price = call.price || '0.00' # since apparently prices can be nil...
-    puts call.sid + "\t" + call.from + "\t" + call.to + "\t" + price
+    puts call.sid + "\t" + call.from + "\t" + call.to + "\t" + price.to_s
   end
   calls = calls.next_page
-end while not calls.empty?
+  break if calls.nil?
+end

data/githooks/pre-commit

@@ -0,0 +1 @@
+make test