Google Git
Sign in
fuchsia / third_party / github.com / googleapis / google-api-go-client / refs/heads/upstream/main / . / google-api-go-generator
tree: e943c972fb23b92adfd9f8781d16c199012672da [path history] [tgz]
  1. internal/
  2. testdata/
  3. clients_test.go
  4. docurls.go
  5. gen.go
  6. gen_test.go
  7. Makefile
  8. paging_test.go
  9. README.md
  10. replacements.go
  11. replacements_test.go
google-api-go-generator/README.md

google-api-go-generator

This package is the discovery client generator for Go. It is used to generate all of the client libraries in this repository

Flags

  • api (string): The API ID to generate, like ‘tasks:v1’. A value of * means all. (default “*”)
  • api_json_file (string): If non-empty, the path to a local file on disk containing the API to generate. Exclusive with setting --api.
  • api_pkg_base (string):Go package prefix to use for all generated APIs. (default “google.golang.org/api”)
  • base_url (string): (optional) Override the default service API URL. If empty, the service's root URL will be used.
  • build (bool): Compile generated packages.
  • cache (bool): Use cache of discovered Google API discovery documents. (default true)
  • copyright_year (string): Year for copyright. (default “2024”)
  • discoveryurl (string): URL to root discovery document (default “www.googleapis.com/discovery/v1/apis”)
  • gendir (string): Directory to use to write out generated Go files
  • gensupport_pkg (string): Go package path of the ‘api/internal/gensupport’ support package. (default “google.golang.org/api/internal/gensupport”)
  • googleapi_pkg (string): Go package path of the ‘api/googleapi’ support package. (default “google.golang.org/api/googleapi”)
  • header_path (string): If non-empty, prepend the contents of this file to generated services.
  • htransport_pkg (string): Go package path of the ‘api/transport/http’ support package. (default “google.golang.org/api/transport/http”)
  • install (bool): Install generated packages.
  • internal_pkg (string): Go package path of the ‘internal’ support package. (default “google.golang.org/api/internal”)
  • internaloption_pkg (string): Go package path of the ‘api/option/internaloption’ support package. (default “google.golang.org/api/option/internaloption”)
  • option_pkg (string): Go package path of the ‘api/option’ support package. (default “google.golang.org/api/option”)
  • output (string): (optional) Path to source output file. If not specified, the API name and version are used to construct an output path (e.g. tasks/v1).
  • publiconly (bool): Only build public, released APIs. Only applicable for Google employees. (default true)

Automated usage

This generator runs daily via the automated bash script: discogen.sh.

Example local usage

Run same command the automation uses

make all

Generate a client from a local discovery document

go build -o google-api-go-generator && ./google-api-go-generator -cache=true -install -api_json_file=/path/to/file

Refresh an existing client

go build -o google-api-go-generator && ./google-api-go-generator -cache=false -install -api=sevicename:vsomething -gendir=..