.. | ||
list.go | ||
main.go | ||
openapiv2.go | ||
openapiv3.go | ||
README.md |
disco
This directory contains a tool for working with Google's Discovery API and Discovery Format, including the ability to convert Discovery Format descriptions to OpenAPI.
Installation:
go get github.com/googleapis/gnostic
go install github.com/googleapis/gnostic/apps/disco
Usage:
disco help
Prints a list of commands and options.
disco list [--raw]
Calls the Google Discovery API and lists available APIs.
The --raw
option prints the raw results of the Discovery List APIs call.
disco get [<api>] [<version>] [--raw] [--openapi2] [--openapi3] [--features] [--schemas] [--all]
Gets the specified API and version from the Google Discovery API.
<version>
can be omitted if it is unique.
The --raw
option saves the raw Discovery Format description.
The --openapi2
option rewrites the API description in OpenAPI v2.
The --openapi3
option rewrites the API description in OpenAPI v3.
The --features
option displays the contents of the features
sections of discovery documents.
The --schemas
option displays information about the schemas defined for the API.
The --all
option runs the other associated operations for all of the APIs available from the Discovery Service.
When --all
is specified, <api>
and <version>
should be omitted.
disco <file> [--openapi2] [--openapi3] [--features] [--schemas]
Applies the specified operations to a local file. See the get
command for details.