docs: Minor formatting (#50)

* 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 * chore(python): Add google/apps/script/type as a proto-plus dependency for google/cloud/gsuiteaddons/v1 PiperOrigin-RevId: 567294499 Source-Link: googleapis/googleapis@0e04632 Source-Link: https://github.com/googleapis/googleapis-gen/commit/720fd1d977a54e12bfcd8e2fe103b7dfda9e767f Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNzIwZmQxZDk3N2E1NGUxMmJmY2Q4ZTJmZTEwM2I3ZGZkYTllNzY3ZiJ9 * 🦉 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>
googleapis · Sep 21, 2023 · 975e10e · 975e10e
1 parent b96be08
commit 975e10e
Show file tree

Hide file tree

Showing 6 changed files with 21 additions and 2 deletions.
diff --git a/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/async_client.py b/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/async_client.py
@@ -54,6 +54,7 @@
 
 class GSuiteAddOnsAsyncClient:
     """A service for managing Google Workspace Add-ons deployments.
+
     A Google Workspace Add-on is a third-party embedded component
     that can be installed in Google Workspace Applications like
     Gmail, Calendar, Drive, and the Google Docs, Sheets, and Slides
@@ -63,6 +64,7 @@ class GSuiteAddOnsAsyncClient:
 
     https://developers.google.com/gsuite/add-ons/overview for more
     information).
+
     A Google Workspace Add-on deployment resource specifies metadata
     about the add-on, including a specification of the entry points
     in the host application that trigger add-on executions (see:
@@ -72,6 +74,7 @@ class GSuiteAddOnsAsyncClient:
     define their entrypoints using HTTPS URLs (See:
 
     https://developers.google.com/gsuite/add-ons/guides/alternate-runtimes),
+
     A Google Workspace Add-on deployment can be installed in
     developer mode, which allows an add-on developer to test the
     experience an end-user would see when installing and running the
@@ -745,6 +748,7 @@ async def sample_list_deployments():
         Returns:
             google.cloud.gsuiteaddons_v1.services.g_suite_add_ons.pagers.ListDeploymentsAsyncPager:
                 Response message to list deployments.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

diff --git a/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/client.py b/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/client.py
@@ -94,6 +94,7 @@ def get_transport_class(
 
 class GSuiteAddOnsClient(metaclass=GSuiteAddOnsClientMeta):
     """A service for managing Google Workspace Add-ons deployments.
+
     A Google Workspace Add-on is a third-party embedded component
     that can be installed in Google Workspace Applications like
     Gmail, Calendar, Drive, and the Google Docs, Sheets, and Slides
@@ -103,6 +104,7 @@ class GSuiteAddOnsClient(metaclass=GSuiteAddOnsClientMeta):
 
     https://developers.google.com/gsuite/add-ons/overview for more
     information).
+
     A Google Workspace Add-on deployment resource specifies metadata
     about the add-on, including a specification of the entry points
     in the host application that trigger add-on executions (see:
@@ -112,6 +114,7 @@ class GSuiteAddOnsClient(metaclass=GSuiteAddOnsClientMeta):
     define their entrypoints using HTTPS URLs (See:
 
     https://developers.google.com/gsuite/add-ons/guides/alternate-runtimes),
+
     A Google Workspace Add-on deployment can be installed in
     developer mode, which allows an add-on developer to test the
     experience an end-user would see when installing and running the
@@ -1002,6 +1005,7 @@ def sample_list_deployments():
         Returns:
             google.cloud.gsuiteaddons_v1.services.g_suite_add_ons.pagers.ListDeploymentsPager:
                 Response message to list deployments.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

diff --git a/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/transports/grpc.py b/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/transports/grpc.py
@@ -32,6 +32,7 @@ class GSuiteAddOnsGrpcTransport(GSuiteAddOnsTransport):
     """gRPC backend transport for GSuiteAddOns.
 
     A service for managing Google Workspace Add-ons deployments.
+
     A Google Workspace Add-on is a third-party embedded component
     that can be installed in Google Workspace Applications like
     Gmail, Calendar, Drive, and the Google Docs, Sheets, and Slides
@@ -41,6 +42,7 @@ class GSuiteAddOnsGrpcTransport(GSuiteAddOnsTransport):
 
     https://developers.google.com/gsuite/add-ons/overview for more
     information).
+
     A Google Workspace Add-on deployment resource specifies metadata
     about the add-on, including a specification of the entry points
     in the host application that trigger add-on executions (see:
@@ -50,6 +52,7 @@ class GSuiteAddOnsGrpcTransport(GSuiteAddOnsTransport):
     define their entrypoints using HTTPS URLs (See:
 
     https://developers.google.com/gsuite/add-ons/guides/alternate-runtimes),
+
     A Google Workspace Add-on deployment can be installed in
     developer mode, which allows an add-on developer to test the
     experience an end-user would see when installing and running the

diff --git a/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/transports/grpc_asyncio.py b/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/transports/grpc_asyncio.py
@@ -33,6 +33,7 @@ class GSuiteAddOnsGrpcAsyncIOTransport(GSuiteAddOnsTransport):
     """gRPC AsyncIO backend transport for GSuiteAddOns.
 
     A service for managing Google Workspace Add-ons deployments.
+
     A Google Workspace Add-on is a third-party embedded component
     that can be installed in Google Workspace Applications like
     Gmail, Calendar, Drive, and the Google Docs, Sheets, and Slides
@@ -42,6 +43,7 @@ class GSuiteAddOnsGrpcAsyncIOTransport(GSuiteAddOnsTransport):
 
     https://developers.google.com/gsuite/add-ons/overview for more
     information).
+
     A Google Workspace Add-on deployment resource specifies metadata
     about the add-on, including a specification of the entry points
     in the host application that trigger add-on executions (see:
@@ -51,6 +53,7 @@ class GSuiteAddOnsGrpcAsyncIOTransport(GSuiteAddOnsTransport):
     define their entrypoints using HTTPS URLs (See:
 
     https://developers.google.com/gsuite/add-ons/guides/alternate-runtimes),
+
     A Google Workspace Add-on deployment can be installed in
     developer mode, which allows an add-on developer to test the
     experience an end-user would see when installing and running the

diff --git a/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/transports/rest.py b/google/cloud/gsuiteaddons_v1/services/g_suite_add_ons/transports/rest.py
@@ -317,6 +317,7 @@ class GSuiteAddOnsRestTransport(GSuiteAddOnsTransport):
     """REST backend transport for GSuiteAddOns.
 
     A service for managing Google Workspace Add-ons deployments.
+
     A Google Workspace Add-on is a third-party embedded component
     that can be installed in Google Workspace Applications like
     Gmail, Calendar, Drive, and the Google Docs, Sheets, and Slides
@@ -326,6 +327,7 @@ class GSuiteAddOnsRestTransport(GSuiteAddOnsTransport):
 
     https://developers.google.com/gsuite/add-ons/overview for more
     information).
+
     A Google Workspace Add-on deployment resource specifies metadata
     about the add-on, including a specification of the entry points
     in the host application that trigger add-on executions (see:
@@ -335,6 +337,7 @@ class GSuiteAddOnsRestTransport(GSuiteAddOnsTransport):
     define their entrypoints using HTTPS URLs (See:
 
     https://developers.google.com/gsuite/add-ons/guides/alternate-runtimes),
+
     A Google Workspace Add-on deployment can be installed in
     developer mode, which allows an add-on developer to test the
     experience an end-user would see when installing and running the

diff --git a/tests/unit/gapic/gsuiteaddons_v1/test_g_suite_add_ons.py b/tests/unit/gapic/gsuiteaddons_v1/test_g_suite_add_ons.py
@@ -2136,9 +2136,11 @@ async def test_list_deployments_async_pages():
             RuntimeError,
         )
         pages = []
-        async for page_ in (
+        # Workaround issue in python 3.9 related to code coverage by adding `# pragma: no branch`
+        # See https://github.com/googleapis/gapic-generator-python/pull/1174#issuecomment-1025132372
+        async for page_ in (  # pragma: no branch
             await client.list_deployments(request={})
-        ).pages:  # pragma: no branch
+        ).pages:
             pages.append(page_)
         for page_, token in zip(pages, ["abc", "def", "ghi", ""]):
             assert page_.raw_page.next_page_token == token