docs: Minor formatting (#476)

* docs: Minor formatting
chore: Update gapic-generator-python to v1.11.5
build: Update rules_python to 0.24.0

PiperOrigin-RevId: 563436317

Source-Link: googleapis/googleapis@42fd37b

Source-Link: googleapis/googleapis-gen@280264c
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

google/cloud/datastore_admin_v1/services/datastore_admin/async_client.py

@@ -47,7 +47,7 @@
 from google.cloud.datastore_admin_v1.services.datastore_admin import pagers
 from google.cloud.datastore_admin_v1.types import datastore_admin
 from google.cloud.datastore_admin_v1.types import index
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 from .transports.base import DatastoreAdminTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc_asyncio import DatastoreAdminGrpcAsyncIOTransport
@@ -56,13 +56,16 @@
 
 class DatastoreAdminAsyncClient:
     """Google Cloud Datastore Admin API
+
     The Datastore Admin API provides several admin services for
     Cloud Datastore.
+
     Concepts: Project, namespace, kind, and entity as defined in the
     Google Cloud Datastore API.
 
     Operation: An Operation represents work being performed in the
     background.
+
     EntityFilter: Allows specifying a subset of entities in a
     project. This is specified as a combination of kinds and
     namespaces (either or both of which may be all).

google/cloud/datastore_admin_v1/services/datastore_admin/client.py

@@ -51,7 +51,7 @@
 from google.cloud.datastore_admin_v1.services.datastore_admin import pagers
 from google.cloud.datastore_admin_v1.types import datastore_admin
 from google.cloud.datastore_admin_v1.types import index
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 from .transports.base import DatastoreAdminTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc import DatastoreAdminGrpcTransport
@@ -98,13 +98,16 @@ def get_transport_class(
 
 class DatastoreAdminClient(metaclass=DatastoreAdminClientMeta):
     """Google Cloud Datastore Admin API
+
     The Datastore Admin API provides several admin services for
     Cloud Datastore.
+
     Concepts: Project, namespace, kind, and entity as defined in the
     Google Cloud Datastore API.
 
     Operation: An Operation represents work being performed in the
     background.
+
     EntityFilter: Allows specifying a subset of entities in a
     project. This is specified as a combination of kinds and
     namespaces (either or both of which may be all).

google/cloud/datastore_admin_v1/services/datastore_admin/transports/base.py

@@ -29,7 +29,6 @@
 
 from google.cloud.datastore_admin_v1.types import datastore_admin
 from google.cloud.datastore_admin_v1.types import index
-from google.longrunning import operations_pb2
 from google.longrunning import operations_pb2  # type: ignore
 
 DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo(

google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc.py

@@ -27,7 +27,6 @@
 
 from google.cloud.datastore_admin_v1.types import datastore_admin
 from google.cloud.datastore_admin_v1.types import index
-from google.longrunning import operations_pb2
 from google.longrunning import operations_pb2  # type: ignore
 from .base import DatastoreAdminTransport, DEFAULT_CLIENT_INFO
 
@@ -36,13 +35,16 @@ class DatastoreAdminGrpcTransport(DatastoreAdminTransport):
     """gRPC backend transport for DatastoreAdmin.
 
     Google Cloud Datastore Admin API
+
     The Datastore Admin API provides several admin services for
     Cloud Datastore.
+
     Concepts: Project, namespace, kind, and entity as defined in the
     Google Cloud Datastore API.
 
     Operation: An Operation represents work being performed in the
     background.
+
     EntityFilter: Allows specifying a subset of entities in a
     project. This is specified as a combination of kinds and
     namespaces (either or both of which may be all).

google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc_asyncio.py

@@ -27,7 +27,6 @@
 
 from google.cloud.datastore_admin_v1.types import datastore_admin
 from google.cloud.datastore_admin_v1.types import index
-from google.longrunning import operations_pb2
 from google.longrunning import operations_pb2  # type: ignore
 from .base import DatastoreAdminTransport, DEFAULT_CLIENT_INFO
 from .grpc import DatastoreAdminGrpcTransport
@@ -37,13 +36,16 @@ class DatastoreAdminGrpcAsyncIOTransport(DatastoreAdminTransport):
     """gRPC AsyncIO backend transport for DatastoreAdmin.
 
     Google Cloud Datastore Admin API
+
     The Datastore Admin API provides several admin services for
     Cloud Datastore.
+
     Concepts: Project, namespace, kind, and entity as defined in the
     Google Cloud Datastore API.
 
     Operation: An Operation represents work being performed in the
     background.
+
     EntityFilter: Allows specifying a subset of entities in a
     project. This is specified as a combination of kinds and
     namespaces (either or both of which may be all).

google/cloud/datastore_admin_v1/services/datastore_admin/transports/rest.py

@@ -28,7 +28,6 @@
 
 from google.protobuf import json_format
 from google.api_core import operations_v1
-from google.longrunning import operations_pb2
 from requests import __version__ as requests_version
 import dataclasses
 import re
@@ -363,13 +362,16 @@ class DatastoreAdminRestTransport(DatastoreAdminTransport):
     """REST backend transport for DatastoreAdmin.
 
     Google Cloud Datastore Admin API
+
     The Datastore Admin API provides several admin services for
     Cloud Datastore.
+
     Concepts: Project, namespace, kind, and entity as defined in the
     Google Cloud Datastore API.
 
     Operation: An Operation represents work being performed in the
     background.
+
     EntityFilter: Allows specifying a subset of entities in a
     project. This is specified as a combination of kinds and
     namespaces (either or both of which may be all).

google/cloud/datastore_admin_v1/types/datastore_admin.py

@@ -429,6 +429,7 @@ class EntityFilter(proto.Message):
             An empty list represents all namespaces. This
             is the preferred usage for projects that don't
             use namespaces.
+
             An empty string element represents the default
             namespace. This should be used if the project
             has data in non-default namespaces, but doesn't

google/cloud/datastore_v1/services/datastore/async_client.py

@@ -46,7 +46,7 @@
 from google.cloud.datastore_v1.types import datastore
 from google.cloud.datastore_v1.types import entity
 from google.cloud.datastore_v1.types import query
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore
 from .transports.base import DatastoreTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc_asyncio import DatastoreGrpcAsyncIOTransport

google/cloud/datastore_v1/services/datastore/client.py

@@ -50,7 +50,7 @@
 from google.cloud.datastore_v1.types import datastore
 from google.cloud.datastore_v1.types import entity
 from google.cloud.datastore_v1.types import query
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore
 from .transports.base import DatastoreTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc import DatastoreGrpcTransport

google/cloud/datastore_v1/services/datastore/transports/base.py

@@ -27,7 +27,7 @@
 from google.oauth2 import service_account  # type: ignore
 
 from google.cloud.datastore_v1.types import datastore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 
 DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo(
     gapic_version=package_version.__version__

google/cloud/datastore_v1/services/datastore/transports/grpc.py

@@ -25,7 +25,7 @@
 import grpc  # type: ignore
 
 from google.cloud.datastore_v1.types import datastore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import DatastoreTransport, DEFAULT_CLIENT_INFO
 
 

google/cloud/datastore_v1/services/datastore/transports/grpc_asyncio.py

@@ -25,7 +25,7 @@
 from grpc.experimental import aio  # type: ignore
 
 from google.cloud.datastore_v1.types import datastore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import DatastoreTransport, DEFAULT_CLIENT_INFO
 from .grpc import DatastoreGrpcTransport
 

google/cloud/datastore_v1/services/datastore/transports/rest.py

@@ -27,7 +27,6 @@
 from google.api_core import gapic_v1
 
 from google.protobuf import json_format
-from google.longrunning import operations_pb2
 from requests import __version__ as requests_version
 import dataclasses
 import re
@@ -41,6 +40,7 @@
 
 
 from google.cloud.datastore_v1.types import datastore
+from google.longrunning import operations_pb2  # type: ignore
 
 from .base import DatastoreTransport, DEFAULT_CLIENT_INFO as BASE_DEFAULT_CLIENT_INFO
 

google/cloud/datastore_v1/types/aggregation_result.py

@@ -74,6 +74,7 @@ class AggregationResultBatch(proto.Message):
             ``NO_MORE_RESULTS``.
         read_time (google.protobuf.timestamp_pb2.Timestamp):
             Read timestamp this batch was returned from.
+
             In a single transaction, subsequent query result
             batches for the same query can have a greater
             timestamp. Each batch's read timestamp is valid

google/cloud/datastore_v1/types/datastore.py

@@ -861,6 +861,7 @@ class ReadOptions(proto.Message):
             Reads entities as they were at the given
             time. This value is only supported for Cloud
             Firestore in Datastore mode.
+
             This must be a microsecond precision timestamp
             within the past one hour, or if Point-in-Time
             Recovery is enabled, can additionally be a whole
@@ -957,6 +958,7 @@ class ReadOnly(proto.Message):
         Attributes:
             read_time (google.protobuf.timestamp_pb2.Timestamp):
                 Reads entities at the given time.
+
                 This must be a microsecond precision timestamp
                 within the past one hour, or if Point-in-Time
                 Recovery is enabled, can additionally be a whole

google/cloud/datastore_v1/types/entity.py

@@ -120,6 +120,7 @@ class Key(proto.Message):
 
     class PathElement(proto.Message):
         r"""A (kind, ID/name) pair used to construct a key path.
+
         If either name or ID is set, the element is complete. If neither
         is set, the element is incomplete.
 
@@ -143,6 +144,7 @@ class PathElement(proto.Message):
                 base-64 encoding of the bytes.
             id (int):
                 The auto-allocated ID of the entity.
+
                 Never equal to zero. Values less than zero are
                 discouraged and may not be supported in the
                 future.
@@ -264,6 +266,7 @@ class Value(proto.Message):
             This field is a member of `oneof`_ ``value_type``.
         entity_value (google.cloud.datastore_v1.types.Entity):
             An entity value.
+
             - May have no key.
             - May have a key with an incomplete key path.
             - May have a reserved/read-only key.
@@ -356,6 +359,7 @@ class Value(proto.Message):
 
 class Entity(proto.Message):
     r"""A Datastore data object.
+
     Must not exceed 1 MiB - 4 bytes.
 
     Attributes:

tests/unit/gapic/datastore_admin_v1/test_datastore_admin.py

@@ -58,7 +58,7 @@
 from google.cloud.datastore_admin_v1.services.datastore_admin import transports
 from google.cloud.datastore_admin_v1.types import datastore_admin
 from google.cloud.datastore_admin_v1.types import index
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.oauth2 import service_account
 from google.protobuf import empty_pb2  # type: ignore
 import google.auth

tests/unit/gapic/datastore_v1/test_datastore.py

@@ -51,7 +51,7 @@
 from google.cloud.datastore_v1.types import datastore
 from google.cloud.datastore_v1.types import entity
 from google.cloud.datastore_v1.types import query
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.oauth2 import service_account
 from google.protobuf import struct_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore