As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Changelog

PyPI History

1.25.1 (2021-01-25)

Bug Fixes

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

Documentation

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)

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

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

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/