Skip to content

GEMINI.md

Latest commit

 

History

History
55 lines (33 loc) · 3.13 KB

GEMINI.md

File metadata and controls

55 lines (33 loc) · 3.13 KB

Gemini CLI Context for sdk-platform-java

1. Overview

This directory, sdk-platform-java, contains the foundational components for building Java client libraries for Google Cloud Platform services. It includes the GAPIC (Generated API Client) generator for Java, the GAX (Google API Extensions) runtime library, and other shared modules.

For general project rules, style guides, dependency management, and contribution guidelines, please refer to the root AGENTS.md.

2. Project Structure

The repository is structured into several key modules:

  • gapic-generator-java: The core component for creating new client libraries. It is a Protobuf compiler plugin that generates Java client libraries from API definition files. The DEVELOPMENT.md file in this module provides detailed information on how to work with the generator.

  • gax-java: The Google API Extensions for Java (GAX) library. It provides runtime support for the generated client libraries, including features like pagination, request batching, and polling of long-running operations. It has the following submodules:

    • gax: Transport-independent part of GAX for Java.
    • gax-grpc: gRPC-specific logic for GAX.
    • gax-httpjson: REST-specific logic for GAX.

  • api-common-java: Contains foundational types and utilities related to Google APIs. It includes the following packages:

    • core: Core library containing API stability annotations and wrappers around Guava types.
    • pathtemplate: Path Template library for manipulating strings that are formatted as Google API resource names.
    • resourcenames: Resource Name library used by generated resource name types.

  • java-common-protos: Provides Protobuf-generated classes for common Google services that are used across multiple APIs. The code is in this module is auto-generated and should not be modified.

  • java-iam: Contains Protobuf-generated classes for Google's Identity and Access Management (IAM) service, used for managing policies. The code is in this module is auto-generated and should not be modified.

  • java-showcase: A demonstration client library for the "Showcase" API, which is a fake API used for integration testing of the GAPIC generator and GAX library.

  • java-shared-dependencies: Manages shared Maven dependencies for all Google Cloud Java client libraries. This ensures consistency and helps avoid dependency conflicts.

3. Testing

For detailed testing strategy and heuristics on which tests to run based on code changes, please refer to DEVELOPMENT.md.

3.1. Running Unit Tests

Unit tests can be tested via this command:

mvn test

3.2. Running Golden Integration Tests

Golden integration tests are run using Bazel. To run all golden integration tests, use the following command from the root of the repository:

bazelisk test //...

3.3. Running Showcase Integration Tests

Showcase integration tests are run against a local server that implements the Showcase API. The java-showcase/README.md file provides detailed instructions on how to run these tests.