Skip to main content

Google API Client Generator for Python

Project description

release level pypi versions

A generator for protocol buffer described APIs for and in Python 3.

This is a generator for API client libraries for APIs specified by protocol buffers, such as those inside Google. It takes a protocol buffer (with particular annotations) and uses it to generate a client library.

Purpose

This library replaces the monolithic generator with some improvements:

  • An explicit normalized format for specifying APIs.

  • Light weight, in-language code generators.

Bazel

This generator can be called from Bazel, which is a recommended way of using it inside a continuous integration build or any other automated pipeline.

Clone the googleapis repository $ git clone https://github.com/googleapis/googleapis.git

Create the targets

You need to add the following targets to your BUILD.bazel file.

load(
    "@gapic_generator_python//rules_python_gapic:py_gapic.bzl",
    "py_gapic_library"
)

load(
    "@gapic_generator_python//rules_python_gapic:py_gapic_pkg.bzl",
    "py_gapic_assembly_pkg"
)

py_gapic_library(
    name = "documentai_py_gapic",
    srcs = [":documentai_proto"],
)

py_gapic_assembly_pkg(
    name = "documentai-v1beta2-py",
    deps = [
        ":documentai_py_gapic",
    ],
)

Compiling an API

Using Bazel:

bazel build //google/cloud/documentai/v1beta2:documentai-v1beta2-py

Using Protoc:

# This is assumed to be in the `googleapis` project root.
$ protoc google/cloud/vision/v1/*.proto \
    --python_gapic_out=/dest/

Development

Development

Contributing

If you are looking to contribute to the project, please see Contributing for guidlines.

Documentation

See the documentation.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gapic-generator-1.11.8.tar.gz (923.9 kB view details)

Uploaded Source

Built Distribution

gapic_generator-1.11.8-py3-none-any.whl (226.6 kB view details)

Uploaded Python 3

File details

Details for the file gapic-generator-1.11.8.tar.gz.

File metadata

  • Download URL: gapic-generator-1.11.8.tar.gz
  • Upload date:
  • Size: 923.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for gapic-generator-1.11.8.tar.gz
Algorithm Hash digest
SHA256 b1672e75940d13d3c832937a04bc25d574951a0ba1cbd9123da3dfd4854c334e
MD5 002e7951e0f0f779335753df557f3ccd
BLAKE2b-256 4a9446e49d65d1200cd3c95d67ef6d1ebe961578b1a020167e54218ea8b27711

See more details on using hashes here.

Provenance

File details

Details for the file gapic_generator-1.11.8-py3-none-any.whl.

File metadata

File hashes

Hashes for gapic_generator-1.11.8-py3-none-any.whl
Algorithm Hash digest
SHA256 1ca4e35e16f528e3630fc72766cd5f48d12fe2b86d543f83c5572bd1c9641ff2
MD5 d2432e02ff885a2dfd7e6137cc5236cd
BLAKE2b-256 045e3b5859fd08076aad033341aed8ab4af07e75103487bf219782540867b06b

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page