gapic-generator 0.16.0

Features

• Add a WIP optional lazy-import feature. Submodule __init__.py files use module level __getattr__ and importlib to selectively load sub-submodules, deferring import costs until submodules or types are used.
• Streaming method support is improved and fleshed out.
• The semantics of the conversion script have changed: a single script is generated per API instead of one script per service. The script modifies a copy of its input directory and does not change the input source files.
• Nested message types in proto files produce import statements in generated unit tests.
• Generated gRPC transports gain a create_channel factory method that passes arbitrary keyword arguments through to grpc_helpers.create_channel

Tests

• Test that nested message types generate import statements.
• Add grpc streaming interceptor tests.
• Add tests for the alternative module import semantics.

Misc

• The enums submodule has been removed from the generated surface.

gapic-generator 0.15.0

Features

• Add generated rst documentation
• Adopt the revised microgenerated flattening semantics for the GAPIC surface

Bugfixes

• Provide generated 'types' and 'enums' submodules in order to replicate the monolithic GAPIC surface
• Duplicate test names from multiple API versions being concurrently generated no longer cause nox to fail
• Add enums to 'all' types import

Tests

• Test that enums are visible through the 'enums' submodule
• Test for method flattening

gapi-generator 0.14.0

Breaking Changes

• The template interpolation token is now % instead of $
• Method flattening semantics have changed

Features

• Add support and testing for Python 3.8
• GAPIC clients define helper functions that describe resource paths for types used in request message fields
• Paginated response objects have a 'pages' and 'raw_pages' property that provides an iterator over the paginated response messages
• Generated clients gain an optional, keyword only 'client_options' parameter. Currently, only client endpoint is configurable
  Generator now creates a script per service to facilitate user code from the monolithic style flattening to microgenerator style flattening
• Sample configs can use resource path syntax in request construction
• Add a command line parameter describing the path of an optional service config
• Duplicate sample configs generate an error
• Sample config response handling can use dictionary references or list-indexed expressions
• Sample config request construction can use primitive values

Bugfixes

• Use absolute paths when invoking generator docker image
• Sample generation works when generator is invoked as a protobuf plugin

Documentation

• All generated files contain copyright and license information
• Showcase dependency is updated

Tests

• Add generated unit tests for reading service config files
• Add generated unit tests for passing 'client_options' and respecting configured endpoint
• Update generated tests for method flattening
• Add generated tests for 'pages' and 'raw_pages' properties
• Add generated tests for resource path methods
• Add system test for pages property
• Add unit tests for duplicate sample configs
• Add unit test for sample configs that use resource paths
• Add unit test for primitive values in sample config request construction
• Add samplegen unit tests for resource based functionality

gapic-generator 0.13.0

Features

• Samplegen functionality is exposed in docker image (#184 )

Documentation

• Initial documentation for samplegen (#184 )

gapic-generator 0.12.0

Features

• Generate samples and sample manifests (#167)

Bugfixes

• Pager modules always import the message being paged (#153)
• Remove commas after keyword-only parameters in generated methods (#175)
• Remove various unused imports from generated code (#177)

gapic-generator 0.11.0

Bugfixes

• Pager modules always import the message being paged (#150)
• Minor formatting fixes (#155)
• Fix a bash syntax error in docker entrypoint script (#135)

gapic-generator 0.10.0

Features

• Improved enum support (#127)
• mypy type-checking on the generator (#130)
• mypy type-checking on the generated output (#131)
• Added a CLI option to take the Python module (#126)

Bugfixes

• The Docker entrypoint script preserves any option beginning with python-gapic (#129)

Documentation

• Documentation cleanup, largely removing out-of-date material (#132)

gapic-generator 0.9.0

Breaking Changes

• Removed support for package metadata, since this configuration did not make it to stable (#125)

Features

• Automatic pagination support (#121)

Bugfixes

• Fixed an issue where generation failed if no default_host was specified (#120)
• Fixed an incorrect __all__ (#119)

gapic-generator 0.8.0

Breaking Changes

• Removed HTTP/1.1 support. (#114)
  • This feature is going away temporarily because of a lack of testing infrastructure to support it. It will return once we can verify correctness.

Features

• Unit tests. (#115)
  • The generator now ships unit tests with 100% coverage.
  • CI is updated to exercise them.

Documentation

• Fixed the image resource for testing the Vision library (#110, thanks @Jaffrey98)
• Updated the clone instructions to use HTTPS (#112, thanks @AnupKumarPanwar)

gapic-generator 0.7.1

Bugfixes

• Fixed an issue where a proto file with only nested enums lacked an import enum statement. (#107)
• Minor corrections to documentation. (#108)