twilio-ruby 4.4.0 → 4.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ecb07fd26a80b320199741a2ce2c188331969654
-  data.tar.gz: 1dbdea6628f1a8f9f7bda6fd25d28b7ec30a4884
+  metadata.gz: 5c7218785a4a8f89282d46a51699076d4fc7e5a3
+  data.tar.gz: e7e159586b45af05889de6c68d92442f29cabff0
 SHA512:
-  metadata.gz: 624f9abd8990248bea0fdbb3fc7a235cddd6ff0edbe197237dc6b048dea14a052a3200f237acaea47754b72f7d8b4e95dfafc274a48c7dc5bc145ded3b071726
-  data.tar.gz: 5fb8fe1662af3af16b1efc90eb746ca78aa6a96d7eff2568574ffc23725e51518913367e2858ae9c028479845eec5332db3ccdaee6eb180493ea0f0306b5e2c7
+  metadata.gz: 01719027a188f42cfc14c6ed04b326eaaf7099bd6ac80a56072d06c5ffc60219b98c3a1df7848fc326129332042aff183823a871b922f69102fa6ed73e73df4a
+  data.tar.gz: 391720c612c6f76393cbbe82e30938311251df72c551db2b9679a6b483450c351043126a5b92247a8b5c90f5465bb58c4c2a5384d2a10558a7e30cda37aeb397

data/CHANGES.md

@@ -1,6 +1,91 @@
 twilio-ruby changelog
 =====================
 
+Version 4.13.0
+--------------
+
+Released September 19, 2016:
+
+- Add VideoGrant.
+
+Version 4.12.1
+--------------
+
+Released September 1, 2016:
+
+- Add VoiceGrant.
+
+Version 4.11.1
+-------------
+
+Released February 12, 2016:
+
+- Add missing Keys mount to Account
+
+Version 4.11.0
+-------------
+
+Released January 28, 2016:
+
+- Add support for alternative auth (eg. Keys)
+
+Version 4.10.0
+-------------
+
+Released January 28, 2016:
+
+- Add support for filter_friendly_name in WorkflowConfig
+- Load reservations by default in TaskRouter
+
+Version 4.9.1
+-------------
+
+Release January 28, 2016
+
+- Fix ip messaging first person grant
+
+Version 4.9.0
+-------------
+
+Release December 17, 2015
+
+- Release ip messaging
+
+Version 4.8.0
+-------------
+
+Release December 8, 2015
+
+- Make nbf optional
+
+Version 4.7.0
+-------------
+
+Release December 3, 2015
+
+- Add access tokens
+
+Version 4.6.2
+-------------
+
+Release November 19, 2015
+
+- Fix Pricing Messages
+
+Version 4.6.1
+-------------
+
+Release November 10, 2015
+
+- Fix TrunkingClient references
+
+Version 4.6.0
+-------------
+
+Release October 28, 2015
+
+- Add /Keys endpoint
+
 Version 4.4.0
 -------------
 

data/Makefile

@@ -10,3 +10,6 @@ test:
 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
+
+deploy:
+	bundle exec rake build | sed -e 's/.*pkg/pkg/g' | sed -e "s/\.$$//g" | xargs gem push

data/README.md

@@ -11,7 +11,7 @@ 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', '~> 4.2.1'
+gem 'twilio-ruby', '~> 4.11.1'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:

data/issue_template.md

@@ -0,0 +1,25 @@
+*Note: These issues are for bugs and feature requests for the helper libraries. If you need help or support, please email help@twilio.com and one of our experts will assist you!*
+
+
+**Version:**
+**API Subdomain (api/taskrouter/ip_messaging):**
+
+### Code Snippet
+```ruby
+# paste code here
+```
+
+### Exception / Log
+```
+<place exception / log here>
+```
+
+### Steps to Reproduce
+1.
+2.
+3.
+
+
+### Feature Request
+_If this is a feature request, make sure you search Issues for an existing request before creating a new one!_
+

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

@@ -9,7 +9,7 @@ module Twilio
           :calls, :outgoing_caller_ids, :conferences, :sms, :recordings,
           :transcriptions, :notifications, :applications, :connect_apps,
           :authorized_connect_apps, :queues, :usage, :messages, :media, :sip,
