gapic-common 0.3.2 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb1fde9489ba4700abd83cbf1a7fea7aab2ed2f844da5ac2070b8c73fe6bf0d8
-  data.tar.gz: bf9a3bce0b7d5c31edf806baceb5e228318ea3656a84c2a6e8b00bf11acbeee2
+  metadata.gz: e757f6cec4043dffd4d2b89e6f3fc02297074d6a28b361331fa16fbb0eef5d9b
+  data.tar.gz: 4dc4b0631dea8a91020bb7a004d9f17cfa48b9c2face5ef7ceb515a6a6ac4bfa
 SHA512:
-  metadata.gz: 281a1e48c10da144d2494e566468849299cf24639ca6119428cea669080c7ff435b758383b2ecf1173edd774c765d69a017f347b1e4ad49373b0c9d2925c2834
-  data.tar.gz: b33835a789ff87319ccb7ef8c448de8cadd44a8c44cf2c52f9553f7ceeea6d9b4715dcd19a1723cf9085d32b5be69dec0e2a46d39755aff0a795e6b030332339
+  metadata.gz: 30b58a2dd114652b524b2878745cc16028c0d65b197a4f3cf8c112883165b0509697a4909fffc19874efb08ee47d059e44b15151b9a74962bbcadac0c085054f
+  data.tar.gz: b6e463d4d9ff2c0366d334503da2660d403ee97c40529db65ec0929cf0547407e458d20dd37031536c1129c0439e11d8cce6975baa08f4df14369f475a690b0e

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Release History
 
+### 0.4.2 / 20201-06-07
+
+* Expand googleauth dependency to include 1.x
+* Add a REST PUT method helper to Gapic::Rest.
+
+### 0.4.1 / 2021-04-15
+
+* Provide a default value for the 'body' in the REST POST method in Gapic::Rest.
+
+### 0.4.0 / 2021-02-23
+
+* Support for the REST calls via the Gapic::Rest::ClientStub and other classes in Gapic::Rest
+  REST support is still being developed. Notably the full retries handling is not implemented yet.
+
+### 0.3.4 / 2020-08-07
+
+* Support the :this_channel_is_insecure gRPC pseudo-credential, used by tests and emulators.
+
+### 0.3.3 / 2020-08-05
+
+* Retry configs properly handle error name strings.
+
 ### 0.3.2 / 2020-07-30
 
 * Alias PagedEnumerable#next_page to PagedEnumerable#next_page!

data/CONTRIBUTING.md

@@ -8,7 +8,7 @@ just a few small guidelines you need to follow.
 Contributions to this project must be accompanied by a Contributor License
 Agreement. You (or your employer) retain the copyright to your contribution;
 this simply gives us permission to use and redistribute your contributions as
-part of the project. Head over to <https://cla.developers.google.com/> to see
+part of the project. Head over to https://cla.developers.google.com/ to see
 your current agreements on file or to sign a new one.
 
 You generally only need to submit a CLA once, so if you've already submitted one

data/lib/gapic/call_options.rb

@@ -26,7 +26,9 @@ module Gapic
   #   @return [RetryPolicy, Object]
   #
   class CallOptions
-    attr_reader :timeout, :metadata, :retry_policy
+    attr_reader :timeout
+    attr_reader :metadata
+    attr_reader :retry_policy
 
     ##
     # Create a new Options object instance.

data/lib/gapic/call_options/retry_policy.rb

@@ -29,7 +29,7 @@ module Gapic
       # @param max_delay [Numeric] client-side timeout
       #
       def initialize retry_codes: nil, initial_delay: nil, multiplier: nil, max_delay: nil
-        @retry_codes   = retry_codes
+        @retry_codes   = convert_codes retry_codes
         @initial_delay = initial_delay
         @multiplier    = multiplier
         @max_delay     = max_delay
@@ -77,7 +77,7 @@ module Gapic
       def apply_defaults retry_policy
         return unless retry_policy.is_a? Hash
 
-        @retry_codes   ||= retry_policy[:retry_codes]
+        @retry_codes   ||= convert_codes retry_policy[:retry_codes]
         @initial_delay ||= retry_policy[:initial_delay]
         @multiplier    ||= retry_policy[:multiplier]
         @max_delay     ||= retry_policy[:max_delay]
@@ -85,6 +85,34 @@ module Gapic
         self
       end
 
+      # @private
+      # See https://grpc.github.io/grpc/core/md_doc_statuscodes.html for a
+      # list of error codes.
+      ERROR_CODE_MAPPING = [
+        "OK",
+        "CANCELLED",
+        "UNKNOWN",
+        "INVALID_ARGUMENT",
+        "DEADLINE_EXCEEDED",
+        "NOT_FOUND",
+        "ALREADY_EXISTS",
+        "PERMISSION_DENIED",
+        "RESOURCE_EXHAUSTED",
+        "FAILED_PRECONDITION",
+        "ABORTED",
+        "OUT_OF_RANGE",
+        "UNIMPLEMENTED",
+        "INTERNAL",
+        "UNAVAILABLE",
+        "DATA_LOSS",
+        "UNAUTHENTICATED"
+      ].freeze
+
+      # @private
+      ERROR_STRING_MAPPING = ERROR_CODE_MAPPING.each_with_index.each_with_object({}) do |(str, num), hash|
+        hash[str] = num
+      end.freeze
+
       private
 
       def retry? error
@@ -96,6 +124,18 @@ module Gapic
         Kernel.sleep delay
       end
 
+      def convert_codes input_codes
+        return nil if input_codes.nil?
+        Array(input_codes).map do |obj|
+          case obj
+          when String
+            ERROR_STRING_MAPPING[obj]
+          when Integer
+            obj
+          end
+        end.compact
+      end
+
       ##
       # Calculate and set the next delay value.
       def increment_delay!

data/lib/gapic/common/version.rb

@@ -14,6 +14,6 @@
 
 module Gapic
   module Common
-    VERSION = "0.3.2".freeze
+    VERSION = "0.4.2".freeze
   end
 end

data/lib/gapic/config.rb

@@ -72,7 +72,7 @@ module Gapic
 
         if instance_variable_defined? :@parent_config
           parent = instance_variable_get :@parent_config
-          return parent.__send__ name if parent&.respond_to? name
+          return parent.__send__ name if parent.respond_to? name
         end
 
         default

data/lib/gapic/grpc/service_stub.rb

@@ -58,10 +58,11 @@ module Gapic
       channel_args = Hash channel_args
       interceptors = Array interceptors
 
-      @grpc_stub = if credentials.is_a? GRPC::Core::Channel
+      @grpc_stub = case credentials
+                   when GRPC::Core::Channel
                      grpc_stub_class.new endpoint, nil, channel_override: credentials,
                                                         interceptors:     interceptors
-                   elsif credentials.is_a? GRPC::Core::ChannelCredentials
+                   when GRPC::Core::ChannelCredentials, Symbol
                      grpc_stub_class.new endpoint, credentials, channel_args: channel_args,
                                                                 interceptors: interceptors
                    else

data/lib/gapic/grpc/service_stub/rpc_call.rb

@@ -122,9 +122,7 @@ module Gapic
           yield response, operation if block_given?
           response
         rescue StandardError => e
-          if check_retry? deadline
-            retry if options.retry_policy.call e
-          end
+          retry if check_retry?(deadline) && options.retry_policy.call(e)
 
           raise e
         end

data/lib/gapic/grpc/status_details.rb

@@ -27,13 +27,11 @@ module GRPC
       return nil.to_a if rpc_status.nil?
 
       rpc_status.details.map do |detail|
-        begin
-          detail_type = Google::Protobuf::DescriptorPool.generated_pool.lookup detail.type_name
-          detail = detail.unpack detail_type.msgclass if detail_type
-          detail
-        rescue Google::Protobuf::ParseError
-          detail
-        end
+        detail_type = Google::Protobuf::DescriptorPool.generated_pool.lookup detail.type_name
+        detail = detail.unpack detail_type.msgclass if detail_type
+        detail
+      rescue Google::Protobuf::ParseError
+        detail
       end
     end
   end

data/lib/gapic/paged_enumerable.rb

@@ -80,13 +80,11 @@ module Gapic
     #
     # @raise [RuntimeError] if it's not started yet.
     #
-    def each
+    def each &block
       return enum_for :each unless block_given?
 
       each_page do |page|
-        page.each do |obj|
-          yield obj
-        end
+        page.each(&block)
       end
     end
 
@@ -201,7 +199,8 @@ module Gapic
     #   @return [GRPC::ActiveCall::Operation] the RPC operation for the page.
     class Page
       include Enumerable
-      attr_reader :response, :operation
+      attr_reader :response
+      attr_reader :operation
 
       ##
       # @private

data/lib/gapic/protobuf.rb

@@ -96,7 +96,7 @@ module Gapic
     #
     # @return [Array<Object>] The coerced version of the given values.
     def self.coerce_array array, field_descriptor
-      raise ArgumentError, "Value " + array.to_s + " must be an array" unless array.is_a? Array
+      raise ArgumentError, "Value #{array} must be an array" unless array.is_a? Array
       array.map do |val|
         coerce_value val, field_descriptor
       end

data/lib/gapic/rest.rb

@@ -0,0 +1,27 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+##
+# Rest GAPIC features are still under development.
+#
+
+require "faraday"
+require "gapic/call_options"
+require "gapic/common/version"
+require "gapic/headers"
+require "gapic/protobuf"
+require "gapic/rest/client_stub"
+require "gapic/rest/error"
+require "gapic/rest/faraday_middleware"
+require "json"

data/lib/gapic/rest/client_stub.rb

@@ -0,0 +1,139 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "googleauth"
+require "gapic/rest/faraday_middleware"
+
+module Gapic
+  module Rest
+    ##
+    # A class for making REST calls through Faraday
+    # ClientStub's responsibilities:
+    #   - wrap Faraday methods with a bounded explicit interface
+    #   - store service endpoint and create full url for the request
+    #   - store credentials and add auth information to the request
+    #
+    class ClientStub
+      ##
+      # Initializes with an endpoint and credentials
+      # @param endpoint [String] an endpoint for the service that this stub will send requests to
+      # @param credentials [Google::Auth::Credentials]
+      #   Credentials to send with calls in form of a googleauth credentials object.
+      #   (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+      #
+      # @yield [Faraday::Connection]
+      #
+      def initialize endpoint:, credentials:
+        @endpoint = endpoint
+        @endpoint = "https://#{endpoint}" unless /^https?:/.match? endpoint
+        @endpoint.sub! %r{/$}, ""
+
+        @credentials = credentials
+
+        @connection = Faraday.new url: @endpoint do |conn|
+          conn.headers = { "Content-Type" => "application/json" }
+          conn.request :google_authorization, @credentials
+          conn.request :retry
+          conn.response :raise_error
+          conn.adapter :net_http
+        end
+
+        yield @connection if block_given?
+      end
+
+      ##
+      # Makes a GET request
+      #
+      # @param uri [String] uri to send this request to
+      # @param params [Hash] query string parameters for the request
+      # @param options [::Gapic::CallOptions] gapic options to be applied to the REST call.
+      #   Currently only timeout and headers are supported.
+      # @return [Faraday::Response]
+      def make_get_request uri:, params: {}, options: {}
+        make_http_request :get, uri: uri, body: nil, params: params, options: options
+      end
+
+      ##
+      # Makes a DELETE request
+      #
+      # @param uri [String] uri to send this request to
+      # @param params [Hash] query string parameters for the request
+      # @param options [::Gapic::CallOptions] gapic options to be applied to the REST call.
+      #   Currently only timeout and headers are supported.
+      # @return [Faraday::Response]
+      def make_delete_request uri:, params: {}, options: {}
+        make_http_request :delete, uri: uri, body: nil, params: params, options: options
+      end
+
+      ##
+      # Makes a PATCH request
+      #
+      # @param uri [String] uri to send this request to
+      # @param body [String] a body to send with the request, nil for requests without a body
+      # @param params [Hash] query string parameters for the request
+      # @param options [::Gapic::CallOptions] gapic options to be applied to the REST call.
+      #   Currently only timeout and headers are supported.
+      # @return [Faraday::Response]
+      def make_patch_request uri:, body:, params: {}, options: {}
+        make_http_request :patch, uri: uri, body: body, params: params, options: options
+      end
+
+      ##
+      # Makes a POST request
+      #
+      # @param uri [String] uri to send this request to
+      # @param body [String] a body to send with the request, nil for requests without a body
+      # @param params [Hash] query string parameters for the request
+      # @param options [::Gapic::CallOptions] gapic options to be applied to the REST call.
+      #   Currently only timeout and headers are supported.
+      # @return [Faraday::Response]
+      def make_post_request uri:, body: nil, params: {}, options: {}
+        make_http_request :post, uri: uri, body: body, params: params, options: options
+      end
+
+      ##
+      # Makes a PUT request
+      #
+      # @param uri [String] uri to send this request to
+      # @param body [String] a body to send with the request, nil for requests without a body
+      # @param params [Hash] query string parameters for the request
+      # @param options [::Gapic::CallOptions] gapic options to be applied to the REST call.
+      #   Currently only timeout and headers are supported.
+      # @return [Faraday::Response]
+      def make_put_request uri:, body: nil, params: {}, options: {}
+        make_http_request :put, uri: uri, body: body, params: params, options: options
+      end
+
+      protected
+
+      ##
+      # Sends a http request via Faraday
+      # @param verb [Symbol] http verb
+      # @param uri [String] uri to send this request to
+      # @param body [String, nil] a body to send with the request, nil for requests without a body
+      # @param params [Hash] query string parameters for the request
+      # @param options [::Gapic::CallOptions] gapic options to be applied to the REST call.
+      #   Currently only timeout and headers are supported.
+      # @return [Faraday::Response]
+      def make_http_request verb, uri:, body:, params:, options:
+        @connection.send verb, uri do |req|
+          req.params = params if params.any?
+          req.body = body unless body.nil?
+          req.headers = req.headers.merge options.metadata
+          req.options.timeout = options.timeout if options.timeout&.positive?
+        end
+      end
+    end
+  end
+end

data/lib/gapic/rest/error.rb

@@ -0,0 +1,73 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "json"
+
+module Gapic
+  module Rest
+    # Gapic REST exception class
+    class Error < StandardError
+      # @return [Integer] the http status code for the error
+      attr_reader :status_code
+
+      ##
+      # @param message [String, nil] error message
+      # @param status_code [Integer, nil] HTTP status code of this error
+      #
+      def initialize message, status_code
+        @status_code = status_code
+        super message
+      end
+
+      class << self
+        ##
+        # This creates a new error message wrapping the Faraday's one. Additionally
+        # it tries to parse and set a detailed message and an error code from
+        # from the Google Cloud's response body
+        #
+        def wrap_faraday_error err
+          message = err.message
+          status_code = err.response_status
+
+          if err.response_body
+            msg, code = try_parse_from_body err.response_body
+            message = "An error has occurred when making a REST request: #{msg}" unless msg.nil?
+            status_code = code unless code.nil?
+          end
+
+          Gapic::Rest::Error.new message, status_code
+        end
+
+        private
+
+        ##
+        # Tries to get the error information from the JSON bodies
+        #
+        # @param body_str [String]
+        # @return [Array(String, String)]
+        def try_parse_from_body body_str
+          body = JSON.parse body_str
+          return [nil, nil] unless body && body["error"].is_a?(Hash)
+
+          message = body["error"]["message"]
+          code = body["error"]["code"]
+
+          [message, code]
+        rescue JSON::ParserError
+          [nil, nil]
+        end
+      end
+    end
+  end
+end

data/lib/gapic/rest/faraday_middleware.rb

@@ -0,0 +1,45 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+require "faraday"
+
+module Gapic
+  module Rest
+    # Registers the middleware with Faraday
+    module FaradayMiddleware
+      ##
+      # Request middleware that constructs the Authorization HTTP header
+      # using ::Google::Auth::Credentials
+      #
+      class GoogleAuthorization < Faraday::Middleware
+        ##
+        # @param app [#call]
+        # @param credentials [::Google::Auth::Credentials]
+        def initialize app, credentials
+          @credentials = credentials
+          super app
+        end
+
+        # @param env [Faraday::Env]
+        def call env
+          auth_hash = @credentials.client.apply({})
+          env.request_headers["Authorization"] = auth_hash[:authorization]
+
+          @app.call env
+        end
+      end
+
+      Faraday::Request.register_middleware google_authorization: -> { GoogleAuthorization }
+    end
+  end
+end

metadata

@@ -1,103 +1,117 @@
 --- !ruby/object:Gem::Specification
 name: gapic-common
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.2
 platform: ruby
 authors:
 - Google API Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-07-30 00:00:00.000000000 Z
+date: 2021-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: google-protobuf
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.12.2
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.12.2
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: googleapis-common-protos
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.3.9
+        version: 1.3.11
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.3.9
+        version: 1.3.11
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: googleapis-common-protos-types
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.4
+        version: 1.0.6
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.4
+        version: 1.0.6
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: googleauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.16.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.16.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
+- !ruby/object:Gem::Dependency
+  name: google-protobuf
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '3.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '3.14'
 - !ruby/object:Gem::Dependency
   name: grpc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.25'
+        version: '1.36'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.25'
+        version: '1.36'
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
   requirement: !ruby/object:Gem::Requirement
@@ -118,28 +132,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.24.0
+        version: 1.25.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.24.0
+        version: 1.25.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.10'
+        version: '5.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.10'
+        version: '5.14'
 - !ruby/object:Gem::Dependency
   name: minitest-autotest
   requirement: !ruby/object:Gem::Requirement
@@ -254,6 +268,10 @@ files:
 - lib/gapic/operation/retry_policy.rb
 - lib/gapic/paged_enumerable.rb
 - lib/gapic/protobuf.rb
+- lib/gapic/rest.rb
+- lib/gapic/rest/client_stub.rb
+- lib/gapic/rest/error.rb
+- lib/gapic/rest/faraday_middleware.rb
 - lib/gapic/stream_input.rb
 homepage: https://github.com/googleapis/gapic-generator-ruby
 licenses:
@@ -267,14 +285,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: Common code for GAPIC-generated API clients