docs: Add documentation for enums (#50)

* 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 · 2aaf9d1 · 2aaf9d1
1 parent f76feff
commit 2aaf9d1
Show file tree

Hide file tree

Showing 4 changed files with 36 additions and 4 deletions.
diff --git a/google/cloud/beyondcorp_appconnectors_v1/services/app_connectors_service/client.py b/google/cloud/beyondcorp_appconnectors_v1/services/app_connectors_service/client.py
@@ -1263,7 +1263,7 @@ def sample_report_status():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "AppConnectorsServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/google/cloud/beyondcorp_appconnectors_v1/types/app_connectors_service.py b/google/cloud/beyondcorp_appconnectors_v1/types/app_connectors_service.py
@@ -398,7 +398,25 @@ class AppConnector(proto.Message):
     """
 
     class State(proto.Enum):
-        r"""Represents the different states of a AppConnector."""
+        r"""Represents the different states of a AppConnector.
+
+        Values:
+            STATE_UNSPECIFIED (0):
+                Default value. This value is unused.
+            CREATING (1):
+                AppConnector is being created.
+            CREATED (2):
+                AppConnector has been created.
+            UPDATING (3):
+                AppConnector's configuration is being
+                updated.
+            DELETING (4):
+                AppConnector is being deleted.
+            DOWN (5):
+                AppConnector is down and may be restored in
+                the future. This happens when CCFE sends
+                ProjectState = OFF.
+        """
         STATE_UNSPECIFIED = 0
         CREATING = 1
         CREATED = 2

diff --git a/google/cloud/beyondcorp_appconnectors_v1/types/resource_info.py b/google/cloud/beyondcorp_appconnectors_v1/types/resource_info.py
@@ -29,7 +29,21 @@
 
 
 class HealthStatus(proto.Enum):
-    r"""HealthStatus represents the health status."""
+    r"""HealthStatus represents the health status.
+
+    Values:
+        HEALTH_STATUS_UNSPECIFIED (0):
+            Health status is unknown: not initialized or
+            failed to retrieve.
+        HEALTHY (1):
+            The resource is healthy.
+        UNHEALTHY (2):
+            The resource is unhealthy.
+        UNRESPONSIVE (3):
+            The resource is unresponsive.
+        DEGRADED (4):
+            Some sub-resources are UNHEALTHY.
+    """
     HEALTH_STATUS_UNSPECIFIED = 0
     HEALTHY = 1
     UNHEALTHY = 2

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