twilio-ruby 5.0.0.alpha1 → 5.0.0.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6d09816b8cc4558f6b9e3b8799864f95d3b4fbe4
-  data.tar.gz: cbe0ae7b342889dc9093f58f1f0e101f728f6f7b
+  metadata.gz: fb762ca9b2729b1a17750cb9eb553ebad51d0af5
+  data.tar.gz: 65cf6849892c3cbd2acc402262cd3be3c37cc8fa
 SHA512:
-  metadata.gz: b3d3e1f15445971626ab9a51f4b82876d215edf95e0f0e5644108d78401d47bd991bd7739d3c056ad0dc1f7ba88f4f397f973f826e56aabdaae5007b892cdf51
-  data.tar.gz: c15f00871196b0b30cbdde781498f484afaddeba33214037fa4b7b63277c355244e8052b73e33ae6f6c2a27ef648f421cf6637a64bdb21b59fe4a3ae18ea0598
+  metadata.gz: a794fa07fe3597d7445b0b5e01157934ecf63fcd8637f418e61b0664239d8c5a324b3440e61356a6262d3714d33697dd742e391eab16f78bebaf72053a4ba036
+  data.tar.gz: 20a9fe4435fa4ba17488a168e88ffdec6cd13fa26b77b03ef3119d9dd015653382cb1079bf5a58ac61b341af84c3898057e4773c0ee128a3c6c8ffce889f5eb2

data/.travis.yml

@@ -4,10 +4,19 @@ cache: bundler
 bundler_args: --without development
 rvm:
   - ruby-head
-  - 2.4.0
-  - 2.3.0
+  - ruby
   - 2.2.0
   - 2.1.0
   - 2.0.0
+  - jruby-head
+  - jruby
+  - rbx-head
+  - rbx-2
 matrix:
   fast_finish: true
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: ruby
+    - rvm: jruby-head
+    - rvm: jruby
+    - rvm: rbx-head

data/AUTHORS.md

@@ -4,49 +4,35 @@ Authors
 A huge thanks to all of our contributors:
 
 
-- Adam Ballai 
-- Alexander Murmann & Ryan Spore 
-- Alexandre Payment 
-- Andres Jaan Tack 
-- Andrew Benton 
-- Billy Chia 
-- Brian Levine 
-- Caley Woods 
-- Carlos Diaz-Padron 
-- Connor Montgomery 
-- Doug Black 
-- Elaine Tsai 
-- Fiona Tay & Will Read 
-- Geoff Petrie 
-- Guille Carlos 
-- Jeremy Franz 
-- Jingming Niu 
-- Josh Hull 
-- Joël Franusic 
-- K Gautam Pai 
-- Karl Freeman 
-- Karthik Sirasanagandla 
-- Kevin Burke 
-- Kush Kella 
-- Kyle Conroy 
-- Leo Adamek 
-- Matt Eldridge 
-- Matt Nowack 
-- Michael Wawra 
-- Moncef Belyamani 
-- Nate Berkopec 
-- Oscar 
-- Oscar Sanchez 
-- Phil Nash 
-- Rafael Chacon 
-- Ryan Bigg 
-- Ryan Cavicchioni 
-- Ryan Spore 
-- Sam Kimbrel 
-- Senthil Ramakrishnan 
-- Tom Moor 
-- Torey Heinz 
-- Vipul A M 
-- liz rush 
-- matt 
-- vfrride 
+- Adam Ballai
+- Alexander Murmann & Ryan Spore
+- Alexandre Payment
+- Andrew Benton
+- Brian Levine
+- Caley Woods
+- Carlos Diaz-Padron
+- Connor Montgomery
+- Doug Black
+- Elaine Tsai
+- Fiona Tay & Will Read
+- Geoff Petrie
+- Guille Carlos
+- Jeremy Franz
+- Josh Hull
+- Joël Franusic
+- K Gautam Pai
+- Karl Freeman
+- Kevin Burke
+- Kyle Conroy
+- Leo Adamek
+- Oscar
+- Oscar Sanchez
+- Phil Nash
+- Rafael Chacon
+- Ryan Cavicchioni
+- Ryan Spore
+- Sam Kimbrel
+- Tom Moor
+- Torey Heinz
+- Vipul A M
+- vfrride

data/CHANGES.md

@@ -1,139 +1,16 @@
 twilio-ruby changelog
 =====================
