gapic-generator 0.11.0 → 0.45.1

data/lib/google/cloud/tools/snippetgen/snippetindex/v1/snippet_index_pb.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tools/snippetgen/snippetindex/v1/snippet_index.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\nAgoogle/cloud/tools/snippetgen/snippetindex/v1/snippet_index.proto\x12-google.cloud.tools.snippetgen.snippetindex.v1\"\xa7\x01\n\x05Index\x12T\n\x0e\x63lient_library\x18\x01 \x01(\x0b\x32<.google.cloud.tools.snippetgen.snippetindex.v1.ClientLibrary\x12H\n\x08snippets\x18\x02 \x03(\x0b\x32\x36.google.cloud.tools.snippetgen.snippetindex.v1.Snippet\"\x9f\x06\n\x07Snippet\x12\x12\n\nregion_tag\x18\x01 \x01(\t\x12\r\n\x05title\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x0c\n\x04\x66ile\x18\x04 \x01(\t\x12I\n\x08language\x18\x05 \x01(\x0e\x32\x37.google.cloud.tools.snippetgen.snippetindex.v1.Language\x12R\n\rclient_method\x18\x06 \x01(\x0b\x32;.google.cloud.tools.snippetgen.snippetindex.v1.ClientMethod\x12\x11\n\tcanonical\x18\x07 \x01(\x08\x12M\n\x06origin\x18\x08 \x01(\x0e\x32=.google.cloud.tools.snippetgen.snippetindex.v1.Snippet.Origin\x12P\n\x08segments\x18\t \x03(\x0b\x32>.google.cloud.tools.snippetgen.snippetindex.v1.Snippet.Segment\x1a\xa7\x02\n\x07Segment\x12\r\n\x05start\x18\x01 \x01(\x05\x12\x0b\n\x03\x65nd\x18\x02 \x01(\x05\x12X\n\x04type\x18\x03 \x01(\x0e\x32J.google.cloud.tools.snippetgen.snippetindex.v1.Snippet.Segment.SegmentType\"\xa5\x01\n\x0bSegmentType\x12\x1c\n\x18SEGMENT_TYPE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x46ULL\x10\x01\x12\t\n\x05SHORT\x10\x02\x12\x19\n\x15\x43LIENT_INITIALIZATION\x10\x03\x12\x1a\n\x16REQUEST_INITIALIZATION\x10\x04\x12\x15\n\x11REQUEST_EXECUTION\x10\x05\x12\x15\n\x11RESPONSE_HANDLING\x10\x06\"Q\n\x06Origin\x12\x16\n\x12ORIGIN_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x41PI_DEFINITION\x10\x01\x12\n\n\x06\x43ONFIG\x10\x02\x12\x0f\n\x0bHANDWRITTEN\x10\x03\"\xf2\x02\n\x0c\x43lientMethod\x12\x12\n\nshort_name\x18\x01 \x01(\t\x12\x11\n\tfull_name\x18\x02 \x01(\t\x12\r\n\x05\x61sync\x18\x03 \x01(\x08\x12Y\n\nparameters\x18\x04 \x03(\x0b\x32\x45.google.cloud.tools.snippetgen.snippetindex.v1.ClientMethod.Parameter\x12\x13\n\x0bresult_type\x18\x05 \x01(\t\x12L\n\x06\x63lient\x18\x06 \x01(\x0b\x32<.google.cloud.tools.snippetgen.snippetindex.v1.ServiceClient\x12\x45\n\x06method\x18\x07 \x01(\x0b\x32\x35.google.cloud.tools.snippetgen.snippetindex.v1.Method\x1a\'\n\tParameter\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\"6\n\rServiceClient\x12\x12\n\nshort_name\x18\x01 \x01(\t\x12\x11\n\tfull_name\x18\x02 \x01(\t\"\xbb\x01\n\rClientLibrary\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12I\n\x08language\x18\x03 \x01(\x0e\x32\x37.google.cloud.tools.snippetgen.snippetindex.v1.Language\x12@\n\x04\x61pis\x18\x04 \x03(\x0b\x32\x32.google.cloud.tools.snippetgen.snippetindex.v1.Api\"x\n\x06Method\x12\x12\n\nshort_name\x18\x01 \x01(\t\x12\x11\n\tfull_name\x18\x02 \x01(\t\x12G\n\x07service\x18\x03 \x01(\x0b\x32\x36.google.cloud.tools.snippetgen.snippetindex.v1.Service\"0\n\x07Service\x12\x12\n\nshort_name\x18\x01 \x01(\t\x12\x11\n\tfull_name\x18\x02 \x01(\t\"\"\n\x03\x41pi\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t*\xef\x01\n\x08Language\x12\x18\n\x14LANGUAGE_UNSPECIFIED\x10\x00\x12\x0f\n\x0b\x43_PLUS_PLUS\x10\x01\x12\x0b\n\x07\x43_SHARP\x10\x02\x12\x08\n\x04\x44\x41RT\x10\x03\x12\n\n\x06\x45LIXIR\x10\x04\x12\n\n\x06\x45RLANG\x10\x05\x12\x0b\n\x07\x46_SHARP\x10\x06\x12\x06\n\x02GO\x10\x07\x12\x08\n\x04JAVA\x10\x08\x12\x0e\n\nJAVASCRIPT\x10\t\x12\n\n\x06KOTLIN\x10\n\x12\x07\n\x03PHP\x10\x0b\x12\n\n\x06PYTHON\x10\x0c\x12\x08\n\x04RUBY\x10\r\x12\x08\n\x04RUST\x10\x0e\x12\t\n\x05SWIFT\x10\x0f\x12\x0e\n\nTYPESCRIPT\x10\x10\x12\n\n\x06VB_NET\x10\x11\x42\x95\x01\xaa\x02-Google.Cloud.Tools.SnippetGen.SnippetIndex.V1\xca\x02-Google\\Cloud\\Tools\\SnippetGen\\SnippetIndex\\V1\xea\x02\x32Google::Cloud::Tools::SnippetGen::SnippetIndex::V1b\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Cloud
+    module Tools
+      module SnippetGen
+        module SnippetIndex
+          module V1
+            Index = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.Index").msgclass
+            Snippet = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.Snippet").msgclass
+            Snippet::Segment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.Snippet.Segment").msgclass
+            Snippet::Segment::SegmentType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.Snippet.Segment.SegmentType").enummodule
+            Snippet::Origin = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.Snippet.Origin").enummodule
+            ClientMethod = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.ClientMethod").msgclass
+            ClientMethod::Parameter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.ClientMethod.Parameter").msgclass
+            ServiceClient = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.ServiceClient").msgclass
+            ClientLibrary = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.ClientLibrary").msgclass
+            Method = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.Method").msgclass
+            Service = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.Service").msgclass
+            Api = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.Api").msgclass
+            Language = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tools.snippetgen.snippetindex.v1.Language").enummodule
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/protobuf/compiler/plugin_pb.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/compiler/plugin.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/descriptor_pb'
+
+
+descriptor_data = "\n%google/protobuf/compiler/plugin.proto\x12\x18google.protobuf.compiler\x1a google/protobuf/descriptor.proto\"F\n\x07Version\x12\r\n\x05major\x18\x01 \x01(\x05\x12\r\n\x05minor\x18\x02 \x01(\x05\x12\r\n\x05patch\x18\x03 \x01(\x05\x12\x0e\n\x06suffix\x18\x04 \x01(\t\"\xba\x01\n\x14\x43odeGeneratorRequest\x12\x18\n\x10\x66ile_to_generate\x18\x01 \x03(\t\x12\x11\n\tparameter\x18\x02 \x01(\t\x12\x38\n\nproto_file\x18\x0f \x03(\x0b\x32$.google.protobuf.FileDescriptorProto\x12;\n\x10\x63ompiler_version\x18\x03 \x01(\x0b\x32!.google.protobuf.compiler.Version\"\xc1\x02\n\x15\x43odeGeneratorResponse\x12\r\n\x05\x65rror\x18\x01 \x01(\t\x12\x1a\n\x12supported_features\x18\x02 \x01(\x04\x12\x42\n\x04\x66ile\x18\x0f \x03(\x0b\x32\x34.google.protobuf.compiler.CodeGeneratorResponse.File\x1a\x7f\n\x04\x46ile\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x17\n\x0finsertion_point\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x0f \x01(\t\x12?\n\x13generated_code_info\x18\x10 \x01(\x0b\x32\".google.protobuf.GeneratedCodeInfo\"8\n\x07\x46\x65\x61ture\x12\x10\n\x0c\x46\x45\x41TURE_NONE\x10\x00\x12\x1b\n\x17\x46\x45\x41TURE_PROTO3_OPTIONAL\x10\x01\x42r\n\x1c\x63om.google.protobuf.compilerB\x0cPluginProtosZ)google.golang.org/protobuf/types/pluginpb\xaa\x02\x18Google.Protobuf.Compiler"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.protobuf.FileDescriptorProto", "google/protobuf/descriptor.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Protobuf
+    module Compiler
+      Version = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.protobuf.compiler.Version").msgclass
+      CodeGeneratorRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.protobuf.compiler.CodeGeneratorRequest").msgclass
+      CodeGeneratorResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.protobuf.compiler.CodeGeneratorResponse").msgclass
+      CodeGeneratorResponse::File = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.protobuf.compiler.CodeGeneratorResponse.File").msgclass
+      CodeGeneratorResponse::Feature = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.protobuf.compiler.CodeGeneratorResponse.Feature").enummodule
+    end
+  end
+end

data/templates/default/binding_override.text.erb

@@ -0,0 +1,6 @@
+<%- assert_locals package -%>
+<%= render partial: "lib/binding_override",
+           layout: "layouts/ruby",
+           locals: { package: package,
+                     namespace: package.parent_namespace }
+%>

data/templates/default/gem/gemfile.text.erb

@@ -0,0 +1,12 @@
+<%- assert_locals gem -%>
+source "https://rubygems.org"
+
+gemspec
+
+gem "google-style", "~> 1.31.0"
+gem "minitest", "~> 5.22"
+gem "minitest-focus", "~> 1.4"
+gem "minitest-rg", "~> 5.3"
+gem "rake", ">= 13.0"
+gem "redcarpet", "~> 3.6"
+gem "yard", "~> 0.9"

data/templates/default/gem/{gemspec.erb → gemspec.text.erb}

@@ -1,6 +1,7 @@
 <%- assert_locals gem -%>
 # -*- ruby -*-
 # encoding: utf-8
+
 require File.expand_path("lib/<%= gem.version_require %>", __dir__)
 
 Gem::Specification.new do |gem|
@@ -9,7 +10,7 @@ Gem::Specification.new do |gem|
 
   gem.authors       = <%= gem.authors.inspect %>
   gem.email         = <%= gem.email.inspect %>
-  gem.description   = <%= gem.description.inspect %>
+  gem.description   = <%= gem.gemspec_description.inspect %>
   gem.summary       = <%= gem.summary.inspect %>
   gem.homepage      = <%= gem.homepage.inspect %>
   gem.license       = <%= gem.license_name.inspect %>
@@ -21,18 +22,9 @@ Gem::Specification.new do |gem|
                       <%= gem.extra_files.inspect %>
   gem.require_paths = ["lib"]
 
-  gem.required_ruby_version = ">= 2.5"
+  gem.required_ruby_version = ">= 3.1"
 
   <%- gem.dependency_list.each do |name, requirements| -%>
   gem.add_dependency <%= name.inspect %>, <%= requirements.map { |v| v.inspect }.join ", " %>
   <%- end -%>
-
-  gem.add_development_dependency "google-style", "~> 1.25.1"
-  gem.add_development_dependency "minitest", "~> 5.14"
-  gem.add_development_dependency "minitest-focus", "~> 1.1"
-  gem.add_development_dependency "minitest-rg", "~> 5.2"
-  gem.add_development_dependency "rake", ">= 12.0"
-  gem.add_development_dependency "redcarpet", "~> 3.0"
-  gem.add_development_dependency "simplecov", "~> 0.18"
-  gem.add_development_dependency "yard", "~> 0.9"
 end

