docs: Minor formatting (#175)

* 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: https://github.com/googleapis/googleapis-gen/commit/280264ca02fb9316b4237a96d0af1a2343a81a56 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/storage_transfer_v1/services/storage_transfer_service/async_client.py

@@ -44,7 +44,7 @@
 
 from google.api_core import operation # type: ignore
 from google.api_core import operation_async # 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 google.protobuf import field_mask_pb2 # type: ignore
 from google.protobuf import timestamp_pb2 # type: ignore
@@ -614,6 +614,7 @@ async def sample_list_transfer_jobs():
  Returns:
  google.cloud.storage_transfer_v1.services.storage_transfer_service.pagers.ListTransferJobsAsyncPager:
  Response from ListTransferJobs.
+
  Iterating over this object will yield
  results and resolve additional pages
  automatically.
@@ -1389,6 +1390,7 @@ async def sample_list_agent_pools():
  Returns:
  google.cloud.storage_transfer_v1.services.storage_transfer_service.pagers.ListAgentPoolsAsyncPager:
  Response from ListAgentPools.
+
  Iterating over this object will yield
  results and resolve additional pages
  automatically.

google/cloud/storage_transfer_v1/services/storage_transfer_service/client.py

@@ -48,7 +48,7 @@
 
 from google.api_core import operation # type: ignore
 from google.api_core import operation_async # 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 google.protobuf import field_mask_pb2 # type: ignore
 from google.protobuf import timestamp_pb2 # type: ignore
@@ -841,6 +841,7 @@ def sample_list_transfer_jobs():
  Returns:
  google.cloud.storage_transfer_v1.services.storage_transfer_service.pagers.ListTransferJobsPager:
  Response from ListTransferJobs.
+
  Iterating over this object will yield
  results and resolve additional pages
  automatically.
@@ -1623,6 +1624,7 @@ def sample_list_agent_pools():
  Returns:
  google.cloud.storage_transfer_v1.services.storage_transfer_service.pagers.ListAgentPoolsPager:
  Response from ListAgentPools.
+
  Iterating over this object will yield
  results and resolve additional pages
  automatically.

google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/rest.py

@@ -32,7 +32,6 @@
 from google.auth import credentials as ga_credentials # type: ignore
 from google.auth.transport.grpc import SslCredentials # type: ignore
 from google.auth.transport.requests import AuthorizedSession # type: ignore
-from google.longrunning import operations_pb2
 from google.protobuf import json_format
 import grpc # type: ignore
 from requests import __version__ as requests_version

google/cloud/storage_transfer_v1/types/transfer_types.py

@@ -336,6 +336,7 @@ class AwsS3Data(proto.Message):
  credentials </storage-transfer/docs/data-retention#user-credentials>`__.
  path (str):
  Root path to transfer objects.
+
  Must be an empty string or full path name that
  ends with a '/'. This field is treated as an
  object prefix. As such, it should generally not
@@ -430,6 +431,7 @@ class AzureBlobStorageData(proto.Message):
  Azure Storage account.
  path (str):
  Root path to transfer objects.
+
  Must be an empty string or full path name that
  ends with a '/'. This field is treated as an
  object prefix. As such, it should generally not
@@ -567,6 +569,7 @@ class AwsS3CompatibleData(proto.Message):
  Required. Specifies the name of the bucket.
  path (str):
  Specifies the root path to transfer objects.
+
  Must be an empty string or full path name that
  ends with a '/'. This field is treated as an
  object prefix. As such, it should generally not
@@ -678,10 +681,9 @@ class NetworkProtocol(proto.Enum):
  Perform requests using HTTPS.
  NETWORK_PROTOCOL_HTTP (2):
  Not recommended: This sends data in
- clear-text. This is only
- appropriate within a closed network or for
- publicly available data. Perform requests using
- HTTP.
+ clear-text. This is only appropriate within a
+ closed network or for publicly available data.
+ Perform requests using HTTP.
  """
  NETWORK_PROTOCOL_UNSPECIFIED = 0
  NETWORK_PROTOCOL_HTTPS = 1
@@ -1700,6 +1702,7 @@ class ErrorSummary(proto.Message):
  Required. Count of this type of error.
  error_log_entries (MutableSequence[google.cloud.storage_transfer_v1.types.ErrorLogEntry]):
  Error samples.
+
  At most 5 error log entries are recorded for a
  given error code for a single transfer
  operation.
@@ -1787,13 +1790,15 @@ class TransferCounters(proto.Message):
  and ``base/b/`` is 3.
  directories_failed_to_list_from_source (int):
  For transfers involving PosixFilesystem only.
+
  Number of listing failures for each directory
  found at the source. Potential failures when
  listing a directory include permission failure
  or block failure. If listing a directory fails,
  no files in the directory are transferred.
  directories_successfully_listed_from_source (int):
  For transfers involving PosixFilesystem only.
+
  Number of successful listings for each directory
  found at the source.
  intermediate_objects_cleaned_up (int):

tests/unit/gapic/storage_transfer_v1/test_storage_transfer_service.py

@@ -41,7 +41,7 @@
 import google.auth
 from google.auth import credentials as ga_credentials
 from google.auth.exceptions import MutualTLSChannelError
-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 empty_pb2 # type: ignore