gapic-generator 0.19.0

Bugfixes

• Flattened fields can no longer generate naming conflicts with imported modules
• A common case where LRO annotations reference unimported types is permitted
• Modules whose names are python keywords are automatically disambiguated
• Cross package request types with no flattened fields no longer generate crashing GAPIC
• Paginated result types are imported properly for paginated methods
• Syntax errors fixed in doc templates

gapic-generator 0.18.0

Bugfixes

• Generated setup.py contains requirement on Google IAM when applicable
• Client methods that send IAM messages as requests handled specially
• Generated unit tests that check floating point message fields use math.isclose
• Fix minor naming issue with generated unit tests for resource name methods

gapic-generator 0.17.0

Bugfixes

• Empty method signature annotations are handled gracefully

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)