google-gax 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 34fe59f1bfcd32a791b319ddb7ac77d8dadf7922
-  data.tar.gz: 0d77001cd6917bc5fe0b4bc9960b189437b22e0f
+  metadata.gz: d54006c2b0494a7908f5510bc48ef77a98c2ff02
+  data.tar.gz: d19197493f156c95c153f9c8a2cd3501ecdffc67
 SHA512:
-  metadata.gz: bb35c9359dd55066155c0607a647365a7b75cf0cef86ba7e91dd539542b0437915db0b29c09b00e57a83d48f35161ecfc938e00ea47643c2dbf219c456790742
-  data.tar.gz: 00bb1dcce002d4ee67450a5825bfd02d949583b1909707c5dabed153ddf329d00d89ea364b9ac9953830952c40a7e6f8893e815e3e9b3f35d48ec2c1e94ba996
+  metadata.gz: 806f18271c7a31698639466e5a6900598226eb53ed807cfc7ca84b17f898aa5c5b77cb68478dc0c329d5e299943143f6d4b974d3045a53b277d3bde272bf97e9
+  data.tar.gz: 671837be39ed1a7fe642f9652ab766535b44e07dc46892cd56499990d57a26ba318846de9fed4918eca8db1ca06c94dd21c52c06769a0e275aef37b6b50d59f0

data/lib/google/gax/grpc.rb

@@ -100,10 +100,15 @@ module Google
       #   The OAuth scopes for this service. This parameter is ignored if
       #   a custom metadata_transformer is supplied.
       #
+      # @param interceptors [Array<GRPC::ClientInterceptor>] An array of
+      #     GRPC::ClientInterceptor objects that will be used for
+      #     intercepting calls before they are executed
+      #     Interceptors are an EXPERIMENTAL API.
+      #
       # @raise [ArgumentError] if a combination channel, chan_creds, and
       #    updater_proc are passed.
       #
-      # @yield [address, creds]
+      # @yield [address, creds, channel_override, interceptors]
       #   the generated gRPC method to create a stub.
       #
       # @return A gRPC client stub.
@@ -112,13 +117,15 @@ module Google
                       channel: nil,
                       chan_creds: nil,
                       updater_proc: nil,
-                      scopes: nil)
+                      scopes: nil,
+                      interceptors: [])
         verify_params(channel, chan_creds, updater_proc)
         address = "#{service_path}:#{port}"
         if channel
-          yield(address, nil, channel_override: channel)
+          yield(address, nil, channel_override: channel,
+                              interceptors: interceptors)
         elsif chan_creds
-          yield(address, chan_creds)
+          yield(address, chan_creds, interceptors: interceptors)
         else
           if updater_proc.nil?
             auth_creds = Google::Auth.get_application_default(scopes)
@@ -126,7 +133,7 @@ module Google
           end
           call_creds = GRPC::Core::CallCredentials.new(updater_proc)
           chan_creds = GRPC::Core::ChannelCredentials.new.compose(call_creds)
-          yield(address, chan_creds)
+          yield(address, chan_creds, interceptors: interceptors)
         end
       end
 

data/lib/google/gax/settings.rb

@@ -463,9 +463,9 @@ module Google
     #   API client config file.
     # @param config_overrides [Hash] A hash in the same structure of
     #   client_config to override the settings.
-    # @param retry_names [Hash] A dictionary mapping the strings
-    #   referring to response status codes to the Python objects
-    #   representing those codes.
+    # @param retry_names [Hash] A hash mapping the string names
+    #   used in the standard API client config file to API response
+    #   status codes.
     # @param timeout [Numeric] The timeout parameter for all API calls
     #   in this dictionary.
     # @param bundle_descriptors [Hash{String => BundleDescriptor}]

data/lib/google/gax/version.rb

@@ -29,6 +29,6 @@
 
 module Google
   module Gax
-    VERSION = '1.2.0'.freeze
+    VERSION = '1.3.0'.freeze
   end
 end

data/spec/google/gax/grpc_spec.rb

@@ -45,21 +45,66 @@ describe Google::Gax::Grpc do
 
       expect do |blk|
         Google::Gax::Grpc.create_stub('service', 'port', &blk)
-      end.to yield_with_args('service:port', composed_mock)
+      end.to yield_with_args('service:port', composed_mock, interceptors: [])
     end
 
     it 'yields given channel' do
       mock = instance_double(GRPC::Core::Channel)
+      interceptors = instance_double(Array)
       expect do |blk|
-        Google::Gax::Grpc.create_stub('service', 'port', channel: mock, &blk)
-      end.to yield_with_args('service:port', nil, channel_override: mock)
+        Google::Gax::Grpc.create_stub(
+          'service', 'port', channel: mock, interceptors: interceptors, &blk
+        )
+      end.to yield_with_args(
+        'service:port', nil, channel_override: mock, interceptors: interceptors
+      )
+    end
+
+    it 'yields given channel and interceptors' do
+      mock = instance_double(GRPC::Core::Channel)
+      expect do |blk|
+        Google::Gax::Grpc.create_stub(
+          'service', 'port', channel: mock, &blk
+        )
+      end.to yield_with_args(
+        'service:port', nil, channel_override: mock, interceptors: []
+      )
+    end
+
+    it 'yields given interceptors' do
+      interceptors = instance_double(Array)
+      channel = instance_double(GRPC::Core::Channel)
+      expect do |blk|
+        Google::Gax::Grpc.create_stub(
+          'service', 'port', channel: channel, interceptors: interceptors, &blk
+        )
+      end.to yield_with_args(
+        'service:port', anything, channel_override: channel,
+                                  interceptors: interceptors
+      )
     end
 
     it 'yields given channel credentials' do
       mock = instance_double(GRPC::Core::ChannelCredentials)
       expect do |blk|
-        Google::Gax::Grpc.create_stub('service', 'port', chan_creds: mock, &blk)
-      end.to yield_with_args('service:port', mock)
+        Google::Gax::Grpc.create_stub(
+          'service', 'port', chan_creds: mock, &blk
+        )
+      end.to yield_with_args(
+        'service:port', mock, interceptors: []
+      )
+    end
+
+    it 'yields given channel credentials and interceptors' do
+      mock = instance_double(GRPC::Core::ChannelCredentials)
+      interceptors = instance_double(Array)
+      expect do |blk|
+        Google::Gax::Grpc.create_stub(
+          'service', 'port', chan_creds: mock, interceptors: interceptors, &blk
+        )
+      end.to yield_with_args(
+        'service:port', mock, interceptors: interceptors
+      )
     end
 
     it 'yields channel credentials composed of the given updater_proc' do
@@ -78,7 +123,9 @@ describe Google::Gax::Grpc do
         Google::Gax::Grpc.create_stub(
           'service', 'port', updater_proc: updater_proc, &blk
         )
-      end.to yield_with_args('service:port', composed_chan_creds)
+      end.to yield_with_args(
+        'service:port', composed_chan_creds, interceptors: []
+      )
     end
 
     it 'raise an argument error if multiple creds are passed in' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-gax
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Google API Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-04-11 00:00:00.000000000 Z
+date: 2018-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: googleauth