gapic-generator 0.45.3 → 0.45.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 271aec2d05b52adb5498c05c65461142789397a22d3b9a99d1d09f1559e8cf4f
-  data.tar.gz: 16e8bbbf90f2c0eb2174939cc7972fa37552cb807cfd24ecc0d74c9ed252a642
+  metadata.gz: e3f7283592167653163c4acebf0950f43eae341db2d41e0a8ff65f5cbad56194
+  data.tar.gz: d9680dfecc27af932856241ab1e269044df8d27e33fb662b55649866dbd83554
 SHA512:
-  metadata.gz: e46aeb79a605c9395704b0cc14d4b8b540c34c119c9ee7d33178fc8d1a384d91fecfc42e92311e7197e36f9cec7cf21cb85e3a29850256643d348eae6571e8d2
-  data.tar.gz: 9f953a7d82a33f19a6309b6ca6abdf5da4b0f5bec294f6f1da8b0aadec47466f335a4df091c8021dd87a9596b0a310bdfa006fd617f03af8e167067a76712d47
+  metadata.gz: 6cd6639f82511f747baebc0aeb4117f42561bd9987a248bfc23bdf4d9cea7f2cf04c60a00de6aefbc7e40cf3cf7861515f17b7e970ef1c7c88d793b6f52b19dd
+  data.tar.gz: 5479a3b76164c023acbe2415805809be3a33850f6fa71930882c507dce92d06ba289d41a2f5d94fca464a084dd7f440717c6fd902666415f2bb57a5c8235f7e1

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release History for gapic-generator
 
+### 0.45.4 / 2025-06-26
+
+* Fix: docs for oneof parameters
+* Fix: remove require when rest operations are not generated
+
 ### 0.45.3 / 2025-06-21
 
 * Fix: correct pagination heuristic for Compute

data/lib/gapic/generator/version.rb

@@ -16,6 +16,6 @@
 
 module Gapic
   module Generator
-    VERSION = "0.45.3"
+    VERSION = "0.45.4"
   end
 end

data/lib/gapic/presenters/field_presenter.rb

@@ -72,8 +72,8 @@ module Gapic
       #   gRPC client classes. Uses the default transport if not provided.
       # @return [String]
       #
-      def doc_description transport: nil
-        @field.docs_leading_comments transport: transport
+      def doc_description transport: nil, is_rpc_param: false
+        @field.docs_leading_comments transport: transport, is_rpc_param: is_rpc_param
       end
 
       def default_value

data/lib/gapic/schema/wrappers.rb

@@ -983,16 +983,22 @@ module Gapic
 
       # @private
       # Override this to add a note related to oneofs being mutually exclusive.
-      def docs_leading_comments disable_xrefs: false, transport: nil
-        str = super
+      def docs_leading_comments disable_xrefs: false, transport: nil, is_rpc_param: false
+        str = super(disable_xrefs: disable_xrefs, transport: transport)
         return str unless @oneof_siblings && @oneof_siblings.size > 1
         siblings = @oneof_siblings.map { |field| "`#{field.name}`" }.join ", "
-        note = "Note: The following fields are mutually exclusive: " \
-               "#{siblings}. If a field in that set is populated, all other " \
-               "fields in the set will automatically be cleared."
+        note =
+          if is_rpc_param
+            "Note: The following parameters are mutually exclusive: #{siblings}. " \
+              "At most one of these parameters can be set. If more than one is set, " \
+              "only one will be used, and it is not defined which one."
+          else
+            "Note: The following fields are mutually exclusive: #{siblings}. " \
+              "If a field in that set is populated, all other fields in the set " \
+              "will automatically be cleared."
+          end
         str ? "#{str.strip}\n\n#{note}" : note
       end
-
       # @!method name
       #   @return [String] the unqualified name of the field.
       # @!method number

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

@@ -15,7 +15,7 @@ require "<%= service.credentials_require %>"
 <%- if service.paths? -%>
 require "<%= service.paths_require %>"
 <%- end -%>
-<%- if service.lro? -%>
+<%- if service.rest.lro? -%>
 require "<%= service.rest.operations_require %>"
 <%- end -%>
 <%- if service.nonstandard_lro_provider? -%>

data/templates/default/service/client/method/docs/_request_normal.text.erb

@@ -19,7 +19,7 @@
 <%- method.arguments.each do |arg| -%>
 #   @param <%= arg.name %> [<%= arg.doc_types %>]
 <%- if arg.doc_description -%>
-<%= indent arg.doc_description(transport: :grpc), "#     " %>
+<%= indent arg.doc_description(transport: :grpc, is_rpc_param: true), "#     " %>
 <%- end -%>
 <%- end -%>
 <%- end -%>

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

@@ -19,7 +19,7 @@
 <%- method.arguments.each do |arg| -%>
 #   @param <%= arg.name %> [<%= arg.doc_types %>]
 <%- if arg.doc_description -%>
-<%= indent arg.doc_description(transport: :rest), "#     " %>
+<%= indent arg.doc_description(transport: :rest, is_rpc_param: true), "#     " %>
 <%- end -%>
 <%- end -%>
 <%- end -%>

metadata

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