-[2017-07-13] Version 5.0.0.alpha1
-----------------------------------
-- Moving to General Availability
-
-**Api**
-- Update `AnnounceMethod` parameter naming for consistency
-
-**Preview**
-- Add `verification_attempts` to HostedNumberOrders.
-
-
-[2017-07-07] Version 5.0.0.rc26
---------------------------------
-**Api**
-- [omit] Rachet /Keys and /SigningKeys
-
-**Preview**
-- Add `status_callback_url` and `status_callback_method` to HostedNumberOrders.
-
-
-[2017-07-06] Version 5.0.0.rc25
---------------------------------
-**Messaging**
-- Fix incorrectly typed capabilities property for PhoneNumbers.
-
-**Notify**
-- Add `ToBinding` optional parameter on Notifications resource creation. Accepted values are json strings.
-
-**Preview**
-- [omit] Enabled beta feature flag (api.vault.data-platform) for bulk_exports api
-
-**Video**
-- Filter recordings by date using the parameters `DateCreatedAfter` and `DateCreatedBefore`.
-- Override the default time-to-live of a recording's media URL through the `Ttl` parameter (in seconds, default value is 3600).
-- Add query parameters `SourceSid`, `Status`, `DateCreatedAfter` and `DateCreatedBefore` to the convenience method for retrieving Room recordings.
-
-**Wireless**
-- Added national and international data limits to the RatePlans resource.
-
-
-[2017-06-22] Version 5.0.0.rc24
--------------------------------
-- Namespaced Policy, Grants, and Scope to their respective Token.
-- Added `announce_url` and `annouce_url_method` to Conference update.
-- Added `store_media` to Fax.
-
-[2017-06-19] Version 5.0.0.rc23
--------------------------------
-- Fixed ClientCapability parameter encoded bug.
-- Optional URL parameter for TwiML Play verb. 
-
-[2017-06-15] Version 5.0.0.rc22
--------------------------------
-- Refactor JWT token constructors 
-
-
-[2017-05-24] Version 5.0.0.rc21
--------------------------------
-- Add HostedNumbers preview support.
-- Add Proxy preview support.
-- Add BulkExports preview support.
-
-[2017-05-22] Version 5.0.0.rc20
--------------------------------
-- Add Wireless Domain
-- Add Fax Domain
-- Add Video Domain
-- Updated Usage Trigger enums with missing categories.
-- Add `area_code_geomatch`, `validtiy_period`, `fallback_to_long_code` to Messaging Service
-- Converted `TwilioException` to `TwilioError`
-
-[2017-04-27] Version 5.0.0.rc19
--------------------------------
-
-- Add chat v2.
-- Wireless rate plans updates.
-- Message `ValidityPeriod` parameter.
-- New Usage API categories.
-
-Version 5.0.0.rc18
--------------------------------
-
-Release April 17, 2017
-
-- Update VideoGrant access token to accept `room` instead of `configuration_profile_sid`
-
-Version 5.0.0.rc16
--------------------------------
-
-Release September 1, 2016
-
-- Add voice grant.
-
-Version 5.0.0.rc8
--------------
-
-Release July 8, 2016
-
-- Add SMS and Facebook Messenger for Notify
-
-Version 5.0.0.rc7
--------------
-
-Release June 9, 2016
-
-- Add messaging feedback support
-
-
-Version 5.0.0.rc5
--------------
-
-Release May 31, 2016
-
-- Add preview.twilio.com/wireless support
-
-Version 5.0.0.rc4
--------------
-
-Release March 28, 2016
-
-- Add notifications.twilio.com subdomain
 
 Version 5.0.0
 -------------
 
-Release January 29, 2016
-
 - First class paging support
 - Streaming auto-paging functionality
 - Separation between strict paging and streaming, with network-efficient defaults
 - Fully configurable and swappable HTTP Client interfaces
 - Normalization of mounts -> endpoints relations, with first-class unified support for subdomains and multi-version support
 - Fixed URL pathing of subresources, preventing edge case errors with path building via mounting
-- Proper serialization/deserialization of types (integers, dates, etc.)
+- Proper serialization/deserialization of types (integers, dates, etc.) 
 
 Version 4.2.0
 -------------

data/Gemfile

@@ -3,8 +3,8 @@ source 'https://rubygems.org'
 gemspec
 
 group :test do
-  gem 'fakeweb', '~> 1.3'
-  gem 'rack', '~> 1.3'
   gem 'rake', '~> 10.1'
   gem 'rspec', '~> 3.0'
+  gem 'fakeweb', '~> 1.3'
+  gem 'rack', '~> 1.3'
 end

data/LICENSE.md

@@ -1,21 +1,21 @@
-MIT License
+Copyright (c) 2010-2014 Andrew Benton.
 
-Copyright (C) 2017, Twilio, Inc. <help@twilio.com>
+The MIT License (MIT)
 
-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:
+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 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.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Makefile

@@ -1,25 +1,12 @@
-.PHONY: test lint-changed lint
-
-CHANGED_RUBY_FILES = $(shell git status --porcelain | grep ".rb" | awk -F ' ' '{print $2}' | tr '\n' ' ')
-
 install:
-	bundle install; bundle exec rake install
+	bundle exec rake install
 
 test-install:
 	bundle install
 
-test: lint
+test:
 	bundle exec rake spec
 
-docs:
-	yard doc
-
-lint:
-	rubocop --cache true --parallel
-
 authors:
 	echo "Authors\n=======\n\nA huge thanks to all of our contributors:\n\n" > AUTHORS.md
 	git log --raw | grep "^Author: " | cut -d ' ' -f2- | cut -d '<' -f1 | sed 's/^/- /' | sort | uniq >> AUTHORS.md
