docs: Minor formatting (#1006)

* 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>

google/cloud/spanner_admin_database_v1/services/database_admin/async_client.py

@@ -51,7 +51,7 @@
 from google.cloud.spanner_admin_database_v1.types import spanner_database_admin
 from google.iam.v1 import iam_policy_pb2  # type: ignore
 from google.iam.v1 import policy_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
@@ -1257,8 +1257,8 @@ async def sample_set_iam_policy():
                 The request object. Request message for ``SetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy is being specified.
-                See the operation documentation for the
+                policy is being specified. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1400,8 +1400,8 @@ async def sample_get_iam_policy():
                 The request object. Request message for ``GetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy is being requested.
-                See the operation documentation for the
+                policy is being requested. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1555,8 +1555,8 @@ async def sample_test_iam_permissions():
                 The request object. Request message for ``TestIamPermissions`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy detail is being requested.
-                See the operation documentation for the
+                policy detail is being requested. See
+                the operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field

google/cloud/spanner_admin_database_v1/services/database_admin/client.py

@@ -55,7 +55,7 @@
 from google.cloud.spanner_admin_database_v1.types import spanner_database_admin
 from google.iam.v1 import iam_policy_pb2  # type: ignore
 from google.iam.v1 import policy_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
@@ -1523,8 +1523,8 @@ def sample_set_iam_policy():
                 The request object. Request message for ``SetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy is being specified.
-                See the operation documentation for the
+                policy is being specified. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1663,8 +1663,8 @@ def sample_get_iam_policy():
                 The request object. Request message for ``GetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy is being requested.
-                See the operation documentation for the
+                policy is being requested. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1805,8 +1805,8 @@ def sample_test_iam_permissions():
                 The request object. Request message for ``TestIamPermissions`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy detail is being requested.
-                See the operation documentation for the
+                policy detail is being requested. See
+                the operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field

google/cloud/spanner_admin_database_v1/services/database_admin/transports/base.py

@@ -32,7 +32,6 @@
 from google.cloud.spanner_admin_database_v1.types import spanner_database_admin
 from google.iam.v1 import iam_policy_pb2  # type: ignore
 from google.iam.v1 import policy_pb2  # type: ignore
-from google.longrunning import operations_pb2
 from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 

google/cloud/spanner_admin_database_v1/services/database_admin/transports/grpc.py

@@ -30,7 +30,6 @@
 from google.cloud.spanner_admin_database_v1.types import spanner_database_admin
 from google.iam.v1 import iam_policy_pb2  # type: ignore
 from google.iam.v1 import policy_pb2  # type: ignore
-from google.longrunning import operations_pb2
 from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 from .base import DatabaseAdminTransport, DEFAULT_CLIENT_INFO

google/cloud/spanner_admin_database_v1/services/database_admin/transports/grpc_asyncio.py

@@ -30,7 +30,6 @@
 from google.cloud.spanner_admin_database_v1.types import spanner_database_admin
 from google.iam.v1 import iam_policy_pb2  # type: ignore
 from google.iam.v1 import policy_pb2  # type: ignore
-from google.longrunning import operations_pb2
 from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 from .base import DatabaseAdminTransport, DEFAULT_CLIENT_INFO

google/cloud/spanner_admin_database_v1/services/database_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
@@ -46,8 +45,8 @@
 from google.cloud.spanner_admin_database_v1.types import spanner_database_admin
 from google.iam.v1 import iam_policy_pb2  # type: ignore
 from google.iam.v1 import policy_pb2  # type: ignore
-from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
+from google.longrunning import operations_pb2  # type: ignore
 
 from .base import (
     DatabaseAdminTransport,

google/cloud/spanner_admin_database_v1/types/spanner_database_admin.py

@@ -131,6 +131,7 @@ class Database(proto.Message):
             the encryption information for the database,
             such as encryption state and the Cloud KMS key
             versions that are in use.
+
             For databases that are using Google default or
             other types of encryption, this field is empty.
 

google/cloud/spanner_admin_instance_v1/services/instance_admin/async_client.py

@@ -58,10 +58,12 @@
 
 class InstanceAdminAsyncClient:
     """Cloud Spanner Instance Admin API
+
     The Cloud Spanner Instance Admin API can be used to create,
     delete, modify and list instances. Instances are dedicated Cloud
     Spanner serving and storage resources to be used by Cloud
     Spanner databases.
+
     Each instance has a "configuration", which dictates where the
     serving resources for the Cloud Spanner instance are located
     (e.g., US-central, Europe). Configurations are created by Google
@@ -1879,8 +1881,8 @@ async def sample_set_iam_policy():
                 The request object. Request message for ``SetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy is being specified.
-                See the operation documentation for the
+                policy is being specified. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -2018,8 +2020,8 @@ async def sample_get_iam_policy():
                 The request object. Request message for ``GetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy is being requested.
-                See the operation documentation for the
+                policy is being requested. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -2170,8 +2172,8 @@ async def sample_test_iam_permissions():
                 The request object. Request message for ``TestIamPermissions`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy detail is being requested.
-                See the operation documentation for the
+                policy detail is being requested. See
+                the operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field

google/cloud/spanner_admin_instance_v1/services/instance_admin/client.py

@@ -98,10 +98,12 @@ def get_transport_class(
 
 class InstanceAdminClient(metaclass=InstanceAdminClientMeta):
     """Cloud Spanner Instance Admin API
+
     The Cloud Spanner Instance Admin API can be used to create,
     delete, modify and list instances. Instances are dedicated Cloud
     Spanner serving and storage resources to be used by Cloud
     Spanner databases.
+
     Each instance has a "configuration", which dictates where the
     serving resources for the Cloud Spanner instance are located
     (e.g., US-central, Europe). Configurations are created by Google
@@ -2073,8 +2075,8 @@ def sample_set_iam_policy():
                 The request object. Request message for ``SetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy is being specified.
-                See the operation documentation for the
+                policy is being specified. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -2209,8 +2211,8 @@ def sample_get_iam_policy():
                 The request object. Request message for ``GetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy is being requested.
-                See the operation documentation for the
+                policy is being requested. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -2348,8 +2350,8 @@ def sample_test_iam_permissions():
                 The request object. Request message for ``TestIamPermissions`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy detail is being requested.
-                See the operation documentation for the
+                policy detail is being requested. See
+                the operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field

google/cloud/spanner_admin_instance_v1/services/instance_admin/transports/grpc.py

@@ -37,10 +37,12 @@ class InstanceAdminGrpcTransport(InstanceAdminTransport):
     """gRPC backend transport for InstanceAdmin.
 
     Cloud Spanner Instance Admin API
+
     The Cloud Spanner Instance Admin API can be used to create,
     delete, modify and list instances. Instances are dedicated Cloud
     Spanner serving and storage resources to be used by Cloud
     Spanner databases.
+
     Each instance has a "configuration", which dictates where the
     serving resources for the Cloud Spanner instance are located
     (e.g., US-central, Europe). Configurations are created by Google

google/cloud/spanner_admin_instance_v1/services/instance_admin/transports/grpc_asyncio.py

@@ -38,10 +38,12 @@ class InstanceAdminGrpcAsyncIOTransport(InstanceAdminTransport):
     """gRPC AsyncIO backend transport for InstanceAdmin.
 
     Cloud Spanner Instance Admin API
+
     The Cloud Spanner Instance Admin API can be used to create,
     delete, modify and list instances. Instances are dedicated Cloud
     Spanner serving and storage resources to be used by Cloud
     Spanner databases.
+
     Each instance has a "configuration", which dictates where the
     serving resources for the Cloud Spanner instance are located
     (e.g., US-central, Europe). Configurations are created by Google

google/cloud/spanner_admin_instance_v1/services/instance_admin/transports/rest.py

@@ -43,8 +43,8 @@
 from google.cloud.spanner_admin_instance_v1.types import spanner_instance_admin
 from google.iam.v1 import iam_policy_pb2  # type: ignore
 from google.iam.v1 import policy_pb2  # type: ignore
-from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
+from google.longrunning import operations_pb2  # type: ignore
 
 from .base import (
     InstanceAdminTransport,
@@ -505,10 +505,12 @@ class InstanceAdminRestTransport(InstanceAdminTransport):
     """REST backend transport for InstanceAdmin.
 
     Cloud Spanner Instance Admin API
+
     The Cloud Spanner Instance Admin API can be used to create,
     delete, modify and list instances. Instances are dedicated Cloud
     Spanner serving and storage resources to be used by Cloud
     Spanner databases.
+
     Each instance has a "configuration", which dictates where the
     serving resources for the Cloud Spanner instance are located
     (e.g., US-central, Europe). Configurations are created by Google

google/cloud/spanner_v1/services/spanner/async_client.py

@@ -60,6 +60,7 @@
 
 class SpannerAsyncClient:
     """Cloud Spanner API
+
     The Cloud Spanner API can be used to manage sessions and execute
     transactions on data stored in Cloud Spanner databases.
     """
@@ -357,6 +358,7 @@ async def batch_create_sessions(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> spanner.BatchCreateSessionsResponse:
         r"""Creates multiple new sessions.
+
         This API can be used to initialize a session cache on
         the clients. See https://goo.gl/TgSFN2 for best
         practices on session cache management.

google/cloud/spanner_v1/services/spanner/client.py

@@ -99,6 +99,7 @@ def get_transport_class(
 
 class SpannerClient(metaclass=SpannerClientMeta):
     """Cloud Spanner API
+
     The Cloud Spanner API can be used to manage sessions and execute
     transactions on data stored in Cloud Spanner databases.
     """
@@ -604,6 +605,7 @@ def batch_create_sessions(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> spanner.BatchCreateSessionsResponse:
         r"""Creates multiple new sessions.
+
         This API can be used to initialize a session cache on
         the clients. See https://goo.gl/TgSFN2 for best
         practices on session cache management.

google/cloud/spanner_v1/services/spanner/transports/grpc.py

@@ -36,6 +36,7 @@ class SpannerGrpcTransport(SpannerTransport):
     """gRPC backend transport for Spanner.
 
     Cloud Spanner API
+
     The Cloud Spanner API can be used to manage sessions and execute
     transactions on data stored in Cloud Spanner databases.
 
@@ -288,6 +289,7 @@ def batch_create_sessions(
         r"""Return a callable for the batch create sessions method over gRPC.
 
         Creates multiple new sessions.
+
         This API can be used to initialize a session cache on
         the clients. See https://goo.gl/TgSFN2 for best
         practices on session cache management.

google/cloud/spanner_v1/services/spanner/transports/grpc_asyncio.py

@@ -37,6 +37,7 @@ class SpannerGrpcAsyncIOTransport(SpannerTransport):
     """gRPC AsyncIO backend transport for Spanner.
 
     Cloud Spanner API
+
     The Cloud Spanner API can be used to manage sessions and execute
     transactions on data stored in Cloud Spanner databases.
 
@@ -292,6 +293,7 @@ def batch_create_sessions(
         r"""Return a callable for the batch create sessions method over gRPC.
 
         Creates multiple new sessions.
+
         This API can be used to initialize a session cache on
         the clients. See https://goo.gl/TgSFN2 for best
         practices on session cache management.

google/cloud/spanner_v1/services/spanner/transports/rest.py

@@ -493,6 +493,7 @@ class SpannerRestTransport(SpannerTransport):
     """REST backend transport for Spanner.
 
     Cloud Spanner API
+
     The Cloud Spanner API can be used to manage sessions and execute
     transactions on data stored in Cloud Spanner databases.
 

google/cloud/spanner_v1/types/spanner.py

@@ -390,6 +390,7 @@ class ExecuteSqlRequest(proto.Message):
             should be performed.
         transaction (google.cloud.spanner_v1.types.TransactionSelector):
             The transaction to use.
+
             For queries, if none is provided, the default is
             a temporary read-only transaction with strong
             concurrency.
@@ -399,6 +400,7 @@ class ExecuteSqlRequest(proto.Message):
             single-use transactions are not supported.  The
             caller must either supply an existing
             transaction ID or begin a new transaction.
+
             Partitioned DML requires an existing Partitioned
             DML transaction ID.
         sql (str):
@@ -469,6 +471,7 @@ class ExecuteSqlRequest(proto.Message):
             sequence number, the transaction may be aborted.
             Replays of previously handled requests will
             yield the same response as the first execution.
+
             Required for DML statements. Ignored for
             queries.
         query_options (google.cloud.spanner_v1.types.ExecuteSqlRequest.QueryOptions):

google/cloud/spanner_v1/types/transaction.py

@@ -417,13 +417,16 @@ class ReadLockMode(proto.Enum):
             Values:
                 READ_LOCK_MODE_UNSPECIFIED (0):
                     Default value.
+
                     If the value is not specified, the pessimistic
                     read lock is used.
                 PESSIMISTIC (1):
                     Pessimistic lock mode.
+
                     Read locks are acquired immediately on read.
                 OPTIMISTIC (2):
                     Optimistic lock mode.
+
                     Locks for reads within the transaction are not
                     acquired on read. Instead the locks are acquired
                     on a commit to validate that read/queried data

samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-spanner-admin-database",
-    "version": "3.40.1"
+    "version": "0.1.0"
   },
   "snippets": [
     {