docs: Minor formatting (#11632)

- [ ] Regenerate this pull request now. 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: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRhdGFwcm9jLW1ldGFzdG9yZS8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRhdGFzdHJlYW0vLk93bEJvdC55YW1sIiwiaCI6IjI4MDI2NGNhMDJmYjkzMTZiNDIzN2E5NmQwYWYxYTIzNDNhODFhNTYifQ== Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRlcGxveS8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpYWxvZ2Zsb3ctY3gvLk93bEJvdC55YW1sIiwiaCI6IjI4MDI2NGNhMDJmYjkzMTZiNDIzN2E5NmQwYWYxYTIzNDNhODFhNTYifQ== Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpc2NvdmVyeWVuZ2luZS8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRvY3VtZW50YWkvLk93bEJvdC55YW1sIiwiaCI6IjI4MDI2NGNhMDJmYjkzMTZiNDIzN2E5NmQwYWYxYTIzNDNhODFhNTYifQ== Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRvbWFpbnMvLk93bEJvdC55YW1sIiwiaCI6IjI4MDI2NGNhMDJmYjkzMTZiNDIzN2E5NmQwYWYxYTIzNDNhODFhNTYifQ== Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWVkZ2Vjb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6IjI4MDI2NGNhMDJmYjkzMTZiNDIzN2E5NmQwYWYxYTIzNDNhODFhNTYifQ== Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWVudGVycHJpc2Vrbm93bGVkZ2VncmFwaC8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWVzc2VudGlhbC1jb250YWN0cy8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWV2ZW50YXJjLXB1Ymxpc2hpbmcvLk93bEJvdC55YW1sIiwiaCI6IjI4MDI2NGNhMDJmYjkzMTZiNDIzN2E5NmQwYWYxYTIzNDNhODFhNTYifQ== Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWV2ZW50YXJjLy5Pd2xCb3QueWFtbCIsImgiOiIyODAyNjRjYTAyZmI5MzE2YjQyMzdhOTZkMGFmMWEyMzQzYTgxYTU2In0= Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWZ1bmN0aW9ucy8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWdrZS1jb25uZWN0LWdhdGV3YXkvLk93bEJvdC55YW1sIiwiaCI6IjI4MDI2NGNhMDJmYjkzMTZiNDIzN2E5NmQwYWYxYTIzNDNhODFhNTYifQ== Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWdrZS1tdWx0aWNsb3VkLy5Pd2xCb3QueWFtbCIsImgiOiIyODAyNjRjYTAyZmI5MzE2YjQyMzdhOTZkMGFmMWEyMzQzYTgxYTU2In0= Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWlhbS1sb2dnaW5nLy5Pd2xCb3QueWFtbCIsImgiOiIyODAyNjRjYTAyZmI5MzE2YjQyMzdhOTZkMGFmMWEyMzQzYTgxYTU2In0= Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWlhbS8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWlhcC8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWlkcy8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWttcy1pbnZlbnRvcnkvLk93bEJvdC55YW1sIiwiaCI6IjI4MDI2NGNhMDJmYjkzMTZiNDIzN2E5NmQwYWYxYTIzNDNhODFhNTYifQ== --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com> Co-authored-by: Anthonios Partheniou <partheniou@google.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-dataproc-metastore/.flake8

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright 2020 Google LLC
+# Copyright 2023 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

packages/google-cloud-dataproc-metastore/CONTRIBUTING.rst

@@ -236,7 +236,7 @@ We support:
 
 Supported versions can be found in our ``noxfile.py`` `config`_.
 
-.. _config: https://github.com/googleapis/google-cloud-python/blob/main/noxfile.py
+.. _config: https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-dataproc-metastore/noxfile.py
 
 
 **********

packages/google-cloud-dataproc-metastore/MANIFEST.in

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright 2020 Google LLC
+# Copyright 2023 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

packages/google-cloud-dataproc-metastore/README.rst

@@ -36,21 +36,24 @@ In order to use this library, you first need to go through the following steps:
 Installation
 ~~~~~~~~~~~~
 
-Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
-create isolated Python environments. The basic problem it addresses is one of
-dependencies and versions, and indirectly permissions.
+Install this library in a virtual environment using `venv`_. `venv`_ is a tool that
+creates isolated Python environments. These isolated environments can have separate
+versions of Python packages, which allows you to isolate one project's dependencies
+from the dependencies of other projects.
 
-With `virtualenv`_, it's possible to install this library without needing system
+With `venv`_, it's possible to install this library without needing system
 install permissions, and without clashing with the installed system
 dependencies.
 
-.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+.. _`venv`: https://docs.python.org/3/library/venv.html
 
 
 Code samples and snippets
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Code samples and snippets live in the `samples/` folder.
+Code samples and snippets live in the `samples/`_ folder.
+
+.. _samples/: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-dataproc-metastore/samples
 
 
 Supported Python Versions
@@ -77,21 +80,19 @@ Mac/Linux
 
 .. code-block:: console
 
- pip install virtualenv
- virtualenv <your-env>
+ python3 -m venv <your-env>
  source <your-env>/bin/activate
- <your-env>/bin/pip install google-cloud-dataproc-metastore
+ pip install google-cloud-dataproc-metastore
 
 
 Windows
 ^^^^^^^
 
 .. code-block:: console
 
- pip install virtualenv
- virtualenv <your-env>
- <your-env>\Scripts\activate
- <your-env>\Scripts\pip.exe install google-cloud-dataproc-metastore
+ py -m venv <your-env>
+ .\<your-env>\Scripts\activate
+ pip install google-cloud-dataproc-metastore
 
 Next Steps
 ~~~~~~~~~~

packages/google-cloud-dataproc-metastore/docs/conf.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2021 Google LLC
+# Copyright 2023 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

packages/google-cloud-dataproc-metastore/google/cloud/metastore_v1/services/dataproc_metastore/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
@@ -550,6 +550,7 @@ async def sample_create_service():
  service, which is used as the final
  component of the metastore service's
  name.
+
  This value must be between 2 and 63
  characters long inclusive, begin with a
  letter, end with a letter or number, and
@@ -1182,6 +1183,7 @@ async def sample_create_metadata_import():
  Required. The ID of the metadata
  import, which is used as the final
  component of the metadata import's name.
+
  This value must be between 1 and 64
  characters long, begin with a letter,
  end with a letter or number, and consist
@@ -1912,6 +1914,7 @@ async def sample_create_backup():
  Required. The ID of the backup, which
  is used as the final component of the
  backup's name.
+
  This value must be between 1 and 64
  characters long, begin with a letter,
  end with a letter or number, and consist

packages/google-cloud-dataproc-metastore/google/cloud/metastore_v1/services/dataproc_metastore/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
@@ -858,6 +858,7 @@ def sample_create_service():
  service, which is used as the final
  component of the metastore service's
  name.
+
  This value must be between 2 and 63
  characters long inclusive, begin with a
  letter, end with a letter or number, and
@@ -1490,6 +1491,7 @@ def sample_create_metadata_import():
  Required. The ID of the metadata
  import, which is used as the final
  component of the metadata import's name.
+
  This value must be between 1 and 64
  characters long, begin with a letter,
  end with a letter or number, and consist
@@ -2221,6 +2223,7 @@ def sample_create_backup():
  Required. The ID of the backup, which
  is used as the final component of the
  backup's name.
+
  This value must be between 1 and 64
  characters long, begin with a letter,
  end with a letter or number, and consist

packages/google-cloud-dataproc-metastore/google/cloud/metastore_v1/services/dataproc_metastore/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

packages/google-cloud-dataproc-metastore/google/cloud/metastore_v1/services/dataproc_metastore_federation/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
@@ -308,6 +308,7 @@ async def sample_list_federations():
  Returns:
  google.cloud.metastore_v1.services.dataproc_metastore_federation.pagers.ListFederationsAsyncPager:
  Response message for ListFederations
+
  Iterating over this object will yield
  results and resolve additional pages
  automatically.
@@ -543,6 +544,7 @@ async def sample_create_federation():
  federation, which is used as the final
  component of the metastore federation's
  name.
+
  This value must be between 2 and 63
  characters long inclusive, begin with a
  letter, end with a letter or number, and

packages/google-cloud-dataproc-metastore/google/cloud/metastore_v1/services/dataproc_metastore_federation/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
@@ -534,6 +534,7 @@ def sample_list_federations():
  Returns:
  google.cloud.metastore_v1.services.dataproc_metastore_federation.pagers.ListFederationsPager:
  Response message for ListFederations
+
  Iterating over this object will yield
  results and resolve additional pages
  automatically.
@@ -769,6 +770,7 @@ def sample_create_federation():
  federation, which is used as the final
  component of the metastore federation's
  name.
+
  This value must be between 2 and 63
  characters long inclusive, begin with a
  letter, end with a letter or number, and