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.18.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3b672d16db12ba4ba932452ac0daa1f73c6b5fde07f0f4e24499376cc9459724 |
|
MD5 | 9de67f843a09d7eb5aec1816ea7e04ec |
|
BLAKE2b-256 | 82f3f7c45689a028dd1f2bd6b317a6d47730b5fdc3d2bfe00c84e1eb908cc086 |