gapic-generator 0.11.0 → 0.45.1

data/templates/default/service/rest/client/_config.text.erb

@@ -0,0 +1,178 @@
+<%- assert_locals service -%>
+<%- method_service ||= service  -%>
+##
+# Configuration class for the <%= service.name %> REST API.
+#
+# This class represents the configuration for <%= service.name %> REST,
+# providing control over timeouts, retry behavior, logging, transport
+# parameters, and other low-level controls. Certain parameters can also be
+# applied individually to specific RPCs. See
+# {<%= service.rest.client_name_full %>::Configuration::Rpcs}
+# for a list of RPCs that can be configured independently.
+#
+# Configuration can be applied globally to all clients, or to a single client
+# on construction.
+#
+<%- unless method_service.rest.methods.empty? -%>
+# @example
+#
+#   # Modify the global config, setting the timeout for
+#   # <%= method_service.rest.methods.first.name %> to 20 seconds,
+#   # and all remaining timeouts to 10 seconds.
+#   <%= service.rest.client_name_full %>.configure do |config|
+#     config.timeout = 10.0
+#     config.rpcs.<%= method_service.rest.methods.first.name %>.timeout = 20.0
+#   end
+#
+#   # Apply the above configuration only to a new client.
+#   client = <%= service.rest.client_name_full %>.new do |config|
+#     config.timeout = 10.0
+#     config.rpcs.<%= method_service.rest.methods.first.name %>.timeout = 20.0
+#   end
+#
+<%- end -%>
+# @!attribute [rw] endpoint
+#   A custom service endpoint, as a hostname or hostname:port. The default is
+#   nil, indicating to use the default endpoint in the current universe domain.
+#   @return [::String,nil]
+# @!attribute [rw] credentials
+#   Credentials to send with calls. You may provide any of the following types:
+#    *  (`String`) The path to a service account key file in JSON format
+#    *  (`Hash`) A service account key as a Hash
+#    *  (`Google::Auth::Credentials`) A googleauth credentials object
+#       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
+#    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
+#       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
+#    *  (`nil`) indicating no credentials
+#
+#   Warning: If you accept a credential configuration (JSON file or Hash) from an
+#   external source for authentication to Google Cloud, you must validate it before
+#   providing it to a Google API client library. Providing an unvalidated credential
+#   configuration to Google APIs can compromise the security of your systems and data.
+#   For more information, refer to [Validate credential configurations from external
+#   sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
+#   @return [::Object]
+# @!attribute [rw] scope
+#   The OAuth scopes
+#   @return [::Array<::String>]
+# @!attribute [rw] lib_name
+#   The library name as recorded in instrumentation and logging
+#   @return [::String]
+# @!attribute [rw] lib_version
+#   The library version as recorded in instrumentation and logging
+#   @return [::String]
+# @!attribute [rw] timeout
+#   The call timeout in seconds.
+#   @return [::Numeric]
+# @!attribute [rw] metadata
+#   Additional headers to be sent with the call.
+#   @return [::Hash{::Symbol=>::String}]
+# @!attribute [rw] retry_policy
+#   The retry policy. The value is a hash with the following keys:
+#    *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
+#    *  `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
+#    *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
+#    *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
+#       trigger a retry.
+#   @return [::Hash]
+# @!attribute [rw] quota_project
+#   A separate project against which to charge quota.
+#   @return [::String]
+# @!attribute [rw] universe_domain
+#   The universe domain within which to make requests. This determines the
+#   default endpoint URL. The default value of nil uses the environment
+#   universe (usually the default "googleapis.com" universe).
+#   @return [::String,nil]
+# @!attribute [rw] logger
+#   A custom logger to use for request/response debug logging, or the value
+#   `:default` (the default) to construct a default logger, or `nil` to
+#   explicitly disable logging.
+#   @return [::Logger,:default,nil]
+#
+class Configuration
+  extend ::Gapic::Config
+
+  # @private
+  # The endpoint specific to the default "googleapis.com" universe. Deprecated.
+  DEFAULT_ENDPOINT = <%= service.client_endpoint.inspect %>
+
+  config_attr :endpoint,      nil, ::String, nil
+  config_attr :credentials,   nil do |value|
+    allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
+    allowed.any? { |klass| klass === value }
+  end
+  config_attr :scope,         nil, ::String, ::Array, nil
+  config_attr :lib_name,      nil, ::String, nil
+  config_attr :lib_version,   nil, ::String, nil
+  config_attr :timeout,       nil, ::Numeric, nil
+  config_attr :metadata,      nil, ::Hash, nil
+  config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
+  config_attr :quota_project, nil, ::String, nil
+  config_attr :universe_domain, nil, ::String, nil
+  <%- if service.rest.mixin_should_generate_override_config? -%>
+
+  # @private
+  # Overrides for http bindings for the RPCs of this service
+  # are only used when this service is used as mixin, and only
+  # by the host service.
+  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
+  config_attr :bindings_override, {}, ::Hash, nil
+  <%- end -%>
+  config_attr :logger, :default, ::Logger, nil, :default
+
+  # @private
+  def initialize parent_config = nil
+    @parent_config = parent_config unless parent_config.nil?
+
+    yield self if block_given?
+  end
+
+  ##
+  # Configurations for individual RPCs
+  # @return [Rpcs]
+  #
+  def rpcs
+    @rpcs ||= begin
+      parent_rpcs = nil
+      parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
+      Rpcs.new parent_rpcs
+    end
+  end
+
+  ##
+  # Configuration RPC class for the <%= service.name %> API.
+  #
+  # Includes fields providing the configuration for each RPC in this service.
+  # Each configuration object is of type `Gapic::Config::Method` and includes
+  # the following configuration fields:
+  #
+  #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
+  #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
+  #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
+  #     include the following keys:
+  #      *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
+  #      *  `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
+  #      *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
+  #      *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
+  #         trigger a retry.
+  # 
+  class Rpcs
+  <%- method_service.rest.methods.each do |method| -%>
+    ##
+    # RPC-specific configuration for `<%= method.name %>`
+    # @return [::Gapic::Config::Method]
+    #
+    attr_reader :<%= method.name %>
+  <%- end -%>
+
+    # @private
+    def initialize parent_rpcs = nil
+      <%- method_service.rest.methods.each do |method| -%>
+      <%= method.name %>_config = parent_rpcs.<%= method.name %> if parent_rpcs.respond_to? :<%= method.name %>
+      @<%= method.name %> = ::Gapic::Config::Method.new <%= method.name %>_config
+      <%- end -%>
+
+      yield self if block_given?
+    end
+  end
+end

data/templates/default/service/rest/client/_operations.text.erb

@@ -0,0 +1,124 @@
+<%- assert_locals service -%>
+<% @requires = capture do %>
+require "gapic/operation"
+<% end %>
+# Service that implements Longrunning Operations API.
+class <%= service.operations_name %>
+  # @private
+  API_VERSION = "<%= service.api_version %>".freeze
+
+  # @private
+  DEFAULT_ENDPOINT_TEMPLATE = <%= service.client_endpoint_template.inspect %>
+
+  # @private
+  attr_reader :<%= service.lro_service.stub_name %>
+
+  ##
+  # Configuration for the <%= service.name %> Operations API.
+  #
+  # @yield [config] Configure the <%= service.operations_name %> client.
+  # @yieldparam config [<%= service.operations_name %>::Configuration]
+  #
+  # @return [<%= service.operations_name %>::Configuration]
+  #
+  def self.configure
+    @configure ||= <%= service.operations_name %>::Configuration.new
+    yield @configure if block_given?
+    @configure
+  end
+
+  ##
+  # Configure the <%= service.name %> <%= service.operations_name %> instance.
+  #
+  # The configuration is set to the derived mode, meaning that values can be changed,
+  # but structural changes (adding new fields, etc.) are not allowed. Structural changes
+  # should be made on {<%= service.operations_name %>.configure}.
+  #
+  # @yield [config] Configure the <%= service.operations_name %> client.
+  # @yieldparam config [<%= service.operations_name %>::Configuration]
+  #
+  # @return [<%= service.operations_name %>::Configuration]
+  #
+  def configure
+    yield @config if block_given?
+    @config
+  end
+
+  ##
+  # The effective universe domain
+  #
+  # @return [String]
+  #
+  def universe_domain
+    @<%= service.lro_service.stub_name %>.universe_domain
+  end
+
+  ##
+  # Create a new <%= service.operations_name %> client object.
+  #
+  # @yield [config] Configure the <%= service.client_name %> client.
+  # @yieldparam config [<%= service.operations_name %>::Configuration]
+  #
+  def initialize
+    # Create the configuration object
+    @config = Configuration.new <%= service.operations_name %>.configure
+
+    # Yield the configuration if needed
+    yield @config if block_given?
+
+    # Create credentials
+    credentials = @config.credentials
+    credentials ||= Credentials.default scope: @config.scope
+    if credentials.is_a?(::String) || credentials.is_a?(::Hash)
+      credentials = Credentials.new credentials, scope: @config.scope
+    end
+
+    @quota_project_id = @config.quota_project
+    @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
+
+    @<%= service.lro_service.stub_name %> = <%= service.operations_stub_name %>.new(
+      endpoint: @config.endpoint,
+      endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
+      universe_domain: @config.universe_domain,
+      credentials: credentials
+    )
+
+    # Used by an LRO wrapper for some methods of this service
+    @operations_client = self
+  end
+
+  # Service calls
+  <%- service.lro_service.rest.methods.each do |method| -%>
+
+  <%= indent_tail render(partial: "service/rest/client/method/def", locals: { method: method }), 2 %>
+  <%- end %>
+
+  <%= indent_tail render(partial: "service/rest/client/config", locals: { service: service.lro_service }), 2 %>
+end
+
+##
+# @private
+# REST service stub for the Longrunning Operations API.
+# Service stub contains baseline method implementations
+# including transcoding, making the REST call, and deserialing the response.
+class <%= service.operations_stub_name %>
+  def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
+    # These require statements are intentionally placed here to initialize
+    # the REST modules only when it's required.
+    require "gapic/rest"
+
+    @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
+                                                 endpoint_template: endpoint_template,
+                                                 universe_domain: universe_domain,
+                                                 credentials: credentials
+  end
+
+  <%- service.lro_service.rest.methods.each do |method| -%>
+  <%= indent_tail render(partial: "service/rest/service_stub/method/def", locals: { method: method, service_stub_name: service.operations_stub_name }), 2 %>
+  
+  <%- end %>
+  <%- service.lro_service.rest.methods.each do |method| -%>
+  <%= indent_tail render(partial: "service/rest/service_stub/grpc_transcoding_method/def", locals: { method: method }), 2 %>
+
+  <%- end %>
+end

data/templates/default/service/rest/client/method/{_def.erb → _def.text.erb}

@@ -1,17 +1,23 @@
 <%- assert_locals method -%>
 ##
 <%- if method.doc_description -%>
-  <%= indent method.doc_description, "# " %>
+  <%= indent method.doc_description(transport: :rest), "# " %>
 #
 <%- end -%>
 <%= render partial: "service/rest/client/method/docs/request", locals: { method: method } -%>
 <%= render partial: "service/rest/client/method/docs/result", locals: { method: method } -%>
 #
 <%= render partial: "service/rest/client/method/docs/error", locals: { method: method } -%>
+#
+<%= render partial: "service/rest/client/method/docs/snippets", locals: { method: method } -%>
 def <%= method.name %> request, options = nil
 <%= indent render(partial: "service/client/method/def/request", locals: { method: method }), 2 %>
 
 <%= indent render(partial: "service/rest/client/method/def/options_defaults", locals: { method: method }), 2 %>
+<%- if method.service.rest.is_main_mixin_service? -%>
+
+  bindings_override = @config.bindings_override["<%= method.grpc_full_name %>"]
+<%- end -%>
 
 <%= indent render(partial: "service/rest/client/method/def/response", locals: { method: method }), 2 %>
 <%= render partial: "service/rest/client/method/def/rescue", locals: { method: method } -%>

data/templates/default/service/rest/client/method/def/{_options_defaults.erb → _options_defaults.text.erb}

@@ -5,14 +5,19 @@ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 # Customize the options with defaults
 call_metadata = @config.rpcs.<%= method.name %>.metadata.to_h
 
-# Set x-goog-api-client header
+# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
   lib_name: @config.lib_name, lib_version: @config.lib_version,
   gapic_version: ::<%= method.service.gem.version_name_full %>,
   transports_version_send: [:rest]
 
+call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
 options.apply_defaults timeout:      @config.rpcs.<%= method.name %>.timeout,
-                       metadata:     call_metadata
+                       metadata:     call_metadata,
+                       retry_policy: @config.rpcs.<%= method.name %>.retry_policy
 
 options.apply_defaults timeout:      @config.timeout,
-                       metadata:     @config.metadata
+                       metadata:     @config.metadata,
+                       retry_policy: @config.retry_policy

data/templates/default/service/rest/client/method/def/{_response.erb → _response.text.erb}

@@ -3,6 +3,10 @@
 <%= render partial: "service/rest/client/method/def/response_paged", locals: { method: method } -%>
 <%- elsif method.rest.nonstandard_lro? -%>
 <%= render partial: "service/rest/client/method/def/response_nonstandard_lro", locals: { method: method } -%>
+<%- elsif method.rest.server_streaming? -%>
+<%= render partial: "service/rest/client/method/def/response_server_streaming", locals: { method: method } -%>
+<%- elsif method.lro? -%>
+<%= render partial: "service/rest/client/method/def/response_normal_lro", locals: { method: method } -%>
 <%- else -%>
 <%= render partial: "service/rest/client/method/def/response_normal", locals: { method: method } -%>
 <%- end -%>

data/templates/default/service/rest/client/method/def/{_response_nonstandard_lro.erb → _response_nonstandard_lro.text.erb}

@@ -1,8 +1,9 @@
 <%- assert_locals method -%>
-@<%= method.service.stub_name %>.<%= method.name %> request, options do |result, response|
-  result = <%= method.nonstandard_lro_client.helper_type %>.create_operation(
+<%- boverr_str = method.service.rest.is_main_mixin_service? ? ", bindings_override: bindings_override" : "" -%>
+@<%= method.service.stub_name %>.<%= method.name %> request, options<%= boverr_str %> do |result, response|
+  result = <%= method.rest.nonstandard_lro_client.helper_type %>.create_operation(
     operation: result,
-    client: <%= method.nonstandard_lro_client.client_var_name %>,
+    client: <%= method.rest.nonstandard_lro_client.client_var_name %>,
     <%- if method.lro.operation_request_fields.any? -%>
     request_values: {
       <%- method.lro.operation_request_fields.each_with_index do |(field_from, field_to), i| -%>
@@ -19,5 +20,5 @@
     options: options
   )
   yield result, response if block_given?
-  return result
+  throw :response, result
 end

data/templates/default/service/rest/client/method/def/_response_normal.text.erb

@@ -0,0 +1,5 @@
+<%- assert_locals method -%>
+<%- boverr_str = method.service.rest.is_main_mixin_service? ? ", bindings_override: bindings_override" : "" -%>
+@<%= method.service.stub_name %>.<%= method.name %> request, options<%= boverr_str %> do |result, operation|
+  yield result, operation if block_given?
+end

data/templates/default/service/rest/client/method/def/_response_normal_lro.text.erb

@@ -0,0 +1,7 @@
+<%- assert_locals method -%>
+<%- boverr_str = method.service.rest.is_main_mixin_service? ? ", bindings_override: bindings_override" : "" -%>
+@<%= method.service.stub_name %>.<%= method.name %> request, options<%= boverr_str %> do |result, operation|
+  result = ::Gapic::Operation.new result, <%= method.service.lro_client_ivar %>, options: options
+  yield result, operation if block_given?
+  throw :response, result
+end

data/templates/default/service/rest/client/method/def/_response_paged.text.erb

@@ -0,0 +1,7 @@
+<%- assert_locals method -%>
+<%- boverr_str = method.service.rest.is_main_mixin_service? ? ", bindings_override: bindings_override" : "" -%>
+@<%= method.service.stub_name %>.<%= method.name %> request, options<%= boverr_str %> do |result, operation|
+  result = ::Gapic::Rest::PagedEnumerable.new @<%= method.service.stub_name %>, :<%= method.name %>, "<%= method.rest.paged_response_repeated_field_name %>", request, result, options
+  yield result, operation if block_given?
+  throw :response, result
+end

data/templates/default/service/rest/client/method/def/_response_server_streaming.text.erb

@@ -0,0 +1,11 @@
+<%- assert_locals method -%>
+
+::Gapic::Rest::ServerStream.new(
+  <%= method.return_type %>,
+  ::Gapic::Rest::ThreadedEnumerator.new do |in_q, out_q|
+    @<%= method.service.stub_name %>.<%= method.name %> request, options do |chunk|
+      in_q.deq
+      out_q.enq chunk
+    end
+  end
+)

data/templates/default/service/rest/client/method/docs/{_request.erb → _request.text.erb}

@@ -8,8 +8,6 @@
 #     parameters, or to keep all the default parameter values, pass an empty Hash.
 #   @param options [::Gapic::CallOptions, ::Hash]
 #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
-#     Note: currently retry functionality is not implemented. While it is possible
-#     to set it using ::Gapic::CallOptions, it will not be applied
 <%-if method.arguments.any?-%>
 #
 <%- arg_list = method.arguments.map { |arg| "#{arg.name}: nil"}.join ", " -%>
@@ -21,7 +19,7 @@
 <%- method.arguments.each do |arg| -%>
 #   @param <%= arg.name %> [<%= arg.doc_types %>]
 <%- if arg.doc_description -%>
-<%= indent arg.doc_description, "#     " %>
+<%= indent arg.doc_description(transport: :rest), "#     " %>
 <%- end -%>
 <%- end -%>
 <%- end -%>

data/templates/default/service/rest/client/method/docs/_result.text.erb

@@ -0,0 +1,10 @@
+<%- assert_locals method -%>
+<%- if method.server_streaming? -%>
+# @return [::Enumerable<<%= method.rest.doc_response_type %>>]
+<%- else -%>
+# @yield [result, operation] Access the result along with the TransportOperation object
+# @yieldparam result [<%= method.rest.doc_response_type %>]
+# @yieldparam operation [::Gapic::Rest::TransportOperation]
+#
+# @return [<%= method.rest.doc_response_type %>]
+<%- end -%>

data/templates/default/service/rest/client/method/docs/_snippets.text.erb

@@ -0,0 +1,6 @@
+<%- assert_locals method -%>
+<%- if method.generate_yardoc_snippets? -%>
+# @example Basic example
+<%= indent render(partial: "snippets/snippet/inline", locals: { snippet: method.snippet(transport: :rest) }), "#   " %>
+#
+<%- end -%>

data/templates/default/service/{nonstandard_lro.erb → rest/nonstandard_lro.text.erb}

@@ -2,5 +2,5 @@
 <%= render partial: "service/client/nonstandard_lro",
            layout: "layouts/ruby",
            locals: { service: service,
-                     namespace: service.methods_rest_bindings? ? service.rest.service_name_full : service.service_name_full }
+                     namespace: service.rest.service_name_full }
 %>

data/templates/default/service/rest/operations.text.erb

@@ -0,0 +1,6 @@
+<%- assert_locals service -%>
+<%= render partial: "service/rest/client/operations",
+           layout: "layouts/ruby",
+           locals: { service: service.rest,
+                     namespace: service.rest.service_name_full }
+%>

data/templates/default/service/rest/service_stub/_service_stub.text.erb

@@ -0,0 +1,63 @@
+<%- assert_locals service -%>
+<% @requires = capture do %>
+require "<%= service.proto_service_require %>"
+<% end %>
+##
+# REST service stub for the <%= service.name %> service.
+# Service stub contains baseline method implementations
+# including transcoding, making the REST call, and deserialing the response.
+#
+<%= render partial: "proto_docs/deprecated", locals: { presenter: service } -%>
+class <%= service.rest.service_stub_name %>
+  # @private
+  def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
+    # These require statements are intentionally placed here to initialize
+    # the REST modules only when it's required.
+    require "gapic/rest"
+
+    @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
+                                                 endpoint_template: endpoint_template,
+                                                 universe_domain: universe_domain,
+                                                 credentials: credentials,
+                                                 numeric_enums: <%= service.rest.numeric_enums? %>,
+                                                 service_name: self.class,
+                                                 raise_faraday_errors: false,
+                                                 logger: logger
+  end
+
+  ##
+  # The effective universe domain
+  #
+  # @return [String]
+  #
+  def universe_domain
+    @client_stub.universe_domain
+  end
+
+  ##
+  # The effective endpoint
+  #
+  # @return [String]
+  #
+  def endpoint
+    @client_stub.endpoint
+  end
+
+  ##
+  # The logger used for request/response debug logging.
+  #
+  # @return [Logger]
+  #
+  def logger stub: false
+    stub ? @client_stub.stub_logger : @client_stub.logger
+  end
+
+  <%- service.rest.methods.each do |method| -%>
+  <%= indent_tail render(partial: "service/rest/service_stub/method/def", locals: { method: method, service_stub_name: service.rest.service_stub_name }), 2 %>
+
+  <%- end %>
+  <%- service.rest.methods.each do |method| -%>
+  <%= indent_tail render(partial: "service/rest/service_stub/grpc_transcoding_method/def", locals: { method: method }), 2 %>
+
+  <%- end %>
+end

data/templates/default/service/rest/service_stub/grpc_transcoding_method/_def.text.erb

@@ -0,0 +1,37 @@
+<%- assert_locals method -%>
+##
+# @private
+#
+# GRPC transcoding helper method for the <%= method.name %> REST call
+#
+# @param request_pb [<%= method.request_type %>]
+#   A request object representing the call parameters. Required.
+<%- if method.service.rest.is_main_mixin_service? -%>
+# @param bindings_override [::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>, nil]
+#   Binding overrides for the transcoding.
+<%- end %>
+# @return [Array(String, [String, nil], Hash{String => String})]
+#   Uri, Body, Query string parameters
+<%- boverr_str = method.service.rest.is_main_mixin_service? ? ", bindings_override: nil" : "" -%>
+def self.<%= method.rest.transcoding_helper_name %> request_pb<%= boverr_str %>
+  <%- if method.service.rest.is_main_mixin_service? -%>
+  transcoder = Gapic::Rest::GrpcTranscoder.new(bindings_override) if bindings_override
+  <%- end %>
+  <%- assignment = method.service.rest.is_main_mixin_service? ? "||=" : "=" -%>
+  transcoder <%= assignment %> Gapic::Rest::GrpcTranscoder.new
+  <%- method.http_bindings.each do |http_binding| -%>
+                                            .with_bindings(
+                                              uri_method: :<%= http_binding.verb %>,
+                                              uri_template: "<%= http_binding.uri_for_transcoding %>",
+                                            <%- if http_binding.body? -%>
+                                              body: "<%= http_binding.body %>",
+                                            <%- end -%>
+                                              matches: [
+                                            <%- http_binding.routing_params_transcoder_matches_strings.each do |match_str| -%>
+                                                <%= match_str %>
+                                            <%- end -%>
+                                              ]
+                                            )
+  <%- end %>
+  transcoder.transcode request_pb
+end

data/templates/default/service/rest/service_stub/method/_def.text.erb

@@ -0,0 +1,35 @@
+<%- assert_locals method -%>
+##
+# Baseline implementation for the <%= method.name %> REST call
+#
+# @param request_pb [<%= method.rest.request_type %>]
+#   A request object representing the call parameters. Required.
+# @param options [::Gapic::CallOptions]
+#   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+<%- if method.service.rest.is_main_mixin_service? -%>
+# @param bindings_override [::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>, nil]
+#   Binding overrides for the transcoding. Only used internally.
+<%- end %>
+#
+<%- if method.server_streaming? -%>
+# @yieldparam chunk [::String] The chunk of data received during server streaming.
+#
+# @return [::Gapic::Rest::TransportOperation]
+<%- else -%>
+# @yield [result, operation] Access the result along with the TransportOperation object
+# @yieldparam result [<%= method.rest.return_type %>]
+# @yieldparam operation [::Gapic::Rest::TransportOperation]
+#
+# @return [<%= method.rest.return_type %>]
+#   A result object deserialized from the server's reply
+<%- end -%>
+<%- if method.server_streaming? -%>
+def <%= method.name %> request_pb, options = nil, &block
+<%- else -%>
+<%- boverr_str = method.service.rest.is_main_mixin_service? ? ", bindings_override: nil" : "" -%>
+def <%= method.name %> request_pb, options = nil<%= boverr_str %>
+<%- end -%>
+<%= indent render(partial: "service/rest/service_stub/method/def/request", locals: { method: method }), 2 %>
+
+<%= indent render(partial: "service/rest/service_stub/method/def/response", locals: { method: method, service_stub_name: service_stub_name }), 2 %>
+end

data/templates/default/service/rest/service_stub/method/def/_response.text.erb

@@ -0,0 +1,37 @@
+<%- assert_locals method, service_stub_name -%>
+<%- boverr_str = method.service.rest.is_main_mixin_service? ? ", bindings_override: bindings_override" : "" -%>
+verb, uri, query_string_params, body = <%= service_stub_name %>.<%= method.rest.transcoding_helper_name %> request_pb<%= boverr_str %>
+query_string_params = if query_string_params.any?
+                        query_string_params.to_h { |p| p.split "=", 2 }
+                      else
+                        {}
+                      end
+
+<%- if method.server_streaming? -%>
+response = @client_stub.make_http_request(
+  verb,
+  uri: uri,
+  body: body || "",
+  params: query_string_params,
+  method_name: "<%= method.name %>",
+  options: options,
+  is_server_streaming: true,
+  &block
+)
+::Gapic::Rest::TransportOperation.new response
+<%- else -%>
+response = @client_stub.make_http_request(
+  verb,
+  uri: uri,
+  body: body || "",
+  params: query_string_params,
+  method_name: "<%= method.name %>",
+  options: options
+)
+operation = ::Gapic::Rest::TransportOperation.new response
+result = <%= method.return_type %>.decode_json response.body, ignore_unknown_fields: true
+catch :response do
+  yield result, operation if block_given?
+  result
+end
+<%- end -%>