gapic-generator-ads 0.11.0 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 834f052deb4a802fcb21ef5764f4fce4a1a6e018105304e1e76f6442458d4fee
-  data.tar.gz: e62c901264ff89f0c1bcfacbd7d48df22327879342e182f4030f997c9a1fedea
+  metadata.gz: 866ff2324d7ceee4b9cfc182027ca0b0bff20c5373eabd83bd6ef82c161d47c7
+  data.tar.gz: a6301659b626dfcb24dbb97351e56054429c34c02ea56b14e2af7614156e21d1
 SHA512:
-  metadata.gz: bc90e66bc292ae230751b15e5652465265c189bd621c2242a5d313de0b046ad7ebe80760f9c768c6ceed24e8f63a551313dfcd812bfe9f5c0f1af674403e381e
-  data.tar.gz: 50321b8dafa9de2763b5122956963ac1499cb85dcc667844fd23baa799a1fdf798dd65d758313335ed8e809db7f5c3d26ea09713ba9c55f3cbe9a9f247e610d6
+  metadata.gz: ebba65e93e166e49200035ff8c52d8d7729220e0cefcd44f3294c83d34f5109fb3d97e7e398d407f5dfb21c00413443d58850603161d42cf6bc14ee9a547abcc
+  data.tar.gz: 420fe85c0fe2c1a4d392b3151ed88c52ef70f74180cbb5bfcfd5370e5ae7f44431dad7339ad4d911354325af8e1412805cf22f66886b77ea986576883c7d0cb0

data/CHANGELOG.md

@@ -1,5 +1,260 @@
 # Release History for gapic-generator-ads
 
+### 0.43.0 / 2025-04-24
+
+* Includes changes from gapic-generator 0.43.0
+* Fix: Fixed typo in generated wrapper readmes
+* Fix: Provide a better check for grpc when typechecking credentials
+
+### 0.42.1 / 2025-02-04
+
+* Includes changes from gapic-generator 0.42.1
+* Fix: Wrappers load release dependencies if local dependencies do not match
+
+### 0.42.0 / 2025-01-30
+
+* Includes changes from gapic-generator 0.42.0
+
+### 0.41.0 / 2025-01-24
+
+* Includes changes from gapic-generator 0.41.0
+
+### 0.40.0 / 2025-01-24
+
+* Includes changes from gapic-generator 0.40.0
+
+### 0.39.2 / 2025-01-24
+
+* Includes changes from gapic-generator 0.39.2
+
+### 0.39.1 / 2025-01-23
+
+* Includes changes from gapic-generator 0.39.1
+
+### 0.39.0 / 2025-01-22
+
+* Includes changes from gapic-generator 0.39.0
+
+### 0.38.3 / 2024-12-10
+
+* Includes changes from gapic-generator 0.38.3
+
+### 0.38.2 / 2024-12-10
+
+* Includes changes from gapic-generator 0.38.2
+
+### 0.38.1 / 2024-12-09
+
+* Includes changes from gapic-generator 0.38.1
+
+### 0.38.0 / 2024-12-06
+
+* Includes changes from gapic-generator 0.38.0
+* Feature: Support request-response debug logging from generated GAPICs
+
+### 0.37.0 / 2024-10-24
+
+* Includes changes from gapic-generator 0.37.0
+
+### 0.36.1 / 2024-09-20
+
+* Includes changes from gapic-generator 0.36.1
+
+### 0.36.0 / 2024-08-22
+
+* Includes changes from gapic-generator 0.36.0
+
+### 0.35.0 / 2024-08-15
+
+* Includes changes from gapic-generator 0.35.0
+
+### 0.34.1 / 2024-08-08
+
+* Includes changes from gapic-generator 0.34.1
+
+### 0.34.0 / 2024-08-07
+
+* Includes changes from gapic-generator 0.34.0
+
+### 0.33.0 / 2024-07-02
+
+* Includes changes from gapic-generator 0.33.0
+
+### 0.32.0 / 2024-05-13
+
+* Includes changes from gapic-generator 0.32.0
+
+### 0.31.0 / 2024-04-25
+
+* Includes changes from gapic-generator 0.31.0
+
+### 0.30.0 / 2024-04-24
+
+* Includes changes from gapic-generator 0.30.0
+
+### 0.29.0 / 2024-02-22
+
+* Includes changes from gapic-generator 0.29.0
+* Fix: update gemfiles and set bundle platforms to x86_64-linux
+
+### 0.28.0 / 2024-02-14
+
+* Includes changes from gapic-generator 0.28.0
+* Feature: introduce auto_populated_fields (uuid4) to generator
+
+### 0.27.4 / 2024-01-12
+
+* Includes changes from gapic-generator 0.27.4
+
+### 0.27.3 / 2024-01-12
+
+* Includes changes from gapic-generator 0.27.3
+
+### 0.27.2 / 2024-01-11
+
+* Includes changes from gapic-generator 0.27.2
+
+### 0.27.1 / 2024-01-09
+
+* Includes changes from gapic-generator 0.27.1
+
+### 0.27.0 / 2024-01-08
+
+* Includes changes from gapic-generator 0.27.0
+* Feature: Update rubocop autofix to use Rubocop 1.59
+
+### 0.26.0 / 2023-12-04
+
+* Includes changes from gapic-generator 0.26.0
+* Feature: Use google-protobuf instead of third-party protobuf library
+* Fix: clean up and update gem dependencies
+
+### 0.25.1 / 2023-09-12
+
+* Includes changes from gapic-generator 0.25.1
+* Fix: Workaround for grpc windows issue during tests
+
+### 0.25.0 / 2023-09-07
+
+* Includes changes from gapic-generator 0.25.0
+
+### 0.24.0 / 2023-07-05
+
+* Includes changes from gapic-generator 0.24.0
+
+### 0.23.4 / 2023-06-03
+
+* Includes changes from gapic-generator 0.23.4
+
+### 0.23.3 / 2023-05-26
+
+* Includes changes from gapic-generator 0.23.3
+* Fix: Generated clients depend on gapic-common 0.19
+
+### 0.23.2 / 2023-03-08
+
+* Includes changes from gapic-generator 0.23.2
+
+### 0.23.1 / 2023-02-28
+
+* Includes changes from gapic-generator 0.23.1
+
+### 0.23.0 / 2023-02-27
+
+* Includes changes from gapic-generator 0.23.0
+
+### 0.22.0 / 2023-02-14
+
+* Includes changes from gapic-generator 0.22.0
+
+### 0.21.1 / 2023-02-13
+
+* Includes changes from gapic-generator 0.21.1
+* Fix: Get rubocop working in bazel
+
+### 0.21.0 / 2023-02-09
+
+* Includes changes from gapic-generator 0.21.0
+* Feature: Implemented enough of SnippetGen phase 2 to generate the initial test case
+
+### 0.20.0 / 2023-01-19
+
+* Includes changes from gapic-generator 0.20.0
+
+### 0.19.0 / 2023-01-17
+
+* Includes changes from gapic-generator 0.19.0
+
+### 0.18.1 / 2022-12-15
+
+* Includes changes from gapic-generator 0.18.1
+
+### 0.18.0 / 2022-12-15
+
+* Includes changes from gapic-generator 0.18.0
+* Fix: Cross-ref links use the REST client class in REST client docs
+* Feature: Updated wrapper generator to support multi-transport clients
+
+### 0.17.2 / 2022-10-27
+
+* Includes changes from gapic-generator 0.17.2
+
+### 0.17.1 / 2022-10-26
+
+* Includes changes from gapic-generator 0.17.1
+
+### 0.17.0 / 2022-10-21
+
+* Includes changes from gapic-generator 0.17.0
+
+### 0.16.1 / 2022-09-27
+
+* Includes changes from gapic-generator 0.16.1
+
+### 0.16.0 / 2022-09-16
+
+* Includes changes from gapic-generator 0.16.0
+* Feature: Support numeric enums
+
+### 0.15.3 / 2022-08-18
+
+* Includes changes from gapic-generator 0.15.3
+* Fix: Fix out of date SDK auth documentation
+
+### 0.15.2 / 2022-07-27
+
+* Includes changes from gapic-generator 0.15.2
+
+### 0.15.1 / 2022-07-26
+
+* Includes changes from gapic-generator 0.15.1
+
+### 0.15.0 / 2022-07-25
+
+* Includes changes from gapic-generator 0.15.0
+
+### 0.14.1 / 2022-06-29
+
+* Includes changes from gapic-generator 0.14.1
+
+### 0.14.0 / 2022-06-27
+
+* Includes changes from gapic-generator 0.14.0
+* Feature: Update minimum Ruby version to 2.6
+
+### 0.13.0 / 2022-05-11
+
+* Includes changes from gapic-generator 0.13.0
+
+### 0.12.0 / 2022-04-29
+
+* Includes changes from gapic-generator 0.12.0
+* Feature: Generate snippet metadata files
+
+### 0.11.1 / 2022-04-06
+
+* Includes changes from gapic-generator 0.11.1
+
 ### 0.11.0 / 2022-03-01
 
 * Includes changes from gapic-generator 0.11.0

data/README.md

