Function document_api_from_discovery_document

describe.py:463–491

Document the given API. Args: discovery_url (str): URI of discovery document. doc_destination_dir (str): relative path where the reference documentation should be saved. artifact_destination_dir (str): relative path where the discovery artifacts should be s

(
    discovery_url, doc_destination_dir, artifact_destination_dir=DISCOVERY_DOC_DIR
)

def document_api_from_discovery_document(
    discovery_url, doc_destination_dir, artifact_destination_dir=DISCOVERY_DOC_DIR
):
    """Document the given API.

    Args:
      discovery_url (str): URI of discovery document.
      doc_destination_dir (str): relative path where the reference
          documentation should be saved.
      artifact_destination_dir (str): relative path where the discovery
          artifacts should be saved.
    """
    http = build_http()
    response, content = http.request(discovery_url)
    discovery = json.loads(content)

    service = build_from_document(discovery)

    name = discovery["version"]
    version = safe_version(discovery["version"])

    document_collection_recursive(
        service,
        "{}_{}.".format(name, version),
        discovery,
        discovery,
        doc_destination_dir,
        artifact_destination_dir,
    )


def generate_all_api_documents(