-
-gem:
-	bundle exec rake build | sed -e 's/.*pkg/pkg/g' | sed -e "s/\.$$//g" | xargs gem push

data/README.md

@@ -1,9 +1,9 @@
-# twilio-ruby
-
-[![Build Status](http://img.shields.io/travis/twilio/twilio-ruby.svg)][travis]
 [![Gem Version](http://img.shields.io/gem/v/twilio-ruby.svg)][gem]
+[![Build Status](http://img.shields.io/travis/twilio/twilio-ruby.svg)][travis]
 [![Code Quality](http://img.shields.io/codeclimate/github/twilio/twilio-ruby.svg)][codeclimate]
 
+# 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]
 
 ## Installation
@@ -11,13 +11,13 @@ A module for using the Twilio REST API and generating valid [TwiML](http://www.t
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.0.0.rc26'
+gem 'twilio-ruby', '~> 5.0.0.rc2'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.0.0.rc26
+gem install twilio-ruby -v 5.0.0.rc2
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -41,7 +41,7 @@ During the Release Candidate period of this library, please leave all feedback a
 
 ### Setup Work
 
-```ruby
+``` ruby
 require 'twilio-ruby'
 
 # put your own credentials here
@@ -63,7 +63,7 @@ end
 
 ### Make a Call
 
-```ruby
+``` ruby
 @client.api.account.calls.create(
   from: '+14159341234',
   to: '+16105557069',
@@ -73,7 +73,7 @@ end
 
 ### Send an SMS
 
-```ruby
+``` ruby
 @client.api.account.messages.create(
   from: '+14159341234',
   to: '+16105557069',
@@ -82,7 +82,7 @@ end
 ```
 
 ### 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:
+twilio-ruby uses [Faraday](https://github.com/lostisland/faraday) to make HTTP requests. You can tell Twilio::REST::Client to use any of the Faraday adapters like so:
 
 ```ruby
 @client.http_client.adapter = :typhoeus
@@ -93,27 +93,25 @@ twilio-ruby uses [Faraday][faraday] to make HTTP requests. You can tell Twilio::
 If you just need to generate a Capability Token for use with Twilio Client, you
 can do this:
 
-```ruby
+``` ruby
+require 'rubygems' # not necessary with ruby 1.9 but included for completeness
 require 'twilio-ruby'
 
 # put your own account credentials here:
-account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
-auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
+account_sid = 'AC043dcf9844e13758bc3a36a84c29761'
+auth_token = '62ea81de3a5b413254eb263595357c69'
 
 # set up
-capability = Twilio::JWT::ClientCapability.new account_sid, auth_token
-
+capability = Twilio::Util::Capability.new account_sid, auth_token
 
 # allow outgoing calls to an application
-outgoingScope = Twilio::JWT::ClientCapability::OutgoingClientScope.new 'AP11111111111111111111111111111111'
-capability.add_scope(outgoingScope)
+capability.allow_client_outgoing 'AP89a0180a1a4ddf1da954efca349b7a20'
 
 # allow incoming calls to 'andrew'
-incomingScope = Twilio::JWT::ClientCapability::IncomingClientScope.new 'tom'
-capability.add_scope(incomingScope)
+capability.allow_client_incoming 'andrew'
 
 # generate the token string
-@token = capability.to_s
+@token = capability.generate
 ```
 
 There is a slightly more detailed document in the [Capability][capability]
@@ -124,23 +122,25 @@ section of the wiki.
 TwiML support is based on the [Builder][builder] library. You can construct a
 TwiML response like this:
 
-```ruby
+``` ruby
+require 'rubygems' # not necessary with ruby 1.9 but included for completeness
 require 'twilio-ruby'
 
-response = Twilio::TwiML::VoiceResponse.new do |r|
-  r.say('hello there', voice: 'alice')
-  r.dial(caller_id: '+14159992222') do |d|
-    d.client 'jenny'
+# 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'
   end
 end
 
 # print the result
-puts response.to_s
+puts response.text
 ```
 
 This will print the following (except for the whitespace):
 
-```xml
+``` xml
 <?xml version="1.0" encoding="UTF-8"?>
 <Response>
   <Say voice="alice">hello there</Say>
@@ -155,11 +155,18 @@ This will print the following (except for the whitespace):
 This library supports and is [tested against][travis] the following Ruby
 implementations:
 
-- Ruby 2.4.0
-- Ruby 2.3.0
 - Ruby 2.2.0
 - Ruby 2.1.0
 - Ruby 2.0.0
+- [JRuby][jruby]
+- [Rubinius][rubinius]
+
+## Getting help
+
+If you need help installing or using the library, please contact Twilio Support at help@twilio.com first. Twilio's Support staff are well-versed in all of the Twilio Helper Libraries, and usually reply within 24 hours.
+
+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/
@@ -171,6 +178,7 @@ implementations:
 [gem]: https://rubygems.org/gems/twilio
 [travis]: http://travis-ci.org/twilio/twilio-ruby
 [codeclimate]: https://codeclimate.com/github/twilio/twilio-ruby
+[jruby]: http://www.jruby.org
+[rubinius]: http://rubini.us
 [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