-          :tokens, :addresses
+          :tokens, :addresses, :keys
       end
     end
   end

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

@@ -26,8 +26,9 @@ module Twilio
         options[:host] ||= self.class.host
         @config = Twilio::Util::ClientConfig.new options
 
-        @account_sid = args[0] || Twilio.account_sid
+        @username = args[0] || Twilio.account_sid
         @auth_token = args[1] || Twilio.auth_token
+        @account_sid = (args.size > 2 && args[2].is_a?(String) ? args[2] : args[0]) || Twilio.account_sid
         if @account_sid.nil? || @auth_token.nil?
           raise ArgumentError, 'Account SID and auth token are required'
         end
@@ -49,7 +50,7 @@ module Twilio
           # build the full path unless already given
           path = build_full_path(path, params, method) unless args[1]
           request = method_class.new(path, HTTP_HEADERS)
-          request.basic_auth(@account_sid, @auth_token)
+          request.basic_auth(@username, @auth_token)
           request.form_data = params if [:post, :put].include?(method)
           connect_and_send(request)
         end

data/lib/twilio-ruby/rest/ip-messaging/channels.rb

@@ -0,0 +1,15 @@
+module Twilio
+  module REST
+    module IpMessaging
+      class Channels < NextGenListResource; end
+      class Channel < InstanceResource
+        def initialize(path, client, params={})
+          super
+          @submodule = :IpMessaging
+          resource :messages,
+                   :members
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/ip-messaging/credentials.rb

@@ -0,0 +1,19 @@
+module Twilio
+  module REST
+    module IpMessaging
+      class Credentials < NextGenListResource
+        def initialize(path, client)
+          @path, @client = path, client
+          @submodule = :IpMessaging
+        end
+      end
+
+      class Credential < InstanceResource
+        def initialize(path, client, params={})
+          super
+          @submodule = :IpMessaging
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/ip-messaging/members.rb

@@ -0,0 +1,8 @@
+module Twilio
+  module REST
+    module IpMessaging
+      class Members < NextGenListResource; end
+      class Member < InstanceResource; end
+    end
+  end
+end

data/lib/twilio-ruby/rest/ip-messaging/messages.rb

@@ -0,0 +1,8 @@
+module Twilio
+  module REST
+    module IpMessaging
+      class Messages < NextGenListResource; end
+      class Message < InstanceResource; end
+    end
+  end
+end

data/lib/twilio-ruby/rest/ip-messaging/roles.rb

@@ -0,0 +1,8 @@
+module Twilio
+  module REST
+    module IpMessaging
+      class Roles < NextGenListResource; end
+      class Role < InstanceResource; end
+    end
+  end
+end

data/lib/twilio-ruby/rest/ip-messaging/services.rb

@@ -0,0 +1,17 @@
+module Twilio
+  module REST
+    module IpMessaging
+      class Services < NextGenListResource; end
+
+      class Service < InstanceResource
+        def initialize(path, client, params={})
+          super
+          @submodule = :IpMessaging
+          resource :channels,
+                   :users,
+                   :roles
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/ip-messaging/users.rb

@@ -0,0 +1,8 @@
+module Twilio
+  module REST
+    module IpMessaging
+      class Users < NextGenListResource; end
+      class User < InstanceResource; end
+    end
+  end
+end

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

@@ -0,0 +1,100 @@
+require 'twilio-ruby/rest/base_client'
+module Twilio
+  module REST
+    class IpMessagingClient < BaseClient
+      API_VERSION = 'v1'
+
+      attr_reader :services, :credentials
+
+      host 'ip-messaging.twilio.com'
+
+      ##
+      # Instantiate a new HTTP Conversations client to talk to Twilio. The parameters
+      # +account_sid+, +auth_token+ are required, unless you have configured
+      # them already using the block configure syntax, and used to generate the
+      # HTTP basic auth header in each request. The +options+ parameter is a
+      # hash of connection configuration options. the following keys are
+      # supported:
+      #
+      # === <tt>host: 'ip-messaging.twilio.com'</tt>
+      #
+      # The domain to which you'd like the client to make HTTP requests. Useful
+      # for testing. Defaults to 'ip-messaging.twilio.com'.
+      #
+      # === <tt>port: 443</tt>
+      #
+      # The port on which to connect to the above domain. Defaults to 443 and
+      # should be left that way except in testing environments.
+      #
+      # === <tt>use_ssl: true</tt>
+      #
+      # Declare whether ssl should be used for connections to the above domain.
+      # Defaults to true and should be left alone except when testing.
+      #
+      # === <tt>ssl_verify_peer: true</tt>
+      #
+      # Declare whether to verify the host's ssl cert when setting up the
+      # connection to the above domain. Defaults to true, but can be turned off
+      # to avoid ssl certificate verification failures in environments without
+      # the necessary ca certificates.
+      #
+      # === <tt>ssl_ca_file: '/path/to/ca/file'</tt>
+      #
+      # Specify the path to the certificate authority bundle you'd like to use
+      # to verify Twilio's SSL certificate on each request. If not specified, a
+      # certificate bundle extraced from Firefox is packaged with the gem and
+      # used by default.
+      #
+      # === <tt>timeout: 30</tt>
+      #
+      # Set the time in seconds to wait before timing out the HTTP request.
+      # Defaults to 30 seconds. If you aren't fetching giant pages of call or
+      # SMS logs you can safely decrease this to something like 3 seconds or
+      # lower. In paricular if you are sending SMS you can set this to 1 second
+      # or less and swallow the exception if you don't care about the response.
+      #
+      # === <tt>proxy_addr: 'proxy.host.domain'</tt>
+      #
+      # The domain of a proxy through which you'd like the client to make HTTP
+      # requests. Defaults to nil.
+      #
+      # === <tt>proxy_port: 3128</tt>
+      #
+      # The port on which to connect to the above proxy. Defaults to nil.
+      #
+      # === <tt>proxy_user: 'username'</tt>
+      #
+      # The user name to use for authentication with the proxy. Defaults to nil.
+      #
+      # === <tt>proxy_pass: 'password'</tt>
+      #
+      # The password to use for authentication with the proxy. Defaults to nil.
+      #
+      # === <tt>retry_limit: 1</tt>
+      #
+      # The number of times to retry a request that has failed before throwing
+      # an exception. Defaults to one.
+      def inspect # :nodoc:
+        "<Twilio::REST::IpMessagingClient @account_sid=#{@account_sid}>"
+      end
+
+      protected
+
+      ##
+      # Create subresource properties
+      def set_up_subresources # :doc:
+        @services = Twilio::REST::IpMessaging::Services.new "/#{API_VERSION}/Services", self
+        @credentials = Twilio::REST::IpMessaging::Credentials.new "/#{API_VERSION}/Credentials", self
+      end
+
+      ##
+      # Builds up full request path
+      def build_full_path(path, params, method)
+        path = path.dup
+        path << "?#{url_encode(params)}" if method == :get && !params.empty?
+        path
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,6 @@
+module Twilio
+  module REST
+    class Keys < ListResource; end
+    class Key < InstanceResource; end
+  end
+end

data/lib/twilio-ruby/rest/pricing/messaging.rb

@@ -0,0 +1,15 @@
+module Twilio
+  module REST
+    module Pricing
+      class Messaging < InstanceResource
+
+        def initialize(path, client, params={})
+          super
+          @submodule = :Pricing
+          resource :countries
+        end
+
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/pricing/voice.rb

@@ -1,6 +1,3 @@
-require 'twilio-ruby/rest/pricing/countries'
-require 'twilio-ruby/rest/pricing/voice/numbers'
-
 module Twilio
   module REST
     module Pricing

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

@@ -1,7 +1,4 @@
 require 'twilio-ruby/rest/base_client'
-require 'twilio-ruby/rest/pricing'
-require 'twilio-ruby/rest/pricing/voice'
-require 'twilio-ruby/rest/pricing/phone_numbers'
 
 module Twilio
   module REST
@@ -11,7 +8,7 @@ module Twilio
 
       API_VERSION = 'v1'
 
-      attr_reader :voice, :phone_numbers
+      attr_reader :voice, :phone_numbers, :messaging
 
       host 'pricing.twilio.com'
 
