2022-07-07 20:11:50 +00:00
|
|
|
# Internal
|
|
|
|
|
|
|
|
|
|
This directory contains internal code for cloud.google.com/go packages.
|
|
|
|
|
|
|
|
|
|
## .repo-metadata-full.json
|
|
|
|
|
|
|
|
|
|
`.repo-metadata-full.json` contains metadata about the packages in this repo. It
|
|
|
|
|
is generated by `internal/gapicgen/generator`. It's processed by external tools
|
|
|
|
|
to build lists of all of the packages.
|
|
|
|
|
|
|
|
|
|
Don't make breaking changes to the format without consulting with the external
|
|
|
|
|
tools.
|
|
|
|
|
|
|
|
|
|
One day, we may want to create individual `.repo-metadata.json` files next to
|
|
|
|
|
each package, which is the pattern followed by some other languages. External
|
|
|
|
|
tools would then talk to pkg.go.dev or some other service to get the overall
|
|
|
|
|
list of packages and use the `.repo-metadata.json` files to get the additional
|
2024-02-24 00:34:55 +00:00
|
|
|
metadata required. For now, `.repo-metadata-full.json` includes everything.
|
|
|
|
|
|
|
|
|
|
### Updating OwlBot SHA
|
|
|
|
|
|
|
|
|
|
You may want to manually update the which version of the post-processor will be
|
|
|
|
|
used -- to do this you need to update the SHA in the OwlBot lock file.
|
|
|
|
|
|
|
|
|
|
See the [postprocessor/README](postprocessor/README.md) for detailed
|
|
|
|
|
instructions.
|
|
|
|
|
|
|
|
|
|
*Note*: OwlBot will eventually open a pull request to update this value if it
|
|
|
|
|
discovers a new version of the container.
|
