update yaml to patch datastore __init__ file

ohmayr · ohmayr · commit 461596963413 · 2026-02-27T22:47:25.000Z
diff --git a/.librarian/generator-input/client-post-processing/datastore-integration.yaml b/.librarian/generator-input/client-post-processing/datastore-integration.yaml
@@ -124,4 +124,73 @@ replacements:
         :maxdepth: 2
 
         changelog
+    count: 1
+  - paths: [
+      "packages/google-cloud-datastore/google/cloud/datastore/__init__.py",
+    ]
+    before: |
+      from google.cloud.datastore import gapic_version as package_version
+      [\s\S]*?"PlanSummary",\n\)
+    after: |
+      """Shortcut methods for getting set up with Google Cloud Datastore.
+
+      You'll typically use these to get started with the API:
+
+      .. doctest:: constructors
+
+         >>> from google.cloud import datastore
+         >>>
+         >>> client = datastore.Client()
+         >>> key = client.key('EntityKind', 1234)
+         >>> key
+         <Key('EntityKind', 1234), project=...>
+         >>> entity = datastore.Entity(key)
+         >>> entity['question'] = u'Life, universe?'  # Explicit unicode for text
+         >>> entity['answer'] = 42
+         >>> entity
+         <Entity('EntityKind', 1234) {'question': 'Life, universe?', 'answer': 42}>
+         >>> query = client.query(kind='EntityKind')
+
+      The main concepts with this API are:
+
+      - :class:`~google.cloud.datastore.client.Client`
+        which represents a project (string), database (string), and namespace
+        (string) bundled with a connection and has convenience methods for
+        constructing objects with that project/database/namespace.
+
+      - :class:`~google.cloud.datastore.entity.Entity`
+        which represents a single entity in the datastore
+        (akin to a row in relational database world).
+
+      - :class:`~google.cloud.datastore.key.Key`
+        which represents a pointer to a particular entity in the datastore
+        (akin to a unique identifier in relational database world).
+
+      - :class:`~google.cloud.datastore.query.Query`
+        which represents a lookup or search over the rows in the datastore.
+
+      - :class:`~google.cloud.datastore.transaction.Transaction`
+        which represents an all-or-none transaction and enables consistency
+        when race conditions may occur.
+      """
+
+      from google.cloud.datastore.batch import Batch
+      from google.cloud.datastore.client import Client
+      from google.cloud.datastore.entity import Entity
+      from google.cloud.datastore.key import Key
+      from google.cloud.datastore.query import Query
+      from google.cloud.datastore.query_profile import ExplainOptions
+      from google.cloud.datastore.transaction import Transaction
+      from google.cloud.datastore.version import __version__
+
+      __all__ = [
+          "__version__",
+          "Batch",
+          "Client",
+          "Entity",
+          "Key",
+          "Query",
+          "ExplainOptions",
+          "Transaction",
+      ]
     count: 1
diff --git a/packages/google-cloud-datastore/google/cloud/datastore/__init__.py b/packages/google-cloud-datastore/google/cloud/datastore/__init__.py
@@ -1,4 +1,5 @@
-# Copyright 2014 Google LLC
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -11,7 +12,7 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
+#
 """Shortcut methods for getting set up with Google Cloud Datastore.
 
 You'll typically use these to get started with the API:
