twilio-ruby 5.34.1 → 5.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f3afee506f82f8d295b1b7bd408c090df9f2984bb639c1165559f837282cd0e
-  data.tar.gz: 3f3f1b4854f5df815c42617e0b089397925cb27f8207f22b35d0cf49011bdbdf
+  metadata.gz: 3a3e996f0e5e03d78e9be169b6254e444bac36f39c70a6c8ff1a0a682b672866
+  data.tar.gz: 3ccf875613f2bcce4316fa3e35ccdfa25bb5eefb0aeb1f424a388f5cf9e9ae23
 SHA512:
-  metadata.gz: 715032b7a617559d21cdacaaaa769567f873ccbdc432ac40b5e3d5761c4f32c9c18d51512a3221fe35527821b0945774a0770a43653fd7815b4a7011e3f76798
-  data.tar.gz: 6b305639f5b8ca5fa69e97d185221e13d9b1969d95b3d89b7d112b046e82dbab4c88a8cb7d633e0eefa0bde94d6aec9a424ea2cb3cc5897368c022d35c1d25f8
+  metadata.gz: 98f01d3f1f616b93ae64d25bdd6de991dc85c6c5b7a774b059aa60d07b3fe28650b05e0a73e234dbff7f16c4d405af298c7547596c7e19eda03bc618a875ffcd
+  data.tar.gz: 6a4ed10718140c2c528f0b053f2f34167d39d40283fc226b59bb7f0563137e953019ad0fd84d27f731f1994f64a8b1c2b0c3391aeed4b096cec6d1b7b252a68d

data/CHANGES.md

@@ -1,6 +1,12 @@
 twilio-ruby changelog
 =====================
 
+[2020-05-20] Version 5.35.0
+---------------------------
+**Library - Feature**
+- [PR #512](https://github.com/twilio/twilio-ruby/pull/512): add regional and edge support. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+
 [2020-05-13] Version 5.34.1
 ---------------------------
 **Api**

data/README.md

@@ -32,13 +32,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.34.1'
+gem 'twilio-ruby', '~> 5.35.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.34.1
+gem install twilio-ruby -v 5.35.0
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -64,6 +64,21 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 @client = Twilio::REST::Client.new account_sid, auth_token
 ```
 
+### Specify a Region and/or Edge
+
+```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'
+```
+
+This will result in the `hostname` transforming from `api.twilio.com` to `api.sydney.au1.twilio.com`.
+
 ### Make a Call
 
 ```ruby

data/lib/twilio-ruby.rb

@@ -38,7 +38,7 @@ module Twilio
   autoload :JWT, File.join(File.dirname(__FILE__), 'twilio-ruby', 'jwt', 'jwt.rb')
   autoload :TwiML, File.join(File.dirname(__FILE__), 'twilio-ruby', 'twiml', 'twiml.rb')
 
-  def_delegators :configuration, :account_sid, :auth_token, :http_client
+  def_delegators :configuration, :account_sid, :auth_token, :http_client, :region, :edge
 
   ##
   # Pre-configure with account SID and auth token so that you don't need to

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

@@ -11,14 +11,17 @@ module Twilio
     ##
     # A client for accessing the Twilio API.
     class Client
-      attr_accessor :http_client, :username, :password, :account_sid, :auth_token, :region
+      @@default_region = 'us1'
+
+      attr_accessor :http_client, :username, :password, :account_sid, :auth_token, :region, :edge
 
       ##
       # Initializes the Twilio Client
       def initialize(username=nil, password=nil, account_sid=nil, region=nil, http_client=nil)
         @username = username || Twilio.account_sid
         @password = password || Twilio.auth_token
-        @region = region
+        @region = region || Twilio.region
+        @edge = Twilio.edge
         @account_sid = account_sid || @username
         @auth_token = @password
         @auth = [@username, @password]
@@ -75,12 +78,7 @@ module Twilio
           headers['Accept'] = 'application/json'
         end
 
-        if !region.nil?
-            head, tail  = uri.split('.', 2)
-            if !tail.start_with?(region)
-                uri = [head, region, tail].join('.')
-            end
-        end
+        uri = build_uri(uri)
 
         @http_client.request(
           host,
@@ -95,6 +93,35 @@ module Twilio
         )
       end
 
+      ##
+      # Build the final request uri
+      def build_uri(uri)
+        if @region.nil? and @edge.nil?
+          return uri
+        end
+
+        parsed_url = URI(uri)
+        pieces = parsed_url.host.split('.')
+        product = pieces[0]
+        domain = pieces[-2, 2]
+        new_edge = @edge
+        new_region = @region
+
+        if pieces.length == 4
+          new_region ||= pieces[1]
+        elsif pieces.length == 5
+          new_edge ||= pieces[1]
+          new_region ||= pieces[2]
+        end
+
+        if !new_edge.nil? && new_region.nil?
+          new_region = @@default_region
+        end
+
+        parsed_url.host = [product, new_edge, new_region, domain].select {|item| !item.nil?}.join('.')
+        parsed_url.to_s
+      end
+
       ##
       # Validate the new SSL certificate for the Twilio API
       def validate_ssl_certificate

data/lib/twilio-ruby/util/configuration.rb

@@ -3,7 +3,7 @@
 module Twilio
   module Util
     class Configuration
-      attr_accessor :account_sid, :auth_token, :http_client
+      attr_accessor :account_sid, :auth_token, :http_client, :region, :edge
 
       def account_sid=(value)
         @account_sid = value
@@ -16,6 +16,14 @@ module Twilio
       def http_client=(value)
         @http_client = value
       end
+
+      def region=(value)
+        @region = value
+      end
+
+      def edge=(value)
+        @edge = value
+      end
     end
   end
 end

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '5.34.1'
+    VERSION = '5.35.0'
 end

data/spec/rest/client_spec.rb

@@ -49,75 +49,185 @@ describe Twilio::REST::TrunkingClient do
 end
 
 describe Twilio::REST::Client do
-  before do
-    Twilio.configure do |config|
-      config.account_sid = 'someSid'
-      config.auth_token = 'someToken'
-      config.http_client = 'someClient'
+  context 'configuration' do
+    before do
+      Twilio.configure do |config|
+        config.account_sid = 'someSid'
+        config.auth_token = 'someToken'
+        config.http_client = 'someClient'
+        config.region = 'someRegion'
+        config.edge = 'someEdge'
+      end
     end
-  end
 
-  it 'uses the global configuration by default' do
-    @client = Twilio::REST::Client.new
-    expect(@client.account_sid).to eq('someSid')
-    expect(@client.auth_token).to eq('someToken')
-    expect(@client.http_client).to eq('someClient')
-  end
+    it 'uses the global configuration by default' do
+      @client = Twilio::REST::Client.new
+      expect(@client.account_sid).to eq('someSid')
+      expect(@client.auth_token).to eq('someToken')
+      expect(@client.http_client).to eq('someClient')
+      expect(@client.region).to eq('someRegion')
+      expect(@client.edge).to eq('someEdge')
+    end
 
-  it 'uses the arguments over global configuration' do
-    @client = Twilio::REST::Client.new('myUser', 'myPassword', nil, nil, 'myClient')
-    expect(@client.account_sid).to eq('myUser')
-    expect(@client.auth_token).to eq('myPassword')
-    expect(@client.http_client).to eq('myClient')
-  end
+    it 'uses the arguments over global configuration' do
+      @client = Twilio::REST::Client.new('myUser', 'myPassword', nil, 'myRegion', 'myClient')
+      @client.edge = 'myEdge'
+      expect(@client.account_sid).to eq('myUser')
+      expect(@client.auth_token).to eq('myPassword')
+      expect(@client.http_client).to eq('myClient')
+      expect(@client.region).to eq('myRegion')
+      expect(@client.edge).to eq('myEdge')
+    end
 
-  it 'successfully validates the working SSL certificate' do
-    @holodeck.mock Twilio::Response.new(200, '')
-    expect { @client.validate_ssl_certificate }.not_to raise_error
-  end
+    class MyVersion < Twilio::REST::Version
+      def initialize(domain)
+        super
+        @version = 'v1'
+      end
+    end
 
-  it 'fails to validate broken SSL certificates' do
-    @holodeck.mock Twilio::Response.new(504, '')
-    expect { @client.validate_ssl_certificate }.to raise_error(Twilio::REST::RestError)
+    class MyDomain < Twilio::REST::Domain
+      def initialize(client)
+        super
+        @host = 'twilio.com'
+        @base_url = 'https://twilio.com'
+        @port = 443
+      end
+    end
   end
 
-  it 'translates bad request error params' do
-    @domain = MyDomain.new(@client)
-    @version = MyVersion.new(@domain)
-    @error_message = '{
-                        "code": 20001,
-                        "message": "Bad request",
-                        "more_info": "https://www.twilio.com/docs/errors/20001",
-                        "status": 400,
-                        "details": {
-                            "foo":"bar"
-                    }}'
-    @holodeck.mock Twilio::Response.new(400, @error_message)
-    expect {
-      @version.fetch('GET', 'http://foobar.com')
-    }.to raise_error { |error|
-      expect(error).to be_a(Twilio::REST::RestError)
-      expect(error.status_code).to eq(400)
-      expect(error.code).to eq(20_001)
-      expect(error.details).to eq({ 'foo' => 'bar' })
-      expect(error.error_message).to eq('Bad request')
-      expect(error.more_info).to eq('https://www.twilio.com/docs/errors/20001')
-    }
-  end
+  context 'validation' do
+    before do
+      Twilio.configure do |config|
+        config.account_sid = 'someSid'
+        config.auth_token = 'someToken'
+        config.http_client = 'someClient'
+        config.region = nil
+        config.edge = nil
+      end
+    end
 
-  class MyVersion < Twilio::REST::Version
-    def initialize(domain)
-      super
-      @version = 'v1'
+    it 'successfully validates the working SSL certificate' do
+      @holodeck.mock Twilio::Response.new(200, '')
+      expect { @client.validate_ssl_certificate }.not_to raise_error
+    end
+
+    it 'fails to validate broken SSL certificates' do
+      @holodeck.mock Twilio::Response.new(504, '')
+      expect { @client.validate_ssl_certificate }.to raise_error(Twilio::REST::RestError)
+    end
+
+    it 'translates bad request error params' do
+      @domain = MyDomain.new(@client)
+      @version = MyVersion.new(@domain)
+      @error_message = '{
+                          "code": 20001,
+                          "message": "Bad request",
+                          "more_info": "https://www.twilio.com/docs/errors/20001",
+                          "status": 400,
+                          "details": {
+                              "foo":"bar"
+                      }}'
+      @holodeck.mock Twilio::Response.new(400, @error_message)
+      expect {
+        @version.fetch('GET', 'http://foobar.com')
+      }.to raise_error { |error|
+        expect(error).to be_a(Twilio::REST::RestError)
+        expect(error.status_code).to eq(400)
+        expect(error.code).to eq(20_001)
+        expect(error.details).to eq({ 'foo' => 'bar' })
+        expect(error.error_message).to eq('Bad request')
+        expect(error.more_info).to eq('https://www.twilio.com/docs/errors/20001')
+      }
     end
   end
 
