Google API Client Generator for Python
Project description
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
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
Built Distribution
Hashes for gapic_generator-1.14.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4ddae04c2a51ead3c0d9de2ae0c42f25ac8216b6952decc90af96c7a2da8351c |
|
MD5 | 7652fe3941a9352dc0145397617a7e93 |
|
BLAKE2b-256 | fc18d61081d9a8cc697e8d82d798f68e36256bf32b555b40b09648bc2a584afa |