docs: Add documentation for enums (#45)

* docs: Add documentation for enums fix: Add context manager return types chore: Update gapic-generator-python to v1.8.1 PiperOrigin-RevId: 503210727 Source-Link: googleapis/googleapis@a391fd1 Source-Link: googleapis/googleapis-gen@0080f83 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMDA4MGY4MzBkZWMzN2MzMzg0MTU3MDgyYmNlMjc5ZTM3MDc5ZWE1OCJ9 * 🦉 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 · Jan 20, 2023 · fe84916 · fe84916
1 parent 4e4c4f2
commit fe84916
Show file tree

Hide file tree

Showing 3 changed files with 34 additions and 3 deletions.
diff --git a/...ppgateways/google/cloud/beyondcorp_appgateways_v1/services/app_gateways_service/client.py b/...ppgateways/google/cloud/beyondcorp_appgateways_v1/services/app_gateways_service/client.py
@@ -975,7 +975,7 @@ def sample_delete_app_gateway():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "AppGatewaysServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/...yondcorp-appgateways/google/cloud/beyondcorp_appgateways_v1/types/app_gateways_service.py b/...yondcorp-appgateways/google/cloud/beyondcorp_appgateways_v1/types/app_gateways_service.py
@@ -287,12 +287,36 @@ class AppGateway(proto.Message):
     class Type(proto.Enum):
         r"""Enum containing list of all possible network connectivity
         options supported by BeyondCorp AppGateway.
+
+        Values:
+            TYPE_UNSPECIFIED (0):
+                Default value. This value is unused.
+            TCP_PROXY (1):
+                TCP Proxy based BeyondCorp Connection. API
+                will default to this if unset.
         """
         TYPE_UNSPECIFIED = 0
         TCP_PROXY = 1
 
     class State(proto.Enum):
-        r"""Represents the different states of an AppGateway."""
+        r"""Represents the different states of an AppGateway.
+
+        Values:
+            STATE_UNSPECIFIED (0):
+                Default value. This value is unused.
+            CREATING (1):
+                AppGateway is being created.
+            CREATED (2):
+                AppGateway has been created.
+            UPDATING (3):
+                AppGateway's configuration is being updated.
+            DELETING (4):
+                AppGateway is being deleted.
+            DOWN (5):
+                AppGateway is down and may be restored in the
+                future. This happens when CCFE sends
+                ProjectState = OFF.
+        """
         STATE_UNSPECIFIED = 0
         CREATING = 1
         CREATED = 2
@@ -303,6 +327,13 @@ class State(proto.Enum):
     class HostType(proto.Enum):
         r"""Enum containing list of all possible host types supported by
         BeyondCorp Connection.
+
+        Values:
+            HOST_TYPE_UNSPECIFIED (0):
+                Default value. This value is unused.
+            GCP_REGIONAL_MIG (1):
+                AppGateway hosted in a GCP regional managed
+                instance group.
         """
         HOST_TYPE_UNSPECIFIED = 0
         GCP_REGIONAL_MIG = 1

diff --git a/...ys/samples/generated_samples/snippet_metadata_google.cloud.beyondcorp.appgateways.v1.json b/...ys/samples/generated_samples/snippet_metadata_google.cloud.beyondcorp.appgateways.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-beyondcorp-appgateways",
-    "version": "0.4.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {