Changelog

PyPI History

2.3.0 (2021-11-25)

Features

• add operations rest client to support long-running operations. (#311) (ce1adf3)

Bug Fixes

• handle bare ‘grpc.Call’ in ‘from_grpc_error’ (#298) (060b339)

2.2.2 (2021-11-02)

Bug Fixes

• make ‘gapic_v1.method.DEFAULT’ a typed object (#292) (ffc51f0)

2.2.1 (2021-10-26)

Bug Fixes

• revert “fix: do not error on LROs with no response or error” (#294) (9e6091e)

2.2.0 (2021-10-25)

Features

• add ‘GoogleAPICallError.error_details’ property (#286) (ef6f0fc)

2.1.1 (2021-10-13)

Bug Fixes

• add mypy checking + ‘py.typed’ file (#290) (0023ee1)

2.1.0 (2021-10-05)

Features

• add grpc transcoding + tests (#259) (afe0fa1)
• Add helper function to format query_params for rest transport. (#275) (1c5eb4d)
• add support for Python 3.10 (#284) (a422a5d)

2.0.1 (2021-08-31)

Bug Fixes

• do not error on LROs with no response or error (#258) (618f192)

2.0.0 (2021-08-18)

⚠ BREAKING CHANGES

• drop support for Python 2.7 / 3.5 (#212) (a30f004)

Bug Fixes

• bump grpcio version to use stable aio API (#234) (bdbf889)
• strip trailing _ from field mask paths (#228) (ff6ef1b)

2.0.0b1 (2021-08-03)

⚠ BREAKING CHANGES

• drop support for Python 2.7 / 3.5 (#212) (a30f004)

Bug Fixes

• strip trailing _ from field mask paths (#228) (ff6ef1b)

1.31.1 (2021-07-26)

Bug Fixes

• add ‘requests.exceptions.ChunkedEncodingError’ to retryable exceptions (#237) (5e540f2)

Documentation

• add Samples section to CONTRIBUTING.rst (#229) (a12c051)

1.31.0 (2021-07-07)

Features

• add ServiceUnavailable exception to polling retries (#184) (11032cf)

Bug Fixes

• undprecate entity factory helpers (#101) (1fbee03), closes #100

1.30.0 (2021-06-08)

Features

• add iterator capability to paged iterators (#200) (3487d68)

1.29.0 (2021-06-02)

Features

• HTTPIterator now accepts a page_size parameter to control page … (#197) (a421913)

Documentation

• fix broken links in multiprocessing.rst (#195) (8d8bc51)

1.28.0 (2021-05-20)

Bug Fixes

• require google-auth>=1.25.0 (#190) (155da5e)

Miscellaneous Chores

• release 1.28.0 (#192) (11b5da4)

1.27.0 (2021-05-18)

Features

• Add support for rest/ token in x-goog-api-client header (#189) (15aca6b)
• retry google.auth TransportError and requests ConnectionError (#178) (6ae04a8)

1.26.3 (2021-03-25)

Bug Fixes

• skip empty policy bindings in len() and iter() (#159) (9eaa786)

Documentation

• update python contributing guide (#147) (1d76b57)

1.26.2 (2021-03-23)

Bug Fixes

• save empty IAM policy bindings (#155) (536c2ca)

1.26.1 (2021-02-12)

Bug Fixes

• add operation name to x-goog-request-params in async client (#137) (7271b23)

1.26.0 (2021-02-08)

Features

• allow default_host and default_scopes to be passed to create_channel (#134) (94c76e0)

1.25.1 (2021-01-25)

Bug Fixes

• add operation name to x-goog-request-params (#133) (97cef4a)

Documentation

• fix spelling errors in retry (#131) (232dab0)

1.25.0 (2021-01-14)

Features

• allow gRPC metadata to be passed to operations client (#127) (73854e8)

Documentation

• python: document adding Python 3.9 support, dropping 3.5 support (#120) (b51b7f5), closes #787

1.24.1 (2020-12-16)

Bug Fixes

• support ‘retry’ for ops built from HTTP/gRPC responses (#115) (7a38243), closes #87

1.24.0 (2020-12-14)

Features

• add support for Python 3.9, drop support for Python 3.5 (#111) (fdbed0f), closes #110

Documentation

• explain how to create credentials from dict (#109) (5dce6d6)

1.23.0 (2020-10-16)

Features

• api-core: pass retry from result() to done() (#9) (6623b31)

Bug Fixes

• map LRO errors to library exception types (#86) (a855339), closes #15
• harden install to use full paths, and windows separators on windows (#88) (db8e636)
• update out-of-date comment in exceptions.py (#93) (70ebe42)

1.22.4 (2020-10-05)

Bug Fixes

• use version.py instead of pkg_resources.get_distribution (#80) (d480d97)

1.22.3 (2020-10-02)

Bug Fixes

• deps: require six >= 1.13.0 (#78) (a7a8b98), closes /github.com/benjaminp/six/blob/c0be8815d13df45b6ae471c4c436cce8c192245d/CHANGES#L30-L31

1.22.2 (2020-09-03)

Bug Fixes

• only add quota project id if supported (#75) (8f8ee78)

1.22.1 (2020-08-12)

Documentation

• fix spelling errors for amount in retry (#69) (7bb713d)

1.22.0 (2020-07-21)

Features

• allow quota project to be passed to create_channel (#58) (e2d9a7b)

Bug Fixes

• _determine_timeout problem handling float type timeout (#64) (2010373)

Documentation

• change the documentation for using ‘six.moves.collections_abc.Mapping’ instead of ‘dict’ in ‘client_options.from_dict()’ (#53) (c890675)

1.21.0 (2020-06-18)

Features

• allow credentials files to be passed for channel creation (#50) (ded92d0)

1.20.1 (2020-06-16)

Bug Fixes

• dependencies: increase protobuf version (#49) (1ba6095), closes #48

1.20.0 (2020-06-09)

Features

• allow disabling response stream pre-fetch (#30) (74e0b0f), closes #25

1.19.1 (2020-06-06)

Bug Fixes

• bump up grpcio minimum version to 1.29.0 (#41) (4b11422)

1.19.0 (2020-06-05)

Features

• client_options: add new client options ‘quota_project_id’, ‘scopes’, and ‘credentials_file’ (a582936)

1.18.0 (2020-06-04)

Features

• [CBT-6 helper] Exposing Retry._deadline as a property (#20) (7be1e59)
• add client_encryped_cert_source to ClientOptions (#31) (e4eaec0)
• AsyncIO Integration [Part 2] (#28) (dd9b2f3), closes #23
• First batch of AIO integration (#26) (a82f289)
• third batch of AsyncIO integration (#29) (7d8d580)

1.17.0 (2020-04-14)

Features

• api_core: add retry param into PollingFuture() and it's inheritors (#9923) (14f1f34), closes #6197
• api-core: add client_cert_source to ClientOptions (#17) (748c935)

Bug Fixes

• consume part of StreamingResponseIterator to support failure while under a retry context (#10206) (2b103b6)

1.16.0

01-13-2020 14:19 PST

New Features

• feat(storage): support optionsRequestedPolicyVersion (#9989)
• feat(api_core): support version 3 policy bindings (#9869)

1.15.0

12-16-2019 15:27 PST

New Features

• Make the last retry happen at deadline. (#9873)
• Add a repr method for ClientOptions. (#9849)
• Simplify from_rfc3339 methods. (#9641)
• Provide a raw_page field for page_iterator.Page. (#9486)

Documentation

• Add Python 2 sunset banner to documentation. (#9036)
• Remove references to the old authentication credentials. (#9456)

1.14.3

10-07-2019 10:35 PDT

Implementation Changes

• Finalize during close of ‘ResumableBidiRpc’ (#9337)
• add on_error to Retry.init (#8892)
• Fix race in ‘BackgroundConsumer._thread_main’. (#8883)

Documentation

• Fix intersphinx reference to requests (#9294)
• Fix broken links in docs. (#9148)
• About of time -> amount of time (#9052)
• Remove compatability badges from READMEs. (#9035)

Internal / Testing Changes

• Remove CI for gh-pages, use googleapis.dev for api_core refs. (#9085)

1.14.2

07-30-2019 14:08 PDT

Documentation

• Add client_options documentation. (#8834)

1.14.1

07-30-2019 12:24 PDT

Implementation Changes

• Remove error log entry on clean BiDi shutdown. (#8806)
• Forward ‘timeout’ arg from ‘exception’ to _blocking_poll. (#8735)

Documentation

• Update intersphinx mapping for requests. (#8805)
• Link to googleapis.dev documentation in READMEs. (#8705)

1.14.0

07-17-2019 13:16 PDT

New Features

• Firestore: Add should_terminate predicate for clean BiDi shutdown. (#8650)

Dependencies

• Update pins of 'googleapis-common-protos. (#8688)

Documentation

• Add compatibility check badges to READMEs. (#8288)

Internal / Testing Changes

• All: Add docs job to publish to googleapis.dev. (#8464)

1.13.0

06-24-2019 10:34 PDT

New Features

• Add client_options.ClientOptions object. (#8265)

1.12.0

06-18-2019 12:37 PDT

New Features

• Add Throttling to Bidi Reopening. Mitigates ResumableBidiRpc consuming 100% CPU (#8193)

1.11.1

05-28-2019 11:19 PDT

Implementation Changes

• Classify 503 Service Unavailable errors as transient. (#8182)

Dependencies

• Pin grpcio < 2.0dev. (#8182)

Internal / Testing Changes

• Add parameterized test for from_rfc3339 with nanos (#7675)
• Unbreak pytype by silencing a false positive. (#8106)

1.11.0

05-15-2019 10:29 PDT

New Features

• Refactor ‘client_info’ support. (#7849)

1.10.0

04-29-2019 10:12 PDT

Implementation Changes

• Append leading zeros for nanosecond precision DateTimes (#7663)

New Features

• Add user_agent property to ClientInfo (#7799)

1.9.0

04-05-2019 10:38 PDT

Implementation Changes

• Allow passing metadata as part of creating a bidi (#7514)

Internal / Testing Changes

• Update setup.py
• API Core: specify a pytype output directory in setup.cfg. (#7639)

1.8.2

03-22-2019 16:27 PDT

Implementation Changes

• Remove classifier for Python 3.4 for end-of-life. (#7535)

Internal / Testing Changes

• When re-opening a ResumableBidiRPC set _request_queue_generator to None. (#7548)

1.8.1

03-12-2019 12:45 PDT

Implementation Changes

• Protect the creation of a background thread in BackgroundConsumer and wait on it starting. (#7499)

1.8.0

02-23-2019 15:46 PST

New Features

• Add support to unwrap Anys into wrapped pb2 objects. (#7430)
• Add Operation.deserialize. (#7427)

Documentation

• Updated client library documentation URLs. (#7307)

Internal / Testing Changes

• Fix new lint failure. (#7382)

1.7.0

12-17-2018 13:56 PST

New Features

• Support converting DatetimeWithNanos to / from google.protobuf.timestamp_pb2.Timestamp. (#6919)

Documentation

• Document Python 2 deprecation. (#6910)
• Add usage example for google.api_core.iam.Polcy. (#6855)

Internal / Testing Changes

• Work around pytype big for ABCMeta.register. (#6873)

1.6.0

11-30-2018 12:45 PST

Implementation Changes

• Import stdlib ABCs from ‘collections.abc’ rather than ‘collections’. (#6451)

New Features

• Move google.cloud.iam (core) to google.api_core.iam (#6740)
• Add bidi support to api_core. (#6191)

Documentation

• Fix typo (#6532)

Internal / Testing Changes

• blacken api_core and core (#6668)

1.5.2

11-09-2018 14:22 PST

Implementation Changes

• Retry transient errors in ‘PollingFuture.result’. (#6305)

Dependencies

• Remove hyphen from named extra in api_core. (#6468)
• Bump minimum ‘api_core’ version for all GAPIC libs to 1.4.1. (#6391)
• Avoid broken ‘google-common-apis 1.5.4’ release. (#6355)

1.5.1

10-29-2018 13:29 PDT

Implementation Changes

• Don't URL-encode slashes in gRPC request headers. (#6310)

Internal / Testing Changes

• Back out changes from #6267 / api_core-1.6.0a1 release. (#6328)

1.5.0

New Features

• Add bidi, Bidirection Streaming, to api-core (#6211)

Internal / Testing Changes

• Use new Nox (#6175)

1.4.1

Dependencies

• Pin minimum protobuf dependency to 3.4.0. (#6132)

Internal / Testing Changes

• Add type-checking via pytype to api_core. (#6116)

1.4.0

Dependencies

• Add support for gRPC connection management (available when using optional grpc_gcp dependency) (#5553) (#5904)
• Update classifiers to drop Python 3.4 and add Python 3.7 (#5702)

1.3.0

New Features

• Add protobuf_helpers.field_mask to calculate a field mask from two messages (#5320)

1.2.1

Implementation Changes

• Make client_info work without gRPC installed. (#5075)
• Rename x-goog-header-params to x-goog-request-params (#5495)

1.2.0

Implementation Changes

• Add close method to grpc Channel (#5333)

Internal / Testing Changes

• Fix tests after grpcio update (#5333)
• Add Test runs for Python 3.7 and remove 3.4 (#5295)

1.1.2

Packaging

• Update setuptools before packaging (#5265)

1.1.1

Internal / Testing Changes

• Use install_requires for platform dependencies instead of extras_require (#4991)
• Update trove classifer to ‘5 - Production/Stable’

1.1.0

Interface additions

• Add datetime_helpers.DatetimeWithNanoSeconds (#4979)

Implementation changes

• Use a class to wrap grpc streaming errors instead of monkey-patching (#4995)

1.0.0

This is the stable v1.0.0 release of google-api-core for Python. Releases after this will not contain breaking changes.

Interface changes and additions

• Made api_core.page_iterator.PageIterator.item_to_value public
• Added ability to specify retry for Operation and polling.Future. (#4922)

0.1.4

New Features

• Add ChannelStub to grpc_helpers for testing gRPC-based clients. (#4705)

Notable Implementation Changes

• Fix handling of gapic metadata when specified as None. (#4701)

0.1.3

Notable Implementation Changes

• Apply scopes to explicitly provided credentials if needed (#4594).
• Removing google.api_core.gapic_v1.method.METRICS_METADATA_KEY. It can be accessed via google.api_core.gapic_v1.client_info.METRICS_METADATA_KEY (#4588).

Dependencies

• Upgrading to latest grpcio==1.8.2 (#4642). For details, see related gRPC bug and fix.

PyPI: https://pypi.org/project/google-api-core/0.1.3/

0.1.2

• Upgrading concurrent.futures backport from >= 3.0.0 to >= 3.2.0 (#4521).
• Moved datetime-related helpers from google.cloud.core to google.api_core.datetime_helpers (#4399).
• Added missing client_info to gapic_v1/__init__.py's __all__ (#4567).
• Added helpers for routing headers to gapic_v1 (#4336).

PyPI: https://pypi.org/project/google-api-core/0.1.2/

0.1.1

Dependencies

• Upgrading grpcio dependency from 1.2.0, < 1.6dev to >= 1.7.0 (#4280)

PyPI: https://pypi.org/project/google-api-core/0.1.1/

0.1.0

Initial release

Prior to being separated, this package was developed in google-cloud-core, so relevant changes from that package are included here.

• Add google.api.core.gapic_v1.config (#4022)
• Add google.api.core.helpers.grpc_helpers (#4041)
• Add google.api.core.gapic_v1.method (#4057)
• Add wrap_with_paging (#4067)
• Add grpc_helpers.create_channel (#4069)
• Add DEFAULT sentinel for gapic_v1.method (#4079)
• Remove googleapis-common-protos from deps in non-core packages. (#4098)
• Add google.api.core.operations_v1 (#4081)
• Fix test assertion in test_wrap_method_with_overriding_retry_deadline (#4131)
• Add google.api.core.helpers.general_helpers.wraps (#4166)
• Update Docs with Python Setup Guide (#4187)
• Move modules in google.api.core.helpers up one level, delete google.api.core.helpers. (#4196)
• Clarify that PollingFuture timeout is in seconds. (#4201)
• Add api_core package (#4210)
• Replace usage of google.api.core with google.api_core (#4221)
• Add google.api_core.gapic_v2.client_info (#4225)
• Fix how api_core.operation populates exception errors (#4231)
• Fix bare except (#4250)
• Fix parsing of API errors with Unicode err message (#4251)
• Port gax proto helper methods (#4249)
• Remove gapic_v1.method.wrap_with_paging (#4257)
• Add final set of protobuf helpers to api_core (#4259)

PyPI: https://pypi.org/project/google-api-core/0.1.0/