docs: Add documentation for enums (#17)

* 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 · d5be45e · d5be45e
1 parent 608b4ab
commit d5be45e
Show file tree

Hide file tree

Showing 3 changed files with 34 additions and 4 deletions.
diff --git a/...oogle-cloud-edgecontainer/google/cloud/edgecontainer_v1/services/edge_container/client.py b/...oogle-cloud-edgecontainer/google/cloud/edgecontainer_v1/services/edge_container/client.py
@@ -2574,7 +2574,7 @@ def sample_delete_vpn_connection():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "EdgeContainerClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/packages/google-cloud-edgecontainer/google/cloud/edgecontainer_v1/types/resources.py b/packages/google-cloud-edgecontainer/google/cloud/edgecontainer_v1/types/resources.py
@@ -45,6 +45,16 @@
 class KmsKeyState(proto.Enum):
     r"""Represents the accessibility state of a customer-managed KMS
     key used for CMEK integration.
+
+    Values:
+        KMS_KEY_STATE_UNSPECIFIED (0):
+            Unspecified.
+        KMS_KEY_STATE_KEY_AVAILABLE (1):
+            The key is available for use, and dependent
+            resources should be accessible.
+        KMS_KEY_STATE_KEY_UNAVAILABLE (2):
+            The key is unavailable for an unspecified
+            reason. Dependent resources may be inaccessible.
     """
     KMS_KEY_STATE_UNSPECIFIED = 0
     KMS_KEY_STATE_KEY_AVAILABLE = 1
@@ -456,7 +466,16 @@ class VpnConnection(proto.Message):
     """
 
     class BgpRoutingMode(proto.Enum):
-        r"""Routing mode."""
+        r"""Routing mode.
+
+        Values:
+            BGP_ROUTING_MODE_UNSPECIFIED (0):
+                Unknown.
+            REGIONAL (1):
+                Regional mode.
+            GLOBAL (2):
+                Global mode.
+        """
         BGP_ROUTING_MODE_UNSPECIFIED = 0
         REGIONAL = 1
         GLOBAL = 2
@@ -505,7 +524,18 @@ class Details(proto.Message):
         """
 
         class State(proto.Enum):
-            r"""The current connection state."""
+            r"""The current connection state.
+
+            Values:
+                STATE_UNSPECIFIED (0):
+                    Unknown.
+                STATE_CONNECTED (1):
+                    Connected.
+                STATE_CONNECTING (2):
+                    Still connecting.
+                STATE_ERROR (3):
+                    Error occurred.
+            """
             STATE_UNSPECIFIED = 0
             STATE_CONNECTED = 1
             STATE_CONNECTING = 2

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