@@ -1,69 +1,105 @@
-# Ads Generator for Ruby
+# API Client Generator for Ruby
 
 Create Ruby clients from a protocol buffer description of an API.
 
-**Note** This project is a preview. Please try it out and let us know what you think,
-but there are currently no guarantees of stability or support.
+This code is used to generate client libraries for many Google APIs including
+Cloud and Ads services. The `gapic-generator` gem itself includes the main
+generator, whereas the `gapic-generator-cloud` and `gapic-generator-ads` gems
+provide modifications specific to Google Cloud and Google Ads APIs.
 
-## Usage
-### Install the Proto Compiler
-This generator relies on the Protocol Buffer Compiler to [orchestrate] the
-client generation.
+These gems can also be used to create clients for any other API, for Google or
+non-Google services, that use protocol buffers as the description language. The
+generators will work best for APIs that follow the design guidance documented
+in the [Google AIPs](https://aip.dev/). An API that is not AIP-compliant should
+still yield a usable client library, but it may be missing features such as
+idiomatic naming, pagination, or retry configuration.
 
-```sh
-# Declare the protobuf version to use.
-$ export PROTOBUF_VERSION=3.6.1
+**Important:** 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.
 
-# Declare the target installation system.
-# export SYSTEM=osx
-$ export SYSTEM=linux
+## Using the Ruby gem
 
-# Get the precompiled protobuf compiler.
-$ curl --location https://github.com/google/protobuf/releases/download/v${PROTOBUF_VERSION}/protoc-${PROTOBUF_VERSION}-linux-x86_64.zip > usr/src/protoc/protoc-${PROTOBUF_VERSION}.zip
-$ cd /usr/src/protoc/
-$ unzip protoc-${PROTOBUF_VERSION}.zip
-$ rm protoc-${PROTOBUF_VERSION}.zip
+This section provides a brief getting started guide for the Ruby gem. However,
+we do not release the Ruby gems often, and they may be substantially behind the
+current generator code. In most cases, we recommend generating from the
+GitHub repository directly. See the main README for
+https://github.com/googleapis/gapic-generator-ruby for more information.
 
-# Link the protoc to the path.
-$ ln -s /usr/src/protoc/bin/protoc /usr/local/bin/protoc
-$ mkdir -p /protos/
+### Install the Generator
 
-# Move the common protobuf files to the local include folder.
-$ cp -R /usr/src/protoc/include/* /usr/local/include/
-```
+The generator is a plugin for **protoc**, the protocol buffers compiler, so
+you'll need to install it first, along with the standard protobuf and grpc
+plugins for Ruby. The easiest way to do this is to install the `grpc-tools` gem
+which will provide all three. You can also follow the
+[official install instructions](https://github.com/protocolbuffers/protobuf#protobuf-compiler-installation).
+Note that if you installed protoc using `grpc-tools`, the compiler binary name
+will be named `grpc_tools_ruby_protoc`; otherwise it will likely be `protoc`.
+
+Install the `gapic-generator` gem to get access to the gapic generator plugin.
+Since you are looking at the `gapic-generator-ads` gem's README, we will
+assume you want Ads-specific output, so also install `gapic-generator-ads`.
 
-[orchestrate]: https://developers.google.com/protocol-buffers/docs/reference/ruby-generated
+Alternatively, add all the above to a Gemfile:
 
-### Build and Install the Generator
-This tool is in pre-alpha so it is not yet released to RubyGems. You will have to
-build the generator from scratch.
+```ruby
+# Gemfile
+source "https://rubygems.org/"
+
+gem "grpc-tools"
+gem "gapic-generator"
+gem "gapic-generator-ads"
+```
+
+And install using bundler:
 
 ```sh
-$ git clone https://github.com/googleapis/gapic-generator-ruby.git
-$ cd gapic-generator-ruby
-$ gem build gapic-generator.gemspec
-$ gem install gapic-generator-0.1.0.gem
-$ which protoc-gen-ruby_gapic
-> {Non-empty path}
+$ bundle install
 ```
 
 ### Generate an API
-Installing this generator exposes `protoc-gen-ruby_gapic` on the PATH. By doing
-so, it gives the protobuf compiler the CLI option `--ruby_gapic_out` on which
-you can specify an output path for this generator.
 
-If you want to experiment with an already-existing API, one example is available.
-Note: You need to clone the googleapis repository from GitHub, and change
-to a special branch:
+Installing the cloud-specific generator exposes `protoc-gen-ruby_ads` on the
+PATH. (Note that this name is different from the `protoc-gen-ruby_gapic` plugin
+exposed by the basic generator.) By doing so, it gives the protobuf compiler
+the CLI option `--ruby_ads_out` on which you can specify an output path for
+this generator.
+
+In most cases, in order to generate a functional client library, you must also
+include the Ruby proto and grpc plugins, using the CLI options `--ruby_out` and
+`--grpc_out`.
+
+If you want to experiment with an already-existing API, you can use one of the
+existing Google APIs from https://github.com/googleapis/googleapis.
+First you should get the protos and dependencies:
+
 ```sh
-# Get the protos and it's dependencies.
-$ git clone git@github.com:googleapis/api-common-protos.git
 $ git clone git@github.com:googleapis/googleapis.git
-$ cd googleapis
-$ git checkout --track -b input-contract origin/input-contract
+```
+
+Now you're ready to compile the API. For example, to compile the Ads V15 API:
 
-# Now you're ready to compile the API.
-$ protoc google/ads/vision/v1/*.proto \
-    --proto_path=../api-common-protos/ --proto_path=. \
-    --ruby_gapic_out=/dest/
+```sh
+$ grpc_tools_ruby_protoc google/ads/googleads/v15/*/*.proto \
+    --proto_path=googleapis/ \
+    --ruby_out=/path/to/dest/ \
+    --grpc_out=/path/to/dest/ \
+    --ruby_ads_out=/path/to/dest/ \
 ```
+
+Note: most real-world client libraries require additional options to be passed
+to the generator, via the `--ruby_ads_opt` flag. Those options are not covered
+in this document.
+
+## Support
+
+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,
+we will make an effort to ensure it is supported on non-end-of-life versions of
+Ruby.
+
+Issues can be filed on GitHub at
+https://github.com/googleapis/gapic-generator-ruby/issues.

data/bin/protoc-gen-bazel_ruby_ads

@@ -20,7 +20,7 @@ $LOAD_PATH.unshift ::File.expand_path("../../gapic-generator/lib", __dir__)
 
 require "gapic/generator/version"
 require "gapic/runner"
-require "google/protobuf/compiler/plugin.pb"
+require "google/protobuf/compiler/plugin_pb"
 
 # Ensure that no encoding conversions are done on STDIN and STDOUT
 # since we are passing binary data back and forth. Otherwise these
@@ -33,4 +33,4 @@ request = Google::Protobuf::Compiler::CodeGeneratorRequest.decode $stdin.read
 # Run the request, specifying the ads generator
 response = Gapic::Runner.run request, generator: :ads
 
-$stdout.print response.serialize
+$stdout.print Google::Protobuf::Compiler::CodeGeneratorResponse.encode response

data/bin/protoc-gen-ruby_ads

@@ -19,7 +19,7 @@ $LOAD_PATH.unshift ::File.expand_path("../lib", __dir__)
 gem "gapic-generator"
 require "gapic/generator/version"
 require "gapic/runner"
-require "google/protobuf/compiler/plugin.pb"
+require "google/protobuf/compiler/plugin_pb"
 
 # Ensure that no encoding conversions are done on STDIN and STDOUT
 # since we are passing binary data back and forth. Otherwise these
@@ -32,4 +32,4 @@ request = Google::Protobuf::Compiler::CodeGeneratorRequest.decode $stdin.read
 # Run the request, specifying the ads generator
 response = Gapic::Runner.run request, generator: :ads
 
-$stdout.print response.serialize
+$stdout.print Google::Protobuf::Compiler::CodeGeneratorResponse.encode response

data/lib/gapic/generator/ads/version.rb

@@ -18,7 +18,7 @@
 module Gapic
   module Generator
     module Ads
-      VERSION = "0.11.0"
+      VERSION = "0.43.0"
     end
   end
 end

metadata

@@ -1,130 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: gapic-generator-ads
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.43.0
 platform: ruby
 authors:
 - Ernest Landrito
 - Chris Smith
 - Mike Moore
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-28 00:00:00.000000000 Z
+date: 2025-04-24 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: actionpack
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: gapic-generator
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.43.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.11.0
-- !ruby/object:Gem::Dependency
-  name: protobuf
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.8'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.8'
-- !ruby/object:Gem::Dependency
-  name: google-style
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.25.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.25.1
-- !ruby/object:Gem::Dependency
-  name: grpc-tools
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.41.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.41.0
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: minitest-focus
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '12.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '12.0'
-description: 
+        version: 0.43.0
 email:
 - landrito@google.com
 - quartzmo@gmail.com
@@ -149,7 +49,6 @@ homepage: https://github.com/googleapis/gapic-generator-ruby
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -157,15 +56,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.6.5
 specification_version: 4
 summary: An API Client Generator for Ruby in Ruby!
 test_files: []