docs: Minor formatting (#441)

* 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/pubsublite_v1/services/admin_service/async_client.py

@@ -47,7 +47,7 @@
 from google.cloud.pubsublite_v1.services.admin_service import pagers
 from google.cloud.pubsublite_v1.types import admin
 from google.cloud.pubsublite_v1.types import common
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 from .transports.base import AdminServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc_asyncio import AdminServiceGrpcAsyncIOTransport
@@ -601,6 +601,7 @@ async def sample_list_topics():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListTopicsAsyncPager:
                 Response for ListTopics.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -914,6 +915,7 @@ async def sample_list_topic_subscriptions():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListTopicSubscriptionsAsyncPager:
                 Response for ListTopicSubscriptions.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -1256,6 +1258,7 @@ async def sample_list_subscriptions():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListSubscriptionsAsyncPager:
                 Response for ListSubscriptions.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -1920,6 +1923,7 @@ async def sample_list_reservations():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListReservationsAsyncPager:
                 Response for ListReservations.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -2237,6 +2241,7 @@ async def sample_list_reservation_topics():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListReservationTopicsAsyncPager:
                 Response for ListReservationTopics.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

google/cloud/pubsublite_v1/services/admin_service/client.py

@@ -51,7 +51,7 @@
 from google.cloud.pubsublite_v1.services.admin_service import pagers
 from google.cloud.pubsublite_v1.types import admin
 from google.cloud.pubsublite_v1.types import common
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 from .transports.base import AdminServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc import AdminServiceGrpcTransport
@@ -872,6 +872,7 @@ def sample_list_topics():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListTopicsPager:
                 Response for ListTopics.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -1185,6 +1186,7 @@ def sample_list_topic_subscriptions():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListTopicSubscriptionsPager:
                 Response for ListTopicSubscriptions.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -1527,6 +1529,7 @@ def sample_list_subscriptions():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListSubscriptionsPager:
                 Response for ListSubscriptions.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -2192,6 +2195,7 @@ def sample_list_reservations():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListReservationsPager:
                 Response for ListReservations.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -2509,6 +2513,7 @@ def sample_list_reservation_topics():
         Returns:
             google.cloud.pubsublite_v1.services.admin_service.pagers.ListReservationTopicsPager:
                 Response for ListReservationTopics.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

google/cloud/pubsublite_v1/services/admin_service/transports/base.py

@@ -29,7 +29,6 @@
 
 from google.cloud.pubsublite_v1.types import admin
 from google.cloud.pubsublite_v1.types import common
-from google.longrunning import operations_pb2
 from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 

google/cloud/pubsublite_v1/services/admin_service/transports/grpc.py

@@ -27,7 +27,6 @@
 
 from google.cloud.pubsublite_v1.types import admin
 from google.cloud.pubsublite_v1.types import common
-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 AdminServiceTransport, DEFAULT_CLIENT_INFO

google/cloud/pubsublite_v1/services/admin_service/transports/grpc_asyncio.py

@@ -27,7 +27,6 @@
 
 from google.cloud.pubsublite_v1.types import admin
 from google.cloud.pubsublite_v1.types import common
-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 AdminServiceTransport, DEFAULT_CLIENT_INFO

google/cloud/pubsublite_v1/services/cursor_service/async_client.py

@@ -47,7 +47,7 @@
 
 from google.cloud.pubsublite_v1.services.cursor_service import pagers
 from google.cloud.pubsublite_v1.types import cursor
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .transports.base import CursorServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc_asyncio import CursorServiceGrpcAsyncIOTransport
 from .client import CursorServiceClient
@@ -454,6 +454,7 @@ async def sample_list_partition_cursors():
         Returns:
             google.cloud.pubsublite_v1.services.cursor_service.pagers.ListPartitionCursorsAsyncPager:
                 Response for ListPartitionCursors
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

google/cloud/pubsublite_v1/services/cursor_service/client.py

@@ -50,7 +50,7 @@
 
 from google.cloud.pubsublite_v1.services.cursor_service import pagers
 from google.cloud.pubsublite_v1.types import cursor
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .transports.base import CursorServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc import CursorServiceGrpcTransport
 from .transports.grpc_asyncio import CursorServiceGrpcAsyncIOTransport
@@ -662,6 +662,7 @@ def sample_list_partition_cursors():
         Returns:
             google.cloud.pubsublite_v1.services.cursor_service.pagers.ListPartitionCursorsPager:
                 Response for ListPartitionCursors
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

google/cloud/pubsublite_v1/services/cursor_service/transports/base.py

@@ -27,7 +27,7 @@
 from google.oauth2 import service_account  # type: ignore
 
 from google.cloud.pubsublite_v1.types import cursor
-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/pubsublite_v1/services/cursor_service/transports/grpc.py

@@ -25,7 +25,7 @@
 import grpc  # type: ignore
 
 from google.cloud.pubsublite_v1.types import cursor
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import CursorServiceTransport, DEFAULT_CLIENT_INFO
 
 

google/cloud/pubsublite_v1/services/cursor_service/transports/grpc_asyncio.py

@@ -25,7 +25,7 @@
 from grpc.experimental import aio  # type: ignore
 
 from google.cloud.pubsublite_v1.types import cursor
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import CursorServiceTransport, DEFAULT_CLIENT_INFO
 from .grpc import CursorServiceGrpcTransport
 

google/cloud/pubsublite_v1/services/partition_assignment_service/async_client.py

@@ -46,7 +46,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .transports.base import PartitionAssignmentServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc_asyncio import PartitionAssignmentServiceGrpcAsyncIOTransport
 from .client import PartitionAssignmentServiceClient

google/cloud/pubsublite_v1/services/partition_assignment_service/client.py

@@ -49,7 +49,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .transports.base import PartitionAssignmentServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc import PartitionAssignmentServiceGrpcTransport
 from .transports.grpc_asyncio import PartitionAssignmentServiceGrpcAsyncIOTransport

google/cloud/pubsublite_v1/services/partition_assignment_service/transports/base.py

@@ -27,7 +27,7 @@
 from google.oauth2 import service_account  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-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/pubsublite_v1/services/partition_assignment_service/transports/grpc.py

@@ -25,7 +25,7 @@
 import grpc  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import PartitionAssignmentServiceTransport, DEFAULT_CLIENT_INFO
 
 

google/cloud/pubsublite_v1/services/partition_assignment_service/transports/grpc_asyncio.py

@@ -25,7 +25,7 @@
 from grpc.experimental import aio  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import PartitionAssignmentServiceTransport, DEFAULT_CLIENT_INFO
 from .grpc import PartitionAssignmentServiceGrpcTransport
 

google/cloud/pubsublite_v1/services/publisher_service/async_client.py

@@ -46,7 +46,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.pubsublite_v1.types import publisher
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .transports.base import PublisherServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc_asyncio import PublisherServiceGrpcAsyncIOTransport
 from .client import PublisherServiceClient

google/cloud/pubsublite_v1/services/publisher_service/client.py

@@ -49,7 +49,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.pubsublite_v1.types import publisher
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .transports.base import PublisherServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc import PublisherServiceGrpcTransport
 from .transports.grpc_asyncio import PublisherServiceGrpcAsyncIOTransport

google/cloud/pubsublite_v1/services/publisher_service/transports/base.py

@@ -27,7 +27,7 @@
 from google.oauth2 import service_account  # type: ignore
 
 from google.cloud.pubsublite_v1.types import publisher
-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/pubsublite_v1/services/publisher_service/transports/grpc.py

@@ -25,7 +25,7 @@
 import grpc  # type: ignore
 
 from google.cloud.pubsublite_v1.types import publisher
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import PublisherServiceTransport, DEFAULT_CLIENT_INFO
 
 

google/cloud/pubsublite_v1/services/publisher_service/transports/grpc_asyncio.py

@@ -25,7 +25,7 @@
 from grpc.experimental import aio  # type: ignore
 
 from google.cloud.pubsublite_v1.types import publisher
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import PublisherServiceTransport, DEFAULT_CLIENT_INFO
 from .grpc import PublisherServiceGrpcTransport
 

google/cloud/pubsublite_v1/services/subscriber_service/async_client.py

@@ -46,7 +46,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .transports.base import SubscriberServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc_asyncio import SubscriberServiceGrpcAsyncIOTransport
 from .client import SubscriberServiceClient

google/cloud/pubsublite_v1/services/subscriber_service/client.py

@@ -49,7 +49,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .transports.base import SubscriberServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc import SubscriberServiceGrpcTransport
 from .transports.grpc_asyncio import SubscriberServiceGrpcAsyncIOTransport

google/cloud/pubsublite_v1/services/subscriber_service/transports/base.py

@@ -27,7 +27,7 @@
 from google.oauth2 import service_account  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-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/pubsublite_v1/services/subscriber_service/transports/grpc.py

@@ -25,7 +25,7 @@
 import grpc  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import SubscriberServiceTransport, DEFAULT_CLIENT_INFO
 
 

google/cloud/pubsublite_v1/services/subscriber_service/transports/grpc_asyncio.py

@@ -25,7 +25,7 @@
 from grpc.experimental import aio  # type: ignore
 
 from google.cloud.pubsublite_v1.types import subscriber
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import SubscriberServiceTransport, DEFAULT_CLIENT_INFO
 from .grpc import SubscriberServiceGrpcTransport
 

google/cloud/pubsublite_v1/services/topic_stats_service/async_client.py

@@ -44,7 +44,7 @@
 
 from google.cloud.pubsublite_v1.types import common
 from google.cloud.pubsublite_v1.types import topic_stats
-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 TopicStatsServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc_asyncio import TopicStatsServiceGrpcAsyncIOTransport

google/cloud/pubsublite_v1/services/topic_stats_service/client.py

@@ -48,7 +48,7 @@
 
 from google.cloud.pubsublite_v1.types import common
 from google.cloud.pubsublite_v1.types import topic_stats
-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 TopicStatsServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc import TopicStatsServiceGrpcTransport

google/cloud/pubsublite_v1/services/topic_stats_service/transports/base.py

@@ -27,7 +27,7 @@
 from google.oauth2 import service_account  # type: ignore
 
 from google.cloud.pubsublite_v1.types import topic_stats
-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/pubsublite_v1/services/topic_stats_service/transports/grpc.py

@@ -25,7 +25,7 @@
 import grpc  # type: ignore
 
 from google.cloud.pubsublite_v1.types import topic_stats
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import TopicStatsServiceTransport, DEFAULT_CLIENT_INFO
 
 

google/cloud/pubsublite_v1/services/topic_stats_service/transports/grpc_asyncio.py

@@ -25,7 +25,7 @@
 from grpc.experimental import aio  # type: ignore
 
 from google.cloud.pubsublite_v1.types import topic_stats
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from .base import TopicStatsServiceTransport, DEFAULT_CLIENT_INFO
 from .grpc import TopicStatsServiceGrpcTransport
 

google/cloud/pubsublite_v1/types/publisher.py

@@ -49,6 +49,7 @@ class InitialPublishRequest(proto.Message):
             Unique identifier for a publisher client. If
             set, enables publish idempotency within a
             publisher client session.
+
             The length of this field must be exactly 16
             bytes long and should be populated with a 128
             bit uuid, generated by standard uuid algorithms
@@ -122,6 +123,7 @@ class MessagePublishResponse(proto.Message):
             Cursors for messages published in the batch.
             There will exist multiple ranges when cursors
             are not contiguous within the batch.
+
             The cursor ranges may not account for all
             messages in the batch when publish idempotency
             is enabled. A missing range indicates that

google/cloud/pubsublite_v1/types/subscriber.py

@@ -324,6 +324,7 @@ class InitialPartitionAssignmentRequest(proto.Message):
             Other size values will be rejected and the
             stream will be failed with a non-retryable
             error.
+
             This field is large enough to fit a uuid from
             standard uuid algorithms like uuid1 or uuid4,
             which should be used to generate this number.

tests/unit/gapic/pubsublite_v1/test_admin_service.py

@@ -47,7 +47,7 @@
 from google.cloud.pubsublite_v1.services.admin_service import transports
 from google.cloud.pubsublite_v1.types import admin
 from google.cloud.pubsublite_v1.types import common
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.oauth2 import service_account
 from google.protobuf import duration_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore