disco

README

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.

Documentation

Overview

Copyright 2017 Google Inc. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.