data/templates/default/gem/{readme.erb → readme.text.erb}

@@ -2,7 +2,11 @@
 
 <%= gem.summary %>
 
-<%= gem.description %>
+<%- if gem.summary != gem.description %>
+<% gem.readme_description.each do |line| %>
+<%= line %>
+<% end %>
+<%- end %>
 
 <%= gem.homepage %>
 
@@ -28,11 +32,11 @@ response = client.<%= method.name %> request
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 3.1+.
 
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Currently, this means Ruby 2.5
-and later. Older versions of Ruby _may_ still work, but are unsupported and not
-recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
-about the Ruby support schedule.
+in security maintenance, and not end of life. Older versions of Ruby _may_
+still work, but are unsupported and not recommended. See
+https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
+support schedule.

data/templates/default/gem/{rubocop.erb → rubocop.text.erb}

@@ -22,6 +22,9 @@ Metrics/ModuleLength:
   Enabled: false
 Metrics/PerceivedComplexity:
   Enabled: false
+Naming/AccessorMethodName:
+  Exclude:
+    - "snippets/**/*.rb"
 Naming/FileName:
   Exclude:
     - "lib/<%= gem.name %>.rb"

data/templates/default/gem/{test_helper.erb → test_helper.text.erb}

@@ -1,8 +1,10 @@
 <%- assert_locals gem -%>
 <%= render partial: "shared/header" -%>
 
-require "simplecov"
-
 require "minitest/autorun"
 require "minitest/focus"
 require "minitest/rg"
+
+require "grpc"
+
+require "ostruct"

data/templates/default/gem/toys.text.erb

@@ -0,0 +1,12 @@
+<%= render partial: "shared/header" -%>
+
+toys_version! ">= 0.15.3"
+
+if ENV["RUBY_COMMON_TOOLS"]
+  common_tools_dir = File.expand_path ENV["RUBY_COMMON_TOOLS"]
+  load File.join(common_tools_dir, "toys", "gapic")
+else
+  load_git remote: "https://github.com/googleapis/ruby-common-tools.git",
+           path: "toys/gapic",
+           update: true
+end

data/templates/default/helpers/default_helper.rb

@@ -34,10 +34,29 @@ module DefaultHelper
     ret.split("\n").map(&:rstrip).join("\n")
   end
 
+  def wrap input, max_width
+    lines = []
+    input.split("\n").each do |line|
+      cur_width = 0
+      cur_words = []
+      line.split.each do |word|
+        if cur_width.positive? && cur_width + word.length > max_width
+          lines << cur_words.join(" ")
+          cur_width = 0
+          cur_words = []
+        end
+        cur_words << word
+        cur_width += word.length + 1
+      end
+      lines << cur_words.join(" ") if cur_width.positive?
+    end
+    lines.join "\n"
+  end
+
   def indent_tail input, spacing
     return input if input.lines.count < 2
 
-    input.lines[0] + indent(input.lines[1..-1].join, spacing)
+    input.lines[0] + indent(input.lines[1..].join, spacing)
   end
 
   def format_number value
@@ -47,4 +66,17 @@ module DefaultHelper
   def assert_locals *locals
     locals.each { |local| raise "missing local in template" if local.nil? }
   end
+
+  def start_line_spacer name = :default
+    (@line_spacers ||= {})[name] = false
+  end
+
+  def line_spacer name = :default
+    if @line_spacers[name]
+      "\n"
+    else
+      @line_spacers[name] = true
+      ""
+    end
+  end
 end

data/templates/default/lib/_binding_override.text.erb

@@ -0,0 +1,49 @@
+<%- assert_locals package -%>
+<% @requires = capture do %>
+require "gapic/config"
+<%- end -%>
+
+<%- if package.first_service_with_rest&.generate_rest_clients? -%>
+##
+# @example Loading just the REST part of this package, including all its services, and instantiating a REST client
+#
+#     require "<%= package.package_rest_require %>"
+#     client = <%= package.first_service_with_rest.rest.create_client_call %>
+#
+<%- end -%>
+module <%= package.module_name %>
+  ##
+  # @private
+  # Initialize the mixin bindings configuration
+  #
+  def self.configure
+<%= indent render(partial: "lib/package/self_configure", locals: { package: package }), 4 %>
+  end
+
+  ##
+  # @private
+  # Configuration class for the <%= package.name %> package.
+  #
+  # This class contains common configuration for all services
+  # of the <%= package.name %> package.
+  #
+  # This configuration is for internal use of the client library classes,
+  # and it is not intended that the end-users will read or change it.
+  #
+  class Configuration
+    extend ::Gapic::Config
+
+    # @private
+    # Overrides for http bindings for the RPC of the mixins for this package.
+    # Services in this package should use these when creating clients for the mixin services.
+    # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
+    config_attr :bindings_override, {}, ::Hash, nil
+
+    # @private
+    def initialize parent_config = nil
+      @parent_config = parent_config unless parent_config.nil?
+
+      yield self if block_given?
+    end
+  end
+end

data/templates/default/lib/{_package.erb → _package.text.erb}

@@ -6,24 +6,21 @@ require "<%= service.service_require %>"
 require "<%= package.gem.version_require %>"
 <% end %>
 <%- unless package.empty? -%>
-<%- if package.services.first.generate_grpc_clients? -%>
 ##
-# To load this package, including all its services, and instantiate a <%= package.grpc_client_designation %>:
+# API client module.
 #
-# @example
+<%- if package.generate_grpc_clients? -%>
+# @example Load this package, including all its services, and instantiate a gRPC client
 #
 #     require "<%= package.package_require %>"
 #     client = <%= package.services.first.create_client_call %>
 #
 <%- end -%>
-<%- if package.services.first.generate_rest_clients? -%>
-##
-# To load this package, including all its services, and instantiate a REST client:
-#
-# @example
+<%- if package.generate_rest_clients? -%>
+# @example Load this package, including all its services, and instantiate a REST client
 #
 #     require "<%= package.package_require %>"
-#     client = <%= package.services.first.rest.create_client_call %>
+#     client = <%= package.first_service_with_rest.rest.create_client_call %>
 #
 <%- end -%>
 <%- end -%>

data/templates/default/lib/_package_rest.text.erb

@@ -0,0 +1,24 @@
+<%- assert_locals package -%>
+<% @requires = capture do %>
+<%- package.services.select { |s| s.methods_rest_bindings? }.each do |service| -%>
+require "<%= service.rest.service_require %>"
+<%- end -%>
+<%- if package.mixin_binding_overrides? -%>
+require "<%= package.mixin_binding_overrides_require %>"
+<%- end -%>
+require "<%= package.gem.version_require %>"
+<% end %>
+<%- unless package.empty? -%>
+<%- if package.first_service_with_rest&.generate_rest_clients? -%>
+##
+# To load just the REST part of this package, including all its services, and instantiate a REST client:
+#
+# @example
+#
+#     require "<%= package.package_rest_require %>"
+#     client = <%= package.first_service_with_rest.rest.create_client_call %>
+#
+<%- end -%>
+<%- end -%>
+module <%= package.module_name %>
+end

data/templates/default/lib/{_service.erb → _service.text.erb}

@@ -1,26 +1,9 @@
 <%- assert_locals service -%>
 
-<%- if service.generate_rest_clients? -%>
-<% @requires = capture do %>
-require "gapic/config"
-require "gapic/config/method"
-
-require "<%= service.gem.version_require %>"
-
-<%- unless service.generic_endpoint? -%>
-require "<%= service.credentials_require %>"
-<%- end -%>
-<%- if service.paths? -%>
-require "<%= service.paths_require %>"
-<%- end -%>
-<%- if service.nonstandard_lro_provider? -%>
-require "<%= service.rest.nonstandard_lro_require %>"
-<%- end -%>
-require "<%= service.rest.service_rest_require %>"
-<% end %>
-<%- else -%>
 <% @requires = capture do %>
+<%- if service.generate_grpc_clients? -%>
 require "gapic/common"
+<%- end -%>
 require "gapic/config"
 require "gapic/config/method"
 
@@ -32,6 +15,7 @@ require "<%= service.credentials_require %>"
 <%- if service.paths? -%>
 require "<%= service.paths_require %>"
 <%- end -%>
+<%- if service.generate_grpc_clients? -%>
 <%- if service.lro? -%>
 require "<%= service.operations_require %>"
 <%- end -%>
@@ -39,24 +23,28 @@ require "<%= service.operations_require %>"
 require "<%= service.nonstandard_lro_require %>"
 <%- end -%>
 require "<%= service.client_require %>"
+<%- end -%>
+<%- if service.generate_rest_clients? -%>
+require "<%= service.rest.service_rest_require %>"
+<%- end -%>
 <% end %>
 ##
 <%- if service.doc_description -%>
 <%= indent service.doc_description, "# " %>
 #
 <%- end -%>
-<%- end -%>
+<%= render partial: "proto_docs/deprecated", locals: { presenter: service, newline: true } -%>
 <%- if service.generate_grpc_clients? -%>
-# To load this service and instantiate a <%= service.grpc_client_designation %>:
+# @example Load this service and instantiate a gRPC client
 #
 #     require "<%= service.service_require %>"
 #     client = <%= service.create_client_call %>
 #
 <%- end -%>
 <%- if service.generate_rest_clients? -%>
-# To load this service and instantiate a REST client:
+# @example Load this service and instantiate a REST client
 #
-#     require "<%= service.service_require %>"
+#     require "<%= service.rest.service_require %>"
 #     client = <%= service.rest.create_client_call %>
 #
 <%- end -%>

data/templates/default/lib/package/_self_configure.text.erb

@@ -0,0 +1,16 @@
+<%- assert_locals package -%>
+@configure ||= begin
+  namespace = <%= package.parent_namespace.split("::").reject(&:empty?).inspect %>
+  parent_config = while namespace.any?
+                    parent_name = namespace.join "::"
+                    parent_const = const_get parent_name
+                    break parent_const.configure if parent_const.respond_to? :configure
+                    namespace.pop
+                  end
+
+  default_config = Configuration.new parent_config
+  <%= indent_tail render(partial: "lib/package/self_configure_defaults", locals: {package: package}), 2 %>
+  default_config
+end
+yield @configure if block_given?
+@configure

data/templates/default/lib/package/_self_configure_defaults.text.erb

@@ -0,0 +1,13 @@
+<%- assert_locals package -%>
+<%- package.first_service_with_rest.rest.mixin_presenters.each do |subclient| -%>
+<%- subclient.bindings_override.each do |method, bindings| -%>
+default_config.bindings_override["<%= method %>"] = [
+
+<%- last_binding_index = bindings.count - 1 -%>
+<%- bindings.each_with_index do |http_binding, index| -%>
+  <%- comma = last_binding_index == index ? "" : "," -%>
+  <%= indent render(partial: "lib/package/self_configure/binding_default", locals: { http_binding: http_binding }), 4 %><%= comma %>
+<%- end -%>
+]
+<%- end -%>
+<%- end -%>

data/templates/default/lib/package/self_configure/_binding_default.text.erb

@@ -0,0 +1,15 @@
+<%- assert_locals http_binding -%>
+Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
+  uri_method: :<%= http_binding.verb %>,
+  uri_template: "<%= http_binding.uri_for_transcoding %>",
+  matches: [
+  <%- http_binding.routing_params_transcoder_matches_strings.each do |match_str| -%>
+    <%= match_str %>
+  <%- end -%>
+  ],
+  <%- if http_binding.body? -%>
+  body: "<%= http_binding.body %>"
+  <%- else -%>
+  body: nil
+  <%- end -%>
+)

data/templates/default/lib/rest/_rest.text.erb

@@ -0,0 +1,46 @@
+<%- assert_locals service -%>
+<% @requires = capture do %>
+require "gapic/rest"
+require "gapic/config"
+require "gapic/config/method"
+
+require "<%= service.gem.version_require %>"
+<%- if service.package.mixin_binding_overrides? -%>
+require "<%= service.package.mixin_binding_overrides_require %>"
+<%- end -%>
+
+<%- unless service.generic_endpoint? -%>
+require "<%= service.credentials_require %>"
+<%- end -%>
+<%- if service.paths? -%>
+require "<%= service.paths_require %>"
+<%- end -%>
+<%- if service.lro? -%>
+require "<%= service.rest.operations_require %>"
+<%- end -%>
+<%- if service.nonstandard_lro_provider? -%>
+require "<%= service.rest.nonstandard_lro_require %>"
+<%- end -%>
+require "<%= service.rest.client_require %>"
+<% end %>
+##
+<%- if service.doc_description -%>
+<%= indent service.doc_description, "# " %>
+#
+<%- end -%>
+# To load this service and instantiate a REST client:
+#
+#     require "<%= service.rest.service_require %>"
+#     client = <%= service.rest.create_client_call %>
+#
+module <%= service.module_name %>
+  # Client for the REST transport
+  module Rest
+  end
+end
+
+
+
+<% @footer = capture do %>
+<%= render partial: "service/helpers", locals: { service: service.rest} -%>
+<% end %>

data/templates/default/package_rest.text.erb

@@ -0,0 +1,6 @@
+<%- assert_locals package -%>
+<%= render partial: "lib/package_rest",
+           layout: "layouts/ruby",
+           locals: { package: package,
+                     namespace: package.parent_namespace }
+%>

data/templates/default/proto_docs/_deprecated.text.erb

@@ -0,0 +1,9 @@
+<%- assert_locals presenter -%>
+<% newline ||= false %>
+<% indentation ||= "# " %>
+<%- if presenter.is_deprecated? -%>
+<%= indent "@deprecated This #{presenter.type} is deprecated and may be removed in the next major version update.\n", indentation %>
+<%- if newline -%>
+<%= indentation %>
+<%- end -%>
+<%- end -%>

data/templates/default/proto_docs/{_enum.erb → _enum.text.erb}

@@ -2,6 +2,7 @@
 <%- if enum.doc_description -%>
 <%= indent enum.doc_description, "# " %>
 <%- end -%>
+<%= render partial: "proto_docs/deprecated", locals: { presenter: enum } -%>
 module <%= enum.name %>
   <%- enum.values.each do |value| -%>
 

data/templates/default/proto_docs/{_message.erb → _message.text.erb}

@@ -2,8 +2,10 @@
 <%- if message.doc_description -%>
 <%= indent message.doc_description, "# " %>
 <%- end -%>
+<%= render partial: "proto_docs/deprecated", locals: { presenter: message } -%>
 <%- message.fields.each do |field| -%>
 <%= indent field.doc_attribute_type, "# " %>
+<%= render(partial: "proto_docs/deprecated", locals: { presenter:field, indentation: "#   " }) -%>
 #   @return [<%= field.output_doc_types %>]
 <%- if field.doc_description -%>
 <%= indent field.doc_description, "#     " %>