Skip to content

chore: demonstrate librarian generate google-cloud-asset (main client) - #35034

Draft
suztomo wants to merge 3 commits into
googleapis:mainfrom
suztomo:demo-generate-asset
Draft

chore: demonstrate librarian generate google-cloud-asset (main client)#35034
suztomo wants to merge 3 commits into
googleapis:mainfrom
suztomo:demo-generate-asset

Conversation

@suztomo

@suztomo suztomo commented Jul 29, 2026

Copy link
Copy Markdown
Member

Demonstrate code generation for the Ruby main client wrapper gem google-cloud-asset via /tmp/librarian generate google-cloud-asset.

Commits:

  1. chore: add google-cloud-asset to librarian.yaml
    • Configures google-cloud-asset in librarian.yaml with wrapper_of: [v1:0.29].
  2. chore: removing OwlBot-related files
    • Removed .OwlBot.yaml and .owlbot-manifest.json.
  3. chore: regenerate the onboarded library using librarian
    • Generated wrapper client files using librarian generate google-cloud-asset (built from latest upstream/main of Librarian & upstream/main of google-cloud-ruby).

Findings

  1. Removal of OwlBot-related files:

    • .OwlBot.yaml and .owlbot-manifest.json deleted as OwlBot postprocessor is superseded by Librarian.
  2. Successful Wrapper Client Generation:

    • librarian generate google-cloud-asset passed ruby.wrapper_of: [v1:0.29] directly to gapic-generator-cloud as --ruby_cloud_opt=ruby-cloud-wrapper-of=v1:0.29.
    • Generated wrapper files: lib/google/cloud/asset.rb, lib/google-cloud-asset.rb, README.md, google-cloud-asset.gemspec, Rakefile, .toys.rb, and test files.
  3. Gemspec description and summary Updates:

    • Both gem.description and gem.summary in google-cloud-asset.gemspec are updated to "The Cloud Asset API manages the history and inventory of Google Cloud resources." (extracted directly from service config description).
  4. Copyright Header Years:

    • Generated header comments in .toys.rb, Rakefile, lib/google-cloud-asset.rb, lib/google/cloud/asset.rb, and test files update copyright years to the current year (2026).
  5. Product Documentation Link in README:

    • README.md omitted the "See also the Product Documentation..." section because ruby-cloud-product-url option was omitted in librarian.yaml (can be configured under ruby_cloud_opts if desired).

gem.description = "A metadata inventory service that allows you to view, monitor, and analyze all your GCP and Anthos assets across projects and services."
gem.summary = "API Client library for the Cloud Asset API"
gem.description = "The Cloud Asset API manages the history and inventory of Google Cloud resources."
gem.summary = "The Cloud Asset API manages the history and inventory of Google Cloud resources."

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be the same as the description???

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's common to have both fields having the same value. There are 54 client gems in google-cloud-ruby where gem.description and gem.summary have identical values. Here are examples:

Gem Name gem.description and gem.summary Value Code Reference (with SHA)
google-cloud-managed_kafka "Manage Apache Kafka clusters and resources." google-cloud-managed_kafka.gemspec#L12-L13
google-cloud-connectors "Enables users to create and manage connections to Google Cloud services and third-party business applications using the Connectors interface." google-cloud-connectors.gemspec#L12-L13
google-cloud-resource_manager "Creates, reads, and updates metadata for Google Cloud Platform resource containers." google-cloud-resource_manager.gemspec#L12-L13
google-cloud-license_manager "License Manager is a tool to manage and track third-party licenses on Google Cloud." google-cloud-license_manager.gemspec#L12-L13
google-cloud-oracle_database "The Oracle Database@Google Cloud API provides a set of APIs to manage Oracle database services, such as Exadata and Autonomous Databases." google-cloud-oracle_database.gemspec#L12-L13
google-cloud-workstations "Allows administrators to create managed developer environments in the cloud." google-cloud-workstations.gemspec#L12-L13
google-cloud-support "Manages Google Cloud technical support cases for Customer Care support offerings." google-cloud-support.gemspec#L12-L13

@suztomo suztomo added the do not merge Indicates a pull request not ready for merge, due to either quality or timing. label Jul 29, 2026
@suztomo suztomo changed the title feat: demonstrate librarian generate google-cloud-asset (main client) chore: demonstrate librarian generate google-cloud-asset (main client) Jul 29, 2026
@suztomo
suztomo force-pushed the demo-generate-asset branch 2 times, most recently from 0e614c7 to d057163 Compare July 29, 2026 14:56
@suztomo
suztomo force-pushed the demo-generate-asset branch from d057163 to f69058b Compare July 29, 2026 15:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do not merge Indicates a pull request not ready for merge, due to either quality or timing.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant