Skip to content

feat(hypercomputecluster): generate library#16013

Merged
scotthart merged 5 commits intogoogleapis:mainfrom
scotthart:feat-hypercomputecluster-generate-library
Feb 27, 2026
Merged

feat(hypercomputecluster): generate library#16013
scotthart merged 5 commits intogoogleapis:mainfrom
scotthart:feat-hypercomputecluster-generate-library

Conversation

@scotthart
Copy link
Member

No description provided.

@scotthart scotthart requested a review from a team as a code owner February 27, 2026 21:32
@gemini-code-assist
Copy link

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on the foundational work of generating and integrating the C++ client library for the Google Cloud Hypercompute Cluster API. It sets up the necessary build infrastructure, documentation, and code generation configurations to support the new service, allowing developers to programmatically manage hypercompute clusters.

Highlights

  • New Library Generation: The pull request introduces the C++ client library for the Google Cloud Hypercompute Cluster API, enabling users to interact with the service for managing AI, ML, and HPC clusters.
  • Build System Integration: The new library is integrated into the project's build systems, including Bazel and CMake, with updated configurations and dependencies.
  • Documentation and Examples: Comprehensive documentation, quickstart guides, and client samples are added to facilitate easy adoption and usage of the new Hypercompute Cluster C++ client library.
  • CI/CD and Configuration Updates: Continuous Integration (CI) scripts and generator configurations are updated to recognize and properly handle the newly added hypercomputecluster library.
Changelog
  • CHANGELOG.md
    • Added 'Cluster Director API' to the list of GA libraries.
  • README.md
    • Added 'Cluster Director API' with quickstart and reference links to the main README.
  • ci/cloudbuild/builds/check-api.sh
    • Modified the check_abi function to include a condition for 'hypercomputecluster' libraries.
  • ci/etc/expected_install_directories
    • Added expected install directories for 'hypercomputecluster' headers and CMake files.
  • cmake/GoogleCloudCppFeatures.cmake
    • Added 'hypercomputecluster' to the list of GA libraries.
  • external/googleapis/protodeps/hypercomputecluster.deps
    • Added protobuf dependencies for the 'hypercomputecluster' service.
  • external/googleapis/protolists/hypercomputecluster.list
    • Added proto files for the 'hypercomputecluster' service.
  • external/googleapis/update_libraries.sh
    • Added 'hypercomputecluster' to the list of libraries to be updated.
  • generator/generator_config.textproto
    • Added service configuration for 'Hypercompute Cluster' including proto path, product path, initial copyright year, and retryable status codes.
  • google/cloud/hypercomputecluster/BUILD.bazel
    • Added Bazel build file for the 'hypercomputecluster' library.
  • google/cloud/hypercomputecluster/CMakeLists.txt
    • Added CMake build file for the 'hypercomputecluster' library, including quickstart executable and test configuration.
  • google/cloud/hypercomputecluster/README.md
    • Added a README file providing an overview, quickstart, and more information for the Cluster Director API C++ Client Library.
  • google/cloud/hypercomputecluster/doc/environment-variables.dox
    • Added Doxygen documentation for environment variables related to the Hypercompute Cluster library.
  • google/cloud/hypercomputecluster/doc/main.dox
    • Added the main Doxygen page for the Cluster Director API C++ Client Library, including quickstart snippet and main classes.
  • google/cloud/hypercomputecluster/doc/options.dox
    • Added Doxygen documentation for configuration options specific to the Cluster Director API.
  • google/cloud/hypercomputecluster/doc/override-authentication.dox
    • Added Doxygen documentation for overriding authentication credentials for the Hypercompute Cluster client.
  • google/cloud/hypercomputecluster/doc/override-endpoint.dox
    • Added Doxygen documentation for overriding the default endpoint for the Hypercompute Cluster client.
  • google/cloud/hypercomputecluster/doc/override-retry-policies.dox
    • Added Doxygen documentation for overriding retry, backoff, and idempotency policies for the Hypercompute Cluster client.
  • google/cloud/hypercomputecluster/doc/override-universe-domain.dox
    • Added Doxygen documentation for overriding the default universe domain for the Hypercompute Cluster client.
  • google/cloud/hypercomputecluster/quickstart/.bazelrc
    • Added Bazel configuration file for the quickstart, specifying C++ standard and convenience symlinks.
  • google/cloud/hypercomputecluster/quickstart/BUILD.bazel
    • Added Bazel build file for the quickstart executable.
  • google/cloud/hypercomputecluster/quickstart/CMakeLists.txt
    • Added CMake build file for the quickstart example, linking against the 'hypercomputecluster' library.
  • google/cloud/hypercomputecluster/quickstart/Makefile
    • Added a Makefile for building the quickstart example using pkg-config.
  • google/cloud/hypercomputecluster/quickstart/README.md
    • Added a README file for the quickstart, detailing how to use the client library with Bazel and CMake.
  • google/cloud/hypercomputecluster/quickstart/WORKSPACE.bazel
    • Added a Bazel workspace file for the quickstart, fetching google-cloud-cpp dependencies.
  • google/cloud/hypercomputecluster/quickstart/quickstart.cc
    • Added the quickstart C++ code demonstrating basic usage of the Hypercompute Cluster client.
  • google/cloud/hypercomputecluster/v1/.repo-metadata.json
    • Added repository metadata for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/hypercompute_cluster_client.cc
    • Added the generated C++ client implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/hypercompute_cluster_client.h
    • Added the generated C++ client header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/hypercompute_cluster_connection.cc
    • Added the generated connection implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/hypercompute_cluster_connection.h
    • Added the generated connection header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/hypercompute_cluster_connection_idempotency_policy.cc
    • Added the generated idempotency policy implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/hypercompute_cluster_connection_idempotency_policy.h
    • Added the generated idempotency policy header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/hypercompute_cluster_options.h
    • Added the generated options header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_auth_decorator.cc
    • Added the generated authentication decorator implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_auth_decorator.h
    • Added the generated authentication decorator header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_connection_impl.cc
    • Added the generated connection implementation details for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_connection_impl.h
    • Added the generated connection implementation header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_logging_decorator.cc
    • Added the generated logging decorator implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_logging_decorator.h
    • Added the generated logging decorator header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_metadata_decorator.cc
    • Added the generated metadata decorator implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_metadata_decorator.h
    • Added the generated metadata decorator header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_option_defaults.cc
    • Added the generated option defaults implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_option_defaults.h
    • Added the generated option defaults header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_retry_traits.h
    • Added the generated retry traits header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_sources.cc
    • Added the generated sources file for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_stub.cc
    • Added the generated stub implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_stub.h
    • Added the generated stub header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_stub_factory.cc
    • Added the generated stub factory implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_stub_factory.h
    • Added the generated stub factory header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_tracing_connection.cc
    • Added the generated tracing connection implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_tracing_connection.h
    • Added the generated tracing connection header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_tracing_stub.cc
    • Added the generated tracing stub implementation for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/internal/hypercompute_cluster_tracing_stub.h
    • Added the generated tracing stub header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/mocks/mock_hypercompute_cluster_connection.h
    • Added the generated mock connection header for the Hypercompute Cluster v1 API.
  • google/cloud/hypercomputecluster/v1/samples/hypercompute_cluster_client_samples.cc
    • Added the generated client samples for the Hypercompute Cluster v1 API.
  • libraries.bzl
    • Added 'hypercomputecluster' to the list of GA libraries.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request adds the generated C++ client library for the Cluster Director API (hypercomputecluster). The changes are mostly adding new files and updating configuration to include the new library. I've found a few minor issues with alphabetical ordering in documentation files and a more significant issue with the copyright year being set to a future date in the generator configuration.

service {
service_proto_path: "google/cloud/hypercomputecluster/v1/hypercompute_cluster.proto"
product_path: "google/cloud/hypercomputecluster/v1"
initial_copyright_year: "2026"

Choose a reason for hiding this comment

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

high

The initial_copyright_year is set to "2026", which is in the future. This seems to be a typo. Please set it to the current year to ensure all generated files have the correct copyright year.

the APIs in these libraries are stable, and are ready for production use.

- [Gemini Enterprise for Customer Experience API](google/cloud/ces/README.md)
- [Cluster Director API](google/cloud/hypercomputecluster/README.md)

Choose a reason for hiding this comment

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

medium

To maintain alphabetical order in this list, this new entry for "Cluster Director API" should be placed before "Gemini Enterprise for Customer Experience API".

Comment on lines +320 to +322
- [Cluster Director API](google/cloud/hypercomputecluster/README.md)
[[quickstart]](google/cloud/hypercomputecluster/quickstart/README.md)
[[reference]](https://cloud.google.com/cpp/docs/reference/hypercomputecluster/latest)

Choose a reason for hiding this comment

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

medium

To maintain alphabetical order in this list, this new entry for "Cluster Director API" should be placed before "GKE Recommender API".

@scotthart scotthart enabled auto-merge (squash) February 27, 2026 21:49
@scotthart scotthart merged commit 07a9fce into googleapis:main Feb 27, 2026
57 of 64 checks passed
@codecov
Copy link

codecov bot commented Feb 27, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.64%. Comparing base (fbbfe53) to head (35d269a).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #16013   +/-   ##
=======================================
  Coverage   92.63%   92.64%           
=======================================
  Files        2333     2333           
  Lines      214631   214631           
=======================================
+ Hits       198827   198846   +19     
+ Misses      15804    15785   -19     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants