gapic-generator 0.48.1 → 0.49.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65e74230641390ed2b959a149e6cb1422321a69a5be01763e2a1f0a9d8c628be
-  data.tar.gz: 8f3deffc1abdb04553377e20d2af665f447925fc792d89a5e7ce5c8d0632ba85
+  metadata.gz: f6930660b378784b8737b799f9218f7bfb11001307036e88f71f1393d228b2a2
+  data.tar.gz: 4c4c206b3b964eec613c55f7857f728df60663a4ce9db259e55e0197a9afcaad
 SHA512:
-  metadata.gz: 4107e328d1a13816aada3e845f567d36d757a7ae237cbaa81f706b67f54ce8795429ff0e43e7c9d8ac093dce02ee60d2da40b8e01e66888dea4d5581ba658c96
-  data.tar.gz: 1d33abbbcf6995d1035e94672f44ee4660dd560205f75b0af7e4c0799a94a4bcbf7d6e3d6cd6b5ae121db388a73699a932a989d2a388b588394a8dd03c5d28c4
+  metadata.gz: d057c86b73503fb5061e9edc269881f68315d1b82234bcb96ce8cff8ba159a2e0df10ebc305962d62bf74086fad2f3492120b78e1c9686824f9a32d0d642c539
+  data.tar.gz: 806a7130234e071fecbc953c384fad1232a5a050d0989a7f8bc0a15b26ba860c70a011cac20b130f362c74cb92f42dbee97d0acdc3afd2845963288082b3e6db

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release History for gapic-generator
 
+### 0.49.0 / 2026-06-04
+
+* Feature: add retry jitter configuration
+* Feature: Skip generation for services without RPC methods defined
+* Fix: rename variable in generated test methods to avoid field name collision
+* Fix: prevent YARD failures on enum keywords
+
 ### 0.48.1 / 2026-03-17
 
 * Fix: Add irb to dependencies

data/README.md

@@ -98,9 +98,9 @@ This is not an official Google project. While it is being used internally to
 generate official Google API client libraries, there is no guarantee of support
 or stability for any other use.
 
-As of January 2024, this generator can be run on Ruby 3.0 or later. In general,
+As of May 2026, this generator can be run on Ruby 3.2 or later. In general,
 we will make an effort to ensure it is supported on non-end-of-life versions of
-Ruby.
+Ruby. Currently, this includes support through Ruby 4.0.
 
 Issues can be filed on GitHub at
 https://github.com/googleapis/gapic-generator-ruby/issues.

data/lib/gapic/generator/version.rb

@@ -16,6 +16,6 @@
 
 module Gapic
   module Generator
-    VERSION = "0.48.1"
+    VERSION = "0.49.0"
   end
 end

data/lib/gapic/generators/default_generator.rb

@@ -63,6 +63,9 @@ module Gapic
           files << g("binding_override", "lib/#{package.mixin_binding_overrides_file_path}", package: package) if package.mixin_binding_overrides? && package.generate_rest_clients?
 
           package.services.each do |service|
+            # Skip services with no RPCs defined
+            next if service.methods.empty?
+
             should_generate_grpc = service.generate_grpc_clients?
             should_generate_rest = service.generate_rest_clients?
 

data/lib/gapic/presenters/enum_value_presenter.rb

@@ -28,7 +28,18 @@ module Gapic
 
       # @return [String] The enum value name without keyword collision.
       def name
-        Gapic::RubyInfo.keywords.include?(@value.name) ? "#{@value.parent.name}::#{@value.name}" : @value.name
+        keyword_collision? ? "#{@value.parent.name}::#{@value.name}" : @value.name
+      end
+
+      # @return [Boolean] Whether the enum name collides with a Ruby keyword.
+      def keyword_collision?
+        Gapic::RubyInfo.keywords.include? @value.name
+      end
+
+      # @return [String] The doc stub string for the enum value. Prevents YARD warnings in cases of keyword
+      # collision.
+      def doc_line
+        keyword_collision? ? "const_set :#{@value.name}, #{@value.number}" : "#{@value.name} = #{@value.number}"
       end
 
       def doc_description

data/lib/gapic/presenters/gem_presenter.rb

@@ -256,7 +256,7 @@ module Gapic
 
       def dependencies
         @dependencies ||= begin
-          deps = { "gapic-common" => "~> 1.2" }
+          deps = { "gapic-common" => "~> 1.3" }
           deps["grpc-google-iam-v1"] = "~> 1.11" if iam_dependency?
           extra_deps = gem_config_dependencies
           deps.merge! mixins_model.dependencies if mixins_model.mixins?

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

@@ -32,7 +32,7 @@ response = client.<%= method.name %> request
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 3.1+.
+This library is supported on Ruby 3.2+.
 
 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

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

@@ -9,6 +9,6 @@ module <%= enum.name %>
   <%- if value.doc_description -%>
 <%= indent value.doc_description, "  # " %>
   <%- end -%>
-  <%= value.name %> = <%= value.number %>
+  <%= value.doc_line %>
   <%- end -%>
 end

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

@@ -98,6 +98,7 @@
 #    *  `: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.
+#    *  `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
 #    *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
 #       trigger a retry.
 #   @return [::Hash]
@@ -181,6 +182,7 @@ class Configuration
   #      *  `: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.
+  #      *  `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
   #      *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
   #         trigger a retry.
   # 

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

@@ -134,7 +134,9 @@ class <%= service.rest.client_name %>
       config.quota_project = @quota_project_id
       config.endpoint = @config.endpoint
       config.universe_domain = @config.universe_domain
-      <%- if subclient.respond_to?(:bindings_override) && !subclient.bindings_override.empty? -%>
+      <%- if service.rest.mixin_should_generate_override_config? &&
+             subclient.respond_to?(:bindings_override) &&
+             !subclient.bindings_override.empty? -%>
       config.bindings_override = @config.bindings_override
       <%- end -%>
     end
@@ -164,7 +166,9 @@ class <%= service.rest.client_name %>
       config.quota_project = @quota_project_id
       config.endpoint = @<%= service.stub_name %>.endpoint
       config.universe_domain = @<%= service.stub_name %>.universe_domain
-      <%- if subclient.respond_to?(:bindings_override) && !subclient.bindings_override.empty? -%>
+      <%- if service.rest.mixin_should_generate_override_config? &&
+             subclient.respond_to?(:bindings_override) &&
+             !subclient.bindings_override.empty? -%>
       config.bindings_override = @config.bindings_override
       <%- end -%>
       config.logger = @<%= service.stub_name %>.logger if config.respond_to? :logger=

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

@@ -72,6 +72,7 @@
 #    *  `: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.
+#    *  `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
 #    *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
 #       trigger a retry.
 #   @return [::Hash]
@@ -153,6 +154,7 @@ class Configuration
   #      *  `: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.
+  #      *  `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
   #      *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
   #         trigger a retry.
   # 

data/templates/default/service/rest/test/method/_normal.text.erb

@@ -22,34 +22,34 @@ def test_<%= method.name %>
   <%= method.service.rest.service_name_full %>::<%= method.service.rest.service_stub_name %>.stub :<%= method.rest.transcoding_helper_name %>, ["", "", {}] do
     Gapic::Rest::ClientStub.stub :new, <%= method.name %>_client_stub do
       # Create client
-      client = <%= full_client_name %>.new do |config|
+      c = <%= full_client_name %>.new do |config|
         config.credentials = :dummy_value
       end
 
       # Use hash object
-      client.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }) do |_result, response|
+      c.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }) do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end
 
       <%- if fields.any? -%>
       # Use named arguments
-      client.<%= method.name %> <%= fields.map(&:as_kwarg).join ", " %> do |_result, response|
+      c.<%= method.name %> <%= fields.map(&:as_kwarg).join ", " %> do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end
 
       <%- end -%>
       # Use protobuf object
-      client.<%= method.name %> <%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>) do |_result, response|
+      c.<%= method.name %> <%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>) do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end
 
       # Use hash object with options
-      client.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }, call_options) do |_result, response|
+      c.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }, call_options) do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end
 
       # Use protobuf object with options
-      client.<%= method.name %>(<%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>), call_options) do |_result, response|
+      c.<%= method.name %>(<%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>), call_options) do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end
 

data/templates/default/service/rest/test/method/_server.text.erb

@@ -22,34 +22,34 @@ def test_<%= method.name %>
   <%= method.service.rest.service_name_full %>::<%= method.service.rest.service_stub_name %>.stub :<%= method.rest.transcoding_helper_name %>, ["", "", {}] do
     Gapic::Rest::ClientStub.stub :new, <%= method.name %>_client_stub do
       # Create client
-      client = <%= full_client_name %>.new do |config|
+      c = <%= full_client_name %>.new do |config|
         config.credentials = :dummy_value
       end
 
       # Use hash object
-      client.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }) do |_result, response|
+      c.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }) do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end.first
 
       <%- if fields.any? -%>
       # Use named arguments
-      client.<%= method.name %> <%= fields.map(&:as_kwarg).join ", " %> do |_result, response|
+      c.<%= method.name %> <%= fields.map(&:as_kwarg).join ", " %> do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end.first
 
       <%- end -%>
       # Use protobuf object
-      client.<%= method.name %> <%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>) do |_result, response|
+      c.<%= method.name %> <%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>) do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end.first
 
       # Use hash object with options
-      client.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }, call_options) do |_result, response|
+      c.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }, call_options) do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end.first
 
       # Use protobuf object with options
-      client.<%= method.name %>(<%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>), call_options) do |_result, response|
+      c.<%= method.name %>(<%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>), call_options) do |_result, response|
         <%= indent_tail render(partial: "service/rest/test/method/assert_response", locals: { method: method }), 6 %>
       end.first
 

data/templates/default/service/test/method/_bidi.text.erb

@@ -22,7 +22,7 @@ def test_<%= method.name %>
 
   Gapic::ServiceStub.stub :new, <%= method.name %>_client_stub do
     # Create client
-    client = <%= full_client_name %>.new do |config|
+    c = <%= full_client_name %>.new do |config|
       config.credentials = grpc_channel
     end
 
@@ -30,7 +30,7 @@ def test_<%= method.name %>
     request_hash = { <%= fields.map(&:as_kwarg).join ", " %> }
     request_proto = <%= method.request_type %>.new <%= fields.map(&:as_kwarg).join ", " %>
     enum_input = [request_hash, request_proto].to_enum
-    client.<%= method.name %> enum_input do |response, operation|
+    c.<%= method.name %> enum_input do |response, operation|
       assert_kind_of Enumerable, response
       response.to_a.each do |r|
         assert_kind_of <%= method.return_type %>, r
@@ -42,7 +42,7 @@ def test_<%= method.name %>
     request_hash = { <%= fields.map(&:as_kwarg).join ", " %> }
     request_proto = <%= method.request_type %>.new <%= fields.map(&:as_kwarg).join ", " %>
     stream_input = Gapic::StreamInput.new
-    client.<%= method.name %> stream_input do |response, operation|
+    c.<%= method.name %> stream_input do |response, operation|
       assert_kind_of Enumerable, response
       response.to_a.each do |r|
         assert_kind_of <%= method.return_type %>, r
@@ -57,7 +57,7 @@ def test_<%= method.name %>
     request_hash = { <%= fields.map(&:as_kwarg).join ", " %> }
     request_proto = <%= method.request_type %>.new <%= fields.map(&:as_kwarg).join ", " %>
     enum_input = [request_hash, request_proto].to_enum
-    client.<%= method.name %> enum_input, grpc_options do |response, operation|
+    c.<%= method.name %> enum_input, grpc_options do |response, operation|
       assert_kind_of Enumerable, response
       response.to_a.each do |r|
         assert_kind_of <%= method.return_type %>, r
@@ -69,7 +69,7 @@ def test_<%= method.name %>
     request_hash = { <%= fields.map(&:as_kwarg).join ", " %> }
     request_proto = <%= method.request_type %>.new <%= fields.map(&:as_kwarg).join ", " %>
     stream_input = Gapic::StreamInput.new
-    client.<%= method.name %> stream_input, grpc_options do |response, operation|
+    c.<%= method.name %> stream_input, grpc_options do |response, operation|
       assert_kind_of Enumerable, response
       response.to_a.each do |r|
         assert_kind_of <%= method.return_type %>, r

data/templates/default/service/test/method/_client.text.erb

@@ -22,7 +22,7 @@ def test_<%= method.name %>
 
   Gapic::ServiceStub.stub :new, <%= method.name %>_client_stub do
     # Create client
-    client = <%= full_client_name %>.new do |config|
+    c = <%= full_client_name %>.new do |config|
       config.credentials = grpc_channel
     end
 
@@ -30,7 +30,7 @@ def test_<%= method.name %>
     request_hash = { <%= fields.map(&:as_kwarg).join ", " %> }
     request_proto = <%= method.request_type %>.new <%= fields.map(&:as_kwarg).join ", " %>
     enum_input = [request_hash, request_proto].to_enum
-    client.<%= method.name %> enum_input do |response, operation|
+    c.<%= method.name %> enum_input do |response, operation|
       <%= indent_tail render(partial: "service/test/method/assert_response", locals: { method: method }), 6 %>
     end
 
@@ -38,7 +38,7 @@ def test_<%= method.name %>
     request_hash = { <%= fields.map(&:as_kwarg).join ", " %> }
     request_proto = <%= method.request_type %>.new <%= fields.map(&:as_kwarg).join ", " %>
     stream_input = Gapic::StreamInput.new
-    client.<%= method.name %> stream_input do |response, operation|
+    c.<%= method.name %> stream_input do |response, operation|
       <%= indent_tail render(partial: "service/test/method/assert_response", locals: { method: method }), 6 %>
     end
     stream_input << request_hash
@@ -49,7 +49,7 @@ def test_<%= method.name %>
     request_hash = { <%= fields.map(&:as_kwarg).join ", " %> }
     request_proto = <%= method.request_type %>.new <%= fields.map(&:as_kwarg).join ", " %>
     enum_input = [request_hash, request_proto].to_enum
-    client.<%= method.name %> enum_input, grpc_options do |response, operation|
+    c.<%= method.name %> enum_input, grpc_options do |response, operation|
       <%= indent_tail render(partial: "service/test/method/assert_response", locals: { method: method }), 6 %>
     end
 
@@ -57,7 +57,7 @@ def test_<%= method.name %>
     request_hash = { <%= fields.map(&:as_kwarg).join ", " %> }
     request_proto = <%= method.request_type %>.new <%= fields.map(&:as_kwarg).join ", " %>
     stream_input = Gapic::StreamInput.new
-    client.<%= method.name %> stream_input, grpc_options do |response, operation|
+    c.<%= method.name %> stream_input, grpc_options do |response, operation|
       <%= indent_tail render(partial: "service/test/method/assert_response", locals: { method: method }), 6 %>
     end
     stream_input << request_hash

data/templates/default/service/test/method/_normal.text.erb

@@ -38,34 +38,34 @@ def test_<%= method.name %>
 
   Gapic::ServiceStub.stub :new, <%= method.name %>_client_stub do
     # Create client
-    client = <%= full_client_name %>.new do |config|
+    c = <%= full_client_name %>.new do |config|
       config.credentials = grpc_channel
     end
 
     # Use hash object
-    client.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }) do |response, operation|
+    c.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }) do |response, operation|
       <%= indent_tail render(partial: "service/test/method/assert_response", locals: { method: method }), 6 %>
     end
 
     <%- if fields.any? -%>
     # Use named arguments
-    client.<%= method.name %> <%= fields.map(&:as_kwarg).join ", " %> do |response, operation|
+    c.<%= method.name %> <%= fields.map(&:as_kwarg).join ", " %> do |response, operation|
       <%= indent_tail render(partial: "service/test/method/assert_response", locals: { method: method }), 6 %>
     end
 
     <%- end -%>
     # Use protobuf object
-    client.<%= method.name %> <%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>) do |response, operation|
+    c.<%= method.name %> <%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>) do |response, operation|
       <%= indent_tail render(partial: "service/test/method/assert_response", locals: { method: method }), 6 %>
     end
 
     # Use hash object with options
-    client.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }, grpc_options) do |response, operation|
+    c.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }, grpc_options) do |response, operation|
       <%= indent_tail render(partial: "service/test/method/assert_response", locals: { method: method }), 6 %>
     end
 
     # Use protobuf object with options
-    client.<%= method.name %>(<%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>), grpc_options) do |response, operation|
+    c.<%= method.name %>(<%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>), grpc_options) do |response, operation|
       <%= indent_tail render(partial: "service/test/method/assert_response", locals: { method: method }), 6 %>
     end
 

data/templates/default/service/test/method/_server.text.erb

@@ -38,12 +38,12 @@ def test_<%= method.name %>
 
   Gapic::ServiceStub.stub :new, <%= method.name %>_client_stub do
     # Create client
-    client = <%= full_client_name %>.new do |config|
+    c = <%= full_client_name %>.new do |config|
       config.credentials = grpc_channel
     end
 
     # Use hash object
-    client.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }) do |response, operation|
+    c.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }) do |response, operation|
       assert_kind_of Enumerable, response
       response.to_a.each do |r|
         assert_kind_of <%= method.return_type %>, r
@@ -52,7 +52,7 @@ def test_<%= method.name %>
     end
 
     # Use named arguments
-    client.<%= method.name %> <%= fields.map(&:as_kwarg).join ", " %> do |response, operation|
+    c.<%= method.name %> <%= fields.map(&:as_kwarg).join ", " %> do |response, operation|
       assert_kind_of Enumerable, response
       response.to_a.each do |r|
         assert_kind_of <%= method.return_type %>, r
@@ -61,7 +61,7 @@ def test_<%= method.name %>
     end
 
     # Use protobuf object
-    client.<%= method.name %> <%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>) do |response, operation|
+    c.<%= method.name %> <%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>) do |response, operation|
       assert_kind_of Enumerable, response
       response.to_a.each do |r|
         assert_kind_of <%= method.return_type %>, r
@@ -70,7 +70,7 @@ def test_<%= method.name %>
     end
 
     # Use hash object with options
-    client.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }, grpc_options) do |response, operation|
+    c.<%= method.name %>({ <%= fields.map(&:as_kwarg).join ", " %> }, grpc_options) do |response, operation|
       assert_kind_of Enumerable, response
       response.to_a.each do |r|
         assert_kind_of <%= method.return_type %>, r
@@ -79,7 +79,7 @@ def test_<%= method.name %>
     end
 
     # Use protobuf object with options
-    client.<%= method.name %>(<%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>), grpc_options) do |response, operation|
+    c.<%= method.name %>(<%= method.request_type %>.new(<%= fields.map(&:as_kwarg).join ", " %>), grpc_options) do |response, operation|
       assert_kind_of Enumerable, response
       response.to_a.each do |r|
         assert_kind_of <%= method.return_type %>, r

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gapic-generator
 version: !ruby/object:Gem::Version
-  version: 0.48.1
+  version: 0.49.0
 platform: ruby
 authors:
 - Ernest Landrito