README.md
1# disco
2
3This directory contains a tool for working with Google's Discovery API and Discovery Format,
4including the ability to convert Discovery Format descriptions to OpenAPI.
5
6Installation:
7
8 go get github.com/googleapis/gnostic
9 go install github.com/googleapis/gnostic/apps/disco
10
11
12Usage:
13
14 disco help
15
16Prints a list of commands and options.
17
18 disco list [--raw]
19
20Calls the Google Discovery API and lists available APIs.
21The `--raw` option prints the raw results of the Discovery List APIs call.
22
23 disco get [<api>] [<version>] [--raw] [--openapi2] [--openapi3] [--features] [--schemas] [--all]
24
25Gets the specified API and version from the Google Discovery API.
26`<version>` can be omitted if it is unique.
27The `--raw` option saves the raw Discovery Format description.
28The `--openapi2` option rewrites the API description in OpenAPI v2.
29The `--openapi3` option rewrites the API description in OpenAPI v3.
30The `--features` option displays the contents of the `features` sections of discovery documents.
31The `--schemas` option displays information about the schemas defined for the API.
32The `--all` option runs the other associated operations for all of the APIs available from the Discovery Service.
33When `--all` is specified, `<api>` and `<version>` should be omitted.
34
35 disco <file> [--openapi2] [--openapi3] [--features] [--schemas]
36
37Applies the specified operations to a local file. See the `get` command for details.
38
39