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

2.20.1 (2024-08-14)

Bug Fixes

• Allow protobuf 5.x; require protobuf >=3.20.2 (#560) (ad50e36)

2.20.0 (2024-08-07)

Features

• Add new types ExplainOptions, ExplainMetrics, PlanSummary, ExecutionStats (#521) (dfbee2d)

• Add new_transaction support (#499) (43855dd)

• Implement query profiling (#542) (1500f70)

• New PropertyMask field which allows partial commits, lookups, and query results (7fd218b)

Bug Fixes

• Retry and timeout values do not propagate in requests during pagination (#555) (5e773cb)

• Using end_cursor instead of skipped_cursor in Iterator to fix rare bug. (#552) (4982f9a)

2.19.0 (2023-12-10)

Features

• Add support for Python 3.12 (#498) (d1d60fa)

• Introduce compatibility with native namespace packages (#497) (87b3392)

Bug Fixes

• Use retry_async instead of retry in async client (4e15ce6)

Documentation

• Minor formatting (#476) (b13b15c)

2.18.0 (2023-09-05)

Features

• Add support for Sum and Avg aggregation query (#437) (e99120d)

Documentation

• Update property requirement specifications (#470) (795ce81)

2.17.0 (2023-08-09)

Features

• Publish proto definitions for SUM/AVG in Datastore (cfcd0c2)

Documentation

• Minor formatting in Datastore Admin API (cfcd0c2)

• Specify limit for properties in Index message in Datastore Admin API (cfcd0c2)

2.16.1 (2023-07-05)

Bug Fixes

• Add async context manager return types (#452) (05f20dc)

2.16.0 (2023-06-21)

Features

• Named database support (#439) (abf0060)

2.15.2 (2023-05-04)

Documentation

• Minor comment update for Entity message (#434) (b31a944)

2.15.1 (2023-03-24)

Documentation

• Fix formatting of request arg in docstring (#428) (da86a02)

• Improve query API documentation (#430) (915daf5)

2.15.0 (2023-03-09)

Features

• OR Query implementation (#418) (3256951)

2.14.0 (2023-02-28)

Features

• Enable “rest” transport in Python for services supporting numeric enums (6785908)

Documentation

• Minor documentation formatting and cleanup (6785908)

2.13.2 (2023-01-23)

Bug Fixes

• Fix system test using utc timezone (#406) (93537ef)

2.13.1 (2023-01-20)

Bug Fixes

• Add context manager return types (9cec031)

Documentation

• Add documentation for enums (9cec031)

2.13.0 (2023-01-14)

Features

• Add dynamic routing header annotation to DatastoreV1 (#400) (1043ba3)

• New transaction options for datastoreV1 (#402) (906d026)

2.12.0 (2023-01-10)

Features

• Add support for python 3.11 (#396) (19aca56)

2.11.1 (2022-12-09)

Bug Fixes

• deps: Require google-api-core >=1.34.0, >=2.11.0 (6f6bb63)

• Drop usage of pkg_resources (6f6bb63)

• Fix timeout default values (6f6bb63)

Documentation

• samples: Snippetgen should call await on the operation coroutine before calling result (6f6bb63)

2.11.0 (2022-11-30)

Features

• Support “limit” in count query. (#384) (a4b666a)

2.10.0 (2022-11-01)

Features

• Support the Count aggregation query (#368) (b400a9a)

2.9.0 (2022-10-18)

Features

• Add datastore aggregation query APIs (#306) (96d98e5)

Bug Fixes

• deps: Allow protobuf 3.19.5 (#372) (9305154)

2.8.2 (2022-10-03)

Bug Fixes

• deps: Require protobuf >= 3.20.2 (#365) (4e3e81f)

2.8.1 (2022-08-12)

Bug Fixes

• deps: allow protobuf < 5.0.0 (#347) (de13860)

• deps: require proto-plus >= 1.22.0 (de13860)

Documentation

• Move the schedule_export samples from python-docs-samples (#344) (2174800)

• samples: Add an example of using read_time in queries and get() (#342) (ffc5f17)

2.8.0 (2022-07-15)

Features

• Add read_time support for get and query (#334) (58b4b74)

2.7.2 (2022-07-10)

Bug Fixes

• require python 3.7+ (#332) (a9c513f)

2.7.1 (2022-06-16)

Documentation

• samples: add samples for IN, NOT_IN, and != operators. (#312) (4170325)

2.7.0 (2022-06-09)

Features

• support IN/NOT_IN/NOT_EQUAL operators (#287) (465bd87)

2.6.2 (2022-06-07)

Bug Fixes

• deps: require protobuf <4.0.0dev (#318) (1dccd37)

Documentation

• fix changelog header to consistent size (#319) (d3e9304)

2.6.1 (2022-05-27)

Bug Fixes

• regenerate pb2 file with grpcio-tools (#314) (0412cd5)

2.6.0 (2022-05-05)

Features

• expose new read_time API fields, currently only available in private preview (8d2bd17)

Documentation

• fix type in docstring for map fields (8d2bd17)

2.5.1 (2022-03-05)

Bug Fixes

• deps: require google-api-core>=1.31.5, >=2.3.2 (#278) (ac08eb1)

• deps: require proto-plus>=1.15.0 (ac08eb1)

2.5.0 (2022-02-26)

Features

• add api key support (e166d7b)

• define Datastore -> Firestore in Datastore mode migration long running operation metadata (#270) (e166d7b)

Bug Fixes

• deps: move libcst to extras (#271) (d53fcce)

• resolve DuplicateCredentialArgs error when using credentials_file (e166d7b)

Documentation

• add generated snippets (e166d7b)

2.4.0 (2021-11-08)

Features

• add context manager support in client (d6c8868)

• add methods for creating and deleting composite indexes (#248) (d6c8868)

• add support for self-signed JWT flow for service accounts (d6c8868)

Bug Fixes

• add ‘dict’ annotation type to ‘request’ (d6c8868)

• export async client from ‘google/cloud/datastore_v1’ (d6c8868)

• deps: require google-api-core >= 1.28.0 (d6c8868)

Documentation

• list ‘oneofs’ in docstrings for message classes (d6c8868)

2.3.0 (2021-10-18)

Features

• add ‘Client.entity’ helper (#239) (49d48f1)

Bug Fixes

• improve type hints, mypy check (#242) (6398bbc)

2.2.0 (2021-10-08)

Features

• add support for Python 3.10 (#233) (f524c40)

2.1.6 (2021-07-26)

Documentation

• add Samples section to CONTRIBUTING.rst (#195) (f607fb5)

2.1.5 (2021-07-20)

Bug Fixes

• deps: pin ‘google-{api,cloud}-core’, ‘google-auth’ to allow 2.x versions (#194) (e94f97c)

2.1.4 (2021-07-09)

Performance Improvements

• further avoid using proto-plus wrapper when unmarshalling entities (#190) (d0481bf)

Documentation

• omit mention of Python 2.7 in ‘CONTRIBUTING.rst’ (#1127) (#181) (6efde70)

2.1.3 (2021-05-25)

Bug Fixes

• perf: improve performance unmarshalling entities from protobuf2 (#175) (0e5b718)

2.1.2 (2021-05-03)

Bug Fixes

• pass transaction’s options to API in ‘begin’ (#143) (924b10b)

Documentation

• update intersphinx URLs for grpc and auth (#93) (4f90d04)

2.1.1 (2021-04-20)

Bug Fixes

• make HTTPDatastoreAPI compatible w/ microgen Gapic API (#136) (d522799)

• optimize protobuf access for performance (#155) (5b67daa), closes #145 #150

2.1.0 (2020-12-04)

Features

• support autoconversion of Entity to Key for purposes of delete & delete_multi (#123) (bf1dde6)

Fix

• remove six dependency (#120) (b1715e5)

2.0.1 (2020-11-13)

Bug Fixes

• fix id_or_name property of key class (#115) (6f28b84)

• normalize / test deprecation of ‘Client.reserve_ids’ (#103) (5851522), closes #101 #100

2.0.0 (2020-11-06)

⚠ BREAKING CHANGES

• remove support for Python 2.7

• Leverage new generator, proto-plus, for google-cloud-datastore (#104)

Features

• Leverage new generator, proto-plus, for google-cloud-datastore (#104) (1723a26)

Documentation

• adds UPGRADING.md, note to readme, to help inform users about migration to v2 (#113) (0d496c6)

2.0.0-dev1 (2020-10-30)

⚠ BREAKING CHANGES

• Leverage new generator, proto-plus, for google-cloud-datastore (#104)

Features

• Leverage new generator, proto-plus, for google-cloud-datastore (#104) (1723a26)

1.15.3 (2020-10-06)

Bug Fixes

• use full path and os.path to version.py in setup.py (#97) (0f5506f)

1.15.2 (2020-10-06)

Bug Fixes

• use version.py instead of pkg_resources.get_distribution (#94) (ea77534)

1.15.2 (2020-10-06)

Bug Fixes

• use version.py instead of pkg_resources.get_distribution (#94) (ea77534)

1.15.1 (2020-09-23)

Bug Fixes

• repair implementation of Client.reserve_ids (#76) (7df727d), closes #37

Documentation

• document thread-safety of client (#75) (ae0339c)

1.15.0 (2020-08-14)

Features

• add retry and timeout args to API methods (#67) (f3283e1), closes #3

• supply anonymous credentials under emulator (#71) (4db3c40), closes #70

Bug Fixes

• smooth over system test bumps (#66) (8bb17ea)

Documentation

• add docs for admin client (#63) (43ff64a), closes #49

1.14.0 (2020-08-05)

Features

• pass ‘client_options’ to base class ctor (#60) (2575697), closes #50

Documentation

• correct semantics of ‘complete_key’ arg to ‘Client.reserve_ids’ (#36) (50ed945)

• update docs build (via synth) (#58) (5bdacd4), closes #700

1.13.2 (2020-07-17)

Bug Fixes

• modify admin pkg name in gapic (#47) (5b5011d)

1.13.1 (2020-07-13)

Bug Fixes

• add missing datastore admin client files (#43) (0d40f87)

1.13.0 (2020-07-01)

Features

• add datastore admin client (#39) (1963fd8)

• add synth config to generate datastore_admin_v1 (#27) (83c636e)

• Create CODEOWNERS (#28) (0198419)

1.12.0 (2020-04-07)

Features

• datastore: add missing method for system test with emulator (#19) (bf8b897)

Bug Fixes

• Address queries not fully satisfying requested offset (#18) (e7b5fc9)

1.11.0 (2020-02-27)

Features

• datastore: add return query object in add filter method (#12) (6a9efab)

1.10.0

10-10-2019 12:20 PDT

Implementation Changes

• Remove send / receive message size limit (via synth). (#8952)

New Features

• Add client_options to constructors for manual clients. (#9055)

Dependencies

• Pin google-cloud-core >= 1.0.3, < 2.0.0dev. (#9055)

Documentation

• Fix intersphinx reference to requests. (#9294)

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

• Remove compatability badges from READMEs. (#9035)

• Update docs for building datastore indexes. (#8707)

• Update intersphinx mapping for requests. (#8805)

1.9.0

07-24-2019 16:04 PDT

Implementation Changes

• Allow kwargs to be passed to create_channel (via synth). (#8388)

New Features

• Add ‘client_options’ support (via synth). (#8506)

• Add ‘Client.reserve_ids’ API wrapper. (#8178)

Dependencies

• Bump minimum version for google-api-core to 1.14.0. (#8709)

Documentation

• Link to googleapis.dev documentation in READMEs. (#8705)

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

Internal / Testing Changes

• Pin black version (via synth). (#8580)

• Remove typing information for kwargs to not conflict with type checkers (#8546)

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

• Declare encoding as utf-8 in pb2 files (via synth). (#8350)

• Add disclaimer to auto-generated template files (via synth). (#8312)

• Suppress checking ‘cov-fail-under’ in nox default session (via synth). (#8238)

• Blacken noxfile.py, setup.py (via synth). (#8120)

• Add empty lines (via synth). (#8055)

1.8.0

05-17-2019 08:28 PDT

Implementation Changes

• Add routing header to method metadata (via synth). (#7593)

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

New Features

• Add client_info support to client. (#8013)

Dependencies

• Pin google-cloud-core >= 1.0.0, < 2.0dev. (#7993)

Documentation

• Update client library documentation URLs. (#7307)

• Pick up stub docstring fix in GAPIC generator. (#6968)

Internal / Testing Changes

• Add nox session docs (via synth). (#7768)

• Copy lintified proto files (via synth). (#7446)

• Add clarifying comment to blacken nox target. (#7389)

• Add protos as an artifact to library (#7205)

• Update copyright headers (#7142)

• Protoc-generated serialization update. (#7080)

1.7.3

12-17-2018 16:45 PST

Documentation

• Show use of ‘batch.begin()’ in docstring example. (#6932)

• Document Python 2 deprecation (#6910)

1.7.2

12-10-2018 12:37 PST

Implementation Changes

• Fix client_info bug, update docstrings. (#6409)

• Pick up fixes in GAPIC generator. (#6494)

• Import iam.policy from google.api_core. (#6741)

• Pick up enum fixes in the GAPIC generator. (#6610)

Dependencies

• Bump minimum api_core version for all GAPIC libs to 1.4.1. (#6391)

• Update version of google-cloud-core (#6858)

Internal / Testing Changes

• Update noxfile.

• Add synth metadata. (#6564)

• blacken all gen’d libs (#6792)

• omit local deps (#6701)

• Run black at end of synth.py (#6698)

• Run Black on Generated libraries (#6666)

• Add templates for flake8, coveragerc, noxfile, and black. (#6642)

1.7.1

10-29-2018 10:38 PDT

Implementation Changes

• Propagate empty arrays in entity values. (#6285)

• Expose ‘Client.base_url’ property to allow alternate endpoints. (#5821)

Documentation

• Normalize use of support level badges (#6159)

• Redirect renamed ‘usage.html’/’client.html’ -> ‘index.html’. (#5996)

• Replace links to ‘/stable/’ with ‘/latest/’. (#5901)

Internal / Testing Changes

• Use new Nox (#6175)

• Add ‘synth.py’. (#6078)

• Prep datastore docs for repo split. (#5919)

• Use inplace installs under nox (#5865)

1.7.0

Implementation Changes

• Do not pass ‘offset’ once the query iterator has a cursor (#5503)

• Add test runs for Python 3.7 and remove run for 3.4 (#5295)

Documentation

• minor fix to datastore example (#5452)

• Add example showing explicit unicode for text values in entities. (#5263)

Internal / Testing Changes

• Modify system tests to use prerelease versions of grpcio (#5304)

• Avoid overwriting ‘module’ of messages from shared modules. (#5364)

• Attempt again to reproduce #4264. (#5403)

• Fix bad trove classifier

1.6.0

Implementation changes

• Don’t check exclude_from_indexes for empty lists. (#4915)

Dependencies

• The minimum version for google-api-core has been updated to version 1.0.0. This may cause some incompatibility with older google-cloud libraries, you will need to update those libraries if you have a dependency conflict. (#4944, #4946)

Testing and internal changes

• Install local dependencies when running lint (#4936)

• Re-enable lint for tests, remove usage of pylint (#4921)

• Normalize all setup.py files (#4909)

• Exercise datastore query result paging (#4905)

• Pass *session.posargs through on command line for system tests. (#4904)

1.5.0

Interface additions

• Added Entity.id property (#4640)

• Added optional location_prefix kwarg in to_legacy_urlsafe (#4635)

• Added support for transaction options (#4357)

• Added the ability to specify read consistency (#4343, #4376)

Implementation changes

• The underlying autogenerated code was rengereated to pick up new features and bugfixes. (#4348, #4877)

• Updated the HTTP implementation to match the gRPC implementation. (#4388)

• Set next_page_token to None if there are no more results (#4349)

Documentation

• Entity doc consistency (#4641)

• Fixing “Fore” -> “For” typo in README docs. (#4317)

Testing

• Update datastore doctests to reflect change in cursor behavior. (#4382)

• Making a nox -s default session for all packages. (#4324)

• Shorten test names (#4321)

1.4.0

Interface changes / additions

• Allowing dict (as an Entity) for property values. (#3927)

Documentation

• Added link to “Python Development Environment Setup Guide” in project README (#4187, h/t to @michaelawyu)

Dependencies

• Upgrading to google-cloud-core >= 0.28.0 and adding dependency on google-api-core (#4221, #4280)

PyPI: https://pypi.org/project/google-cloud-datastore/1.4.0/