docs: Minor formatting (#253)

* 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/gkehub_v1/types/feature.py

@@ -59,10 +59,12 @@ class Feature(proto.Message):
  for this Feature. If this Feature does not
  support any per-Membership configuration, this
  field may be unused.
+
  The keys indicate which Membership the
  configuration is for, in the form:
 
  `projects/{p}/locations/{l}/memberships/{m}`
+
  Where {p} is the project, {l} is a valid
  location and {m} is a valid Membership in this
  project at that location. {p} WILL match the
@@ -83,10 +85,12 @@ class Feature(proto.Message):
  Output only. Membership-specific Feature
  status. If this Feature does report any
  per-Membership status, this field may be unused.
+
  The keys indicate which Membership the state is
  for, in the form:
 
  `projects/{p}/locations/{l}/memberships/{m}`
+
  Where {p} is the project number, {l} is a valid
  location and {m} is a valid Membership in this
  project at that location. {p} MUST match the

google/cloud/gkehub_v1/types/membership.py

@@ -242,6 +242,7 @@ class KubernetesResource(proto.Message):
  Input only. The YAML representation of the
  Membership CR. This field is ignored for GKE
  clusters where Hub can read the CR directly.
+
  Callers should provide the CR that is currently
  present in the cluster during CreateMembership
  or UpdateMembership, or leave this field empty
@@ -252,6 +253,7 @@ class KubernetesResource(proto.Message):
  Output only. Additional Kubernetes resources
  that need to be applied to the cluster after
  Membership creation, and after every update.
+
  This field is only populated in the Membership
  returned from a successful long-running
  operation from CreateMembership or
@@ -368,6 +370,7 @@ class GkeCluster(proto.Message):
  resource for the GKE cluster. For example:
 
  //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster
+
  Zonal clusters are also supported.
  cluster_missing (bool):
  Output only. If cluster_missing is set then it denotes that

google/cloud/gkehub_v1/types/service.py

@@ -196,6 +196,7 @@ class CreateMembershipRequest(proto.Message):
  ignore the request if it has already been
  completed. The server will guarantee that for at
  least 60 minutes after the first request.
+
  For example, consider a situation where you make
  an initial request and the request times out. If
  you make the request again with the same request
@@ -204,6 +205,7 @@ class CreateMembershipRequest(proto.Message):
  so, will ignore the second request. This
  prevents clients from accidentally creating
  duplicate commitments.
+
  The request ID must be a valid UUID with the
  exception that zero UUID is not supported
  (00000000-0000-0000-0000-000000000000).
@@ -242,6 +244,7 @@ class DeleteMembershipRequest(proto.Message):
  ignore the request if it has already been
  completed. The server will guarantee that for at
  least 60 minutes after the first request.
+
  For example, consider a situation where you make
  an initial request and the request times out. If
  you make the request again with the same request
@@ -250,6 +253,7 @@ class DeleteMembershipRequest(proto.Message):
  so, will ignore the second request. This
  prevents clients from accidentally creating
  duplicate commitments.
+
  The request ID must be a valid UUID with the
  exception that zero UUID is not supported
  (00000000-0000-0000-0000-000000000000).
@@ -299,6 +303,7 @@ class UpdateMembershipRequest(proto.Message):
  ignore the request if it has already been
  completed. The server will guarantee that for at
  least 60 minutes after the first request.
+
  For example, consider a situation where you make
  an initial request and the request times out. If
  you make the request again with the same request
@@ -307,6 +312,7 @@ class UpdateMembershipRequest(proto.Message):
  so, will ignore the second request. This
  prevents clients from accidentally creating
  duplicate commitments.
+
  The request ID must be a valid UUID with the
  exception that zero UUID is not supported
  (00000000-0000-0000-0000-000000000000).
@@ -585,6 +591,7 @@ class CreateFeatureRequest(proto.Message):
  ignore the request if it has already been
  completed. The server will guarantee that for at
  least 60 minutes after the first request.
+
  For example, consider a situation where you make
  an initial request and the request times out. If
  you make the request again with the same request
@@ -593,6 +600,7 @@ class CreateFeatureRequest(proto.Message):
  so, will ignore the second request. This
  prevents clients from accidentally creating
  duplicate commitments.
+
  The request ID must be a valid UUID with the
  exception that zero UUID is not supported
  (00000000-0000-0000-0000-000000000000).
@@ -636,6 +644,7 @@ class DeleteFeatureRequest(proto.Message):
  ignore the request if it has already been
  completed. The server will guarantee that for at
  least 60 minutes after the first request.
+
  For example, consider a situation where you make
  an initial request and the request times out. If
  you make the request again with the same request
@@ -644,6 +653,7 @@ class DeleteFeatureRequest(proto.Message):
  so, will ignore the second request. This
  prevents clients from accidentally creating
  duplicate commitments.
+
  The request ID must be a valid UUID with the
  exception that zero UUID is not supported
  (00000000-0000-0000-0000-000000000000).
@@ -688,6 +698,7 @@ class UpdateFeatureRequest(proto.Message):
  ignore the request if it has already been
  completed. The server will guarantee that for at
  least 60 minutes after the first request.
+
  For example, consider a situation where you make
  an initial request and the request times out. If
  you make the request again with the same request
@@ -696,6 +707,7 @@ class UpdateFeatureRequest(proto.Message):
  so, will ignore the second request. This
  prevents clients from accidentally creating
  duplicate commitments.
+
  The request ID must be a valid UUID with the
  exception that zero UUID is not supported
  (00000000-0000-0000-0000-000000000000).

google/cloud/gkehub_v1beta1/services/gke_hub_membership_service/async_client.py

@@ -47,7 +47,7 @@
 from google.cloud.location import locations_pb2 # type: ignore
 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 google.protobuf import field_mask_pb2 # type: ignore
 from google.protobuf import timestamp_pb2 # type: ignore
@@ -1070,6 +1070,7 @@ async def generate_exclusivity_manifest(
  r"""GenerateExclusivityManifest generates the manifests
  to update the exclusivity artifacts in the cluster if
  needed.
+
  Exclusivity artifacts include the Membership custom
  resource definition (CRD) and the singleton Membership
  custom resource (CR). Combined with ValidateExclusivity,

google/cloud/gkehub_v1beta1/services/gke_hub_membership_service/client.py

@@ -51,7 +51,7 @@
 from google.cloud.location import locations_pb2 # type: ignore
 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 google.protobuf import field_mask_pb2 # type: ignore
 from google.protobuf import timestamp_pb2 # type: ignore
@@ -1298,6 +1298,7 @@ def generate_exclusivity_manifest(
  r"""GenerateExclusivityManifest generates the manifests
  to update the exclusivity artifacts in the cluster if
  needed.
+
  Exclusivity artifacts include the Membership custom
  resource definition (CRD) and the singleton Membership
  custom resource (CR). Combined with ValidateExclusivity,

google/cloud/gkehub_v1beta1/services/gke_hub_membership_service/transports/grpc.py

@@ -471,6 +471,7 @@ def generate_exclusivity_manifest(
  GenerateExclusivityManifest generates the manifests
  to update the exclusivity artifacts in the cluster if
  needed.
+
  Exclusivity artifacts include the Membership custom
  resource definition (CRD) and the singleton Membership
  custom resource (CR). Combined with ValidateExclusivity,

google/cloud/gkehub_v1beta1/services/gke_hub_membership_service/transports/grpc_asyncio.py

@@ -484,6 +484,7 @@ def generate_exclusivity_manifest(
  GenerateExclusivityManifest generates the manifests
  to update the exclusivity artifacts in the cluster if
  needed.
+
  Exclusivity artifacts include the Membership custom
  resource definition (CRD) and the singleton Membership
  custom resource (CR). Combined with ValidateExclusivity,

google/cloud/gkehub_v1beta1/services/gke_hub_membership_service/transports/rest.py

@@ -35,7 +35,6 @@
 from google.cloud.location import locations_pb2 # type: ignore
 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.protobuf import json_format
 import grpc # type: ignore
 from requests import __version__ as requests_version

google/cloud/gkehub_v1beta1/types/membership.py

@@ -146,6 +146,7 @@ class InfrastructureType(proto.Enum):
  r"""Specifies the infrastructure type of a Membership.
  Infrastructure type is used by Hub to control
  infrastructure-specific behavior, including pricing.
+
  Each GKE distribution (on-GCP, on-Prem, on-X,...) will set this
  field automatically, but Attached Clusters customers should
  specify a type during registration.
@@ -344,6 +345,7 @@ class KubernetesResource(proto.Message):
  Input only. The YAML representation of the
  Membership CR. This field is ignored for GKE
  clusters where Hub can read the CR directly.
+
  Callers should provide the CR that is currently
  present in the cluster during CreateMembership
  or UpdateMembership, or leave this field empty
@@ -354,6 +356,7 @@ class KubernetesResource(proto.Message):
  Output only. Additional Kubernetes resources
  that need to be applied to the cluster after
  Membership creation, and after every update.
+
  This field is only populated in the Membership
  returned from a successful long-running
  operation from CreateMembership or
@@ -468,8 +471,8 @@ class GkeCluster(proto.Message):
  resource_link (str):
  Immutable. Self-link of the GCP resource for
  the GKE cluster. For example:
-
  //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster
+
  Zonal clusters are also supported.
  cluster_missing (bool):
  Output only. If cluster_missing is set then it denotes that
@@ -993,6 +996,7 @@ class CreateMembershipRequest(proto.Message):
  ignore the request if it has already been
  completed. The server will guarantee that for at
  least 60 minutes after the first request.
+
  For example, consider a situation where you make
  an initial request and the request times out. If
  you make the request again with the same request
@@ -1001,6 +1005,7 @@ class CreateMembershipRequest(proto.Message):
  so, will ignore the second request. This
  prevents clients from accidentally creating
  duplicate commitments.
+
  The request ID must be a valid UUID with the
  exception that zero UUID is not supported
  (00000000-0000-0000-0000-000000000000).
@@ -1040,6 +1045,7 @@ class DeleteMembershipRequest(proto.Message):
  ignore the request if it has already been
  completed. The server will guarantee that for at
  least 60 minutes after the first request.
+
  For example, consider a situation where you make
  an initial request and the request times out. If
  you make the request again with the same request
@@ -1048,6 +1054,7 @@ class DeleteMembershipRequest(proto.Message):
  so, will ignore the second request. This
  prevents clients from accidentally creating
  duplicate commitments.
+
  The request ID must be a valid UUID with the
  exception that zero UUID is not supported
  (00000000-0000-0000-0000-000000000000).
@@ -1099,6 +1106,7 @@ class UpdateMembershipRequest(proto.Message):
  ignore the request if it has already been
  completed. The server will guarantee that for at
  least 60 minutes after the first request.
+
  For example, consider a situation where you make
  an initial request and the request times out. If
  you make the request again with the same request
@@ -1107,6 +1115,7 @@ class UpdateMembershipRequest(proto.Message):
  so, will ignore the second request. This
  prevents clients from accidentally creating
  duplicate commitments.
+
  The request ID must be a valid UUID with the
  exception that zero UUID is not supported
  (00000000-0000-0000-0000-000000000000).

tests/unit/gapic/gkehub_v1/test_gke_hub.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 empty_pb2 # type: ignore
 from google.protobuf import field_mask_pb2 # type: ignore