@@ -96,6 +93,7 @@ module Twilio
       def set_up_subresources # :doc:
         @voice = Twilio::REST::Pricing::Voice.new "/#{API_VERSION}/Voice", self
         @phone_numbers = Twilio::REST::Pricing::PhoneNumbers.new "/#{API_VERSION}/PhoneNumbers", self
+        @messaging = Twilio::REST::Pricing::Messaging.new "/#{API_VERSION}/Messaging", self
       end
 
       ##

data/lib/twilio-ruby/rest/trunking/credential_lists.rb

@@ -0,0 +1,8 @@
+module Twilio
+  module REST
+    module Trunking
+      class CredentialLists < NextGenListResource; end
+      class CredentialList < InstanceResource; end
+    end
+  end
+end

data/lib/twilio-ruby/rest/trunking/ip_access_control_lists.rb

@@ -0,0 +1,8 @@
+module Twilio
+  module REST
+    module Trunking
+      class IpAccessControlLists < NextGenListResource; end
+      class IpAccessControlList < InstanceResource; end
+    end
+  end
+end

data/lib/twilio-ruby/rest/trunking/origination_urls.rb

@@ -0,0 +1,8 @@
+module Twilio
+  module REST
+    module Trunking
+      class OriginationUrls < NextGenListResource; end
+      class OriginationUrl < InstanceResource; end
+    end
+  end
+end

data/lib/twilio-ruby/rest/trunking/phone_numbers.rb

@@ -0,0 +1,8 @@
+module Twilio
+  module REST
+    module Trunking
+      class PhoneNumbers < NextGenListResource; end
+      class PhoneNumber < InstanceResource; end
+    end
+  end
+end

data/lib/twilio-ruby/rest/trunking/trunks.rb

@@ -0,0 +1,19 @@
+module Twilio
+  module REST
+    module Trunking
+      class Trunks < NextGenListResource; end
+      class Trunk < InstanceResource
+
+        def initialize(path, client, params={})
+          super
+          @submodule = :Trunking
+          resource :credential_lists,
+                   :ip_access_control_lists,
+                   :origination_urls,
+                   :phone_numbers
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,106 @@
+require 'twilio-ruby/rest/base_client'
+
+module Twilio
+  module REST
+    class TrunkingClient < BaseClient
+      include Twilio::Util
+      include Twilio::REST::Utils
+
+      API_VERSION = 'v1'
+
+      attr_reader :trunks
+
+      host 'trunking.twilio.com'
+
+      ##
+      # Instantiate a new HTTP client to talk to Twilio's Trunking API. The
+      # parameters +account_sid+ and +auth_token+ are required, unless you have
+      # configured them already using the block configure syntax, and used to
+      # generate the HTTP basic auth header in each request. The +options+
+      # parameter is a hash of connection configuration options. the following
+      # keys are supported:
+      #
+      # === <tt>host: 'trunking.twilio.com'</tt>
+      #
+      # The domain to which you'd like the client to make HTTP requests. Useful
+      # for testing. Defaults to 'trunking.twilio.com'.
+      #
+      # === <tt>port: 443</tt>
+      #
+      # The port on which to connect to the above domain. Defaults to 443 and
+      # should be left that way except in testing environments.
+      #
+      # === <tt>use_ssl: true</tt>
+      #
+      # Declare whether ssl should be used for connections to the above domain.
+      # Defaults to true and should be left alone except when testing.
+      #
+      # === <tt>ssl_verify_peer: true</tt>
+      #
+      # Declare whether to verify the host's ssl cert when setting up the
+      # connection to the above domain. Defaults to true, but can be turned off
+      # to avoid ssl certificate verification failures in environments without
+      # the necessary ca certificates.
+      #
+      # === <tt>ssl_ca_file: '/path/to/ca/file'</tt>
+      #
+      # Specify the path to the certificate authority bundle you'd like to use
+      # to verify Twilio's SSL certificate on each request. If not specified, a
+      # certificate bundle extraced from Firefox is packaged with the gem and
+      # used by default.
+      #
+      # === <tt>timeout: 30</tt>
+      #
+      # Set the time in seconds to wait before timing out the HTTP request.
+      # Defaults to 30 seconds. If you aren't fetching giant pages of call or
+      # SMS logs you can safely decrease this to something like 3 seconds or
+      # lower. In paricular if you are sending SMS you can set this to 1 second
+      # or less and swallow the exception if you don't care about the response.
+      #
+      # === <tt>proxy_addr: 'proxy.host.domain'</tt>
+      #
+      # The domain of a proxy through which you'd like the client to make HTTP
+      # requests. Defaults to nil.
+      #
+      # === <tt>proxy_port: 3128</tt>
+      #
+      # The port on which to connect to the above proxy. Defaults to nil.
+      #
+      # === <tt>proxy_user: 'username'</tt>
+      #
+      # The user name to use for authentication with the proxy. Defaults to nil.
+      #
+      # === <tt>proxy_pass: 'password'</tt>
+      #
+      # The password to use for authentication with the proxy. Defaults to nil.
+      #
+      # === <tt>retry_limit: 1</tt>
+      #
+      # The number of times to retry a request that has failed before throwing
+      # an exception. Defaults to one.
+      def initialize(*args)
+        super(*args)
+      end
+
+      def inspect # :nodoc:
+        "<Twilio::REST::TrunkingClient @account_sid=#{@account_sid}>"
+      end
+
+      protected
+
+      ##
+      # Set up +trunks+ attribute.
+      def set_up_subresources # :doc:
+        @trunks = Twilio::REST::Trunking::Trunks.new "/#{API_VERSION}/Trunks", self
+      end
+
+      ##
+      # Builds up full request path
+      def build_full_path(path, params, method)
+        path = path.dup
+        path << "?#{url_encode(params)}" if method == :get && !params.empty?
+        path
+      end
+    end
+  end
+end

data/lib/twilio-ruby/task_router/capability.rb

@@ -136,8 +136,11 @@ module Twilio
           @activityUrl = @baseUrl + "/Activities"
           allow(@activityUrl, "GET")
 
-          @reservationsUrl = @baseUrl + "/Tasks/**"
-          allow(@reservationsUrl, "GET")
+          @tasksUrl = @baseUrl + "/Tasks/**"
+          allow(@tasksUrl, "GET")
+
+          @workerReservationsUrl = @resourceUrl + "/Reservations/**"
+          allow(@workerReservationsUrl, "GET")
 
         elsif(@channel_id[0..1] == 'WQ')
           @resourceUrl = @baseUrl + "/TaskQueues/" + @channel_id
@@ -171,11 +174,13 @@ module Twilio
 
       def initialize(account_sid, auth_token, workspace_sid, worker_sid)
         super(account_sid, auth_token, workspace_sid, worker_sid)
-        @reservationsUrl = @baseUrl + "/Tasks/**"
+        @tasksUrl = @baseUrl + "/Tasks/**"
         @activityUrl = @baseUrl + "/Activities"
+        @workerReservationsUrl = @resourceUrl + "/Reservations/**"
 
         allow(@activityUrl, "GET")
-        allow(@reservationsUrl, "GET")
+        allow(@tasksUrl, "GET")
+        allow(@workerReservationsUrl, "GET")
       end
 
       def allow_activity_updates
@@ -183,7 +188,8 @@ module Twilio
       end
 
       def allow_reservation_updates
-        allow(@reservationsUrl, "POST", nil, nil)
+        allow(@tasksUrl, "POST", nil, nil)
+        allow(@workerReservationsUrl, "POST", nil, nil)
       end
 
       protected

data/lib/twilio-ruby/task_router/workflow_builder.rb

@@ -79,7 +79,13 @@ module Twilio
         rule['targets'].each do |target|
           targets.push(Twilio::TaskRouter::WorkflowRuleTarget.parse_json(target))
         end
-        Twilio::TaskRouter::WorkflowRule.new rule['expression'], targets, rule['friendly_name']
+        unless rule['filter_friendly_name'].nil?
+          friendly_name = rule['filter_friendly_name']
+        end
+        unless rule['friendly_name'].nil?
+          friendly_name = rule['friendly_name']
+        end
+        Twilio::TaskRouter::WorkflowRule.new rule['expression'], targets, friendly_name
       end
     end
     class WorkflowRuleTarget