-  class MyDomain < Twilio::REST::Domain
-    def initialize(client)
-      super
-      @host = 'twilio.com'
-      @base_url = 'https://twilio.com'
-      @port = 443
+  describe '#build_uri' do
+    before(:all) do
+      Twilio.configure do |config|
+        config.account_sid = 'username'
+        config.auth_token = 'password'
+        config.region = nil
+        config.edge = nil
+      end
+    end
+
+    context 'no region or edge in url' do
+      it "doesn't set region or edge" do
+        @client = Twilio::REST::Client.new
+        expect(@client.build_uri('https://api.twilio.com')).to eq('https://api.twilio.com')
+      end
+
+      it 'uses the default region if edge set' do
+        @client = Twilio::REST::Client.new
+        @client.edge = 'edge'
+        expect(@client.build_uri('https://api.twilio.com')).to eq('https://api.edge.us1.twilio.com')
+      end
+
+      it 'sets region' do
+        @client = Twilio::REST::Client.new
+        @client.region = 'region'
+        expect(@client.build_uri('https://api.twilio.com')).to eq('https://api.region.twilio.com')
+      end
+
+      it 'sets region and edge' do
+        @client = Twilio::REST::Client.new
+        @client.region = 'region'
+        @client.edge = 'edge'
+        expect(@client.build_uri('https://api.twilio.com')).to eq('https://api.edge.region.twilio.com')
+      end
+    end
+
+    context 'region in url' do
+      it 'uses url region' do
+        @client = Twilio::REST::Client.new
+        expect(@client.build_uri('https://api.urlRegion.twilio.com')).to eq('https://api.urlRegion.twilio.com')
+      end
+
+      it 'uses client edge and url region' do
+        @client = Twilio::REST::Client.new
+        @client.edge = 'edge'
+        expect(@client.build_uri('https://api.urlRegion.twilio.com')).to eq('https://api.edge.urlRegion.twilio.com')
+      end
+
+      it 'prefers client region' do
+        @client = Twilio::REST::Client.new
+        @client.region = 'region'
+        expect(@client.build_uri('https://api.urlRegion.twilio.com')).to eq('https://api.region.twilio.com')
+      end
+
+      it 'uses client edge and prefers client region' do
+        @client = Twilio::REST::Client.new
+        @client.region = 'region'
+        @client.edge = 'edge'
+        expect(@client.build_uri('https://api.urlRegion.twilio.com')).to eq('https://api.edge.region.twilio.com')
+      end
+    end
+
+    context 'region and edge in url' do
+      it 'uses url region and edge' do
+        @client = Twilio::REST::Client.new
+        expect(@client.build_uri('https://api.urlEdge.urlRegion.twilio.com')).to eq('https://api.urlEdge.urlRegion.twilio.com')
+      end
+
+      it 'prefers client edge' do
+        @client = Twilio::REST::Client.new
+        @client.edge = 'edge'
+        expect(@client.build_uri('https://api.urlEdge.urlRegion.twilio.com')).to eq('https://api.edge.urlRegion.twilio.com')
+      end
+
+      it 'prefers client region' do
+        @client = Twilio::REST::Client.new
+        @client.region = 'region'
+        expect(@client.build_uri('https://api.urlEdge.urlRegion.twilio.com')).to eq('https://api.urlEdge.region.twilio.com')
+      end
+
+      it 'prefers client region and edge' do
+        @client = Twilio::REST::Client.new
+        @client.region = 'region'
+        @client.edge = 'edge'
+        expect(@client.build_uri('https://api.urlEdge.urlRegion.twilio.com')).to eq('https://api.edge.region.twilio.com')
+      end
     end
   end
 end

data/spec/util/configuration_spec.rb

@@ -18,4 +18,16 @@ describe Twilio::Util::Configuration do
     config.http_client = 'someClient'
     expect(config.http_client).to eq('someClient')
   end
+
+  it 'should have a region attribute' do
+    config = Twilio::Util::Configuration.new
+    config.region = 'someRegion'
+    expect(config.region).to eq('someRegion')
+  end
+
+  it 'should have an edge attribute' do
+    config = Twilio::Util::Configuration.new
+    config.edge = 'someEdge'
+    expect(config.edge).to eq('someEdge')
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twilio-ruby
 version: !ruby/object:Gem::Version
-  version: 5.34.1
+  version: 5.35.0
 platform: ruby
 authors:
 - Twilio API Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-13 00:00:00.000000000 Z
+date: 2020-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt
@@ -1072,8 +1072,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.10
+rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
 summary: The official library for communicating with the Twilio REST API, building