docs: Add documentation for enums (#99)

* 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 · c3ca4ca · c3ca4ca
1 parent c62732f
commit c3ca4ca
Show file tree

Hide file tree

Showing 3 changed files with 30 additions and 4 deletions.
diff --git a/packages/google-cloud-ids/google/cloud/ids_v1/services/ids/client.py b/packages/google-cloud-ids/google/cloud/ids_v1/services/ids/client.py
@@ -924,7 +924,7 @@ def sample_delete_endpoint():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "IDSClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/packages/google-cloud-ids/google/cloud/ids_v1/types/ids.py b/packages/google-cloud-ids/google/cloud/ids_v1/types/ids.py
@@ -67,7 +67,22 @@ class Endpoint(proto.Message):
     """
 
     class Severity(proto.Enum):
-        r"""Threat severity levels."""
+        r"""Threat severity levels.
+
+        Values:
+            SEVERITY_UNSPECIFIED (0):
+                Not set.
+            INFORMATIONAL (1):
+                Informational alerts.
+            LOW (2):
+                Low severity alerts.
+            MEDIUM (3):
+                Medium severity alerts.
+            HIGH (4):
+                High severity alerts.
+            CRITICAL (5):
+                Critical severity alerts.
+        """
         SEVERITY_UNSPECIFIED = 0
         INFORMATIONAL = 1
         LOW = 2
@@ -76,7 +91,18 @@ class Severity(proto.Enum):
         CRITICAL = 5
 
     class State(proto.Enum):
-        r"""Endpoint state"""
+        r"""Endpoint state
+
+        Values:
+            STATE_UNSPECIFIED (0):
+                Not set.
+            CREATING (1):
+                Being created.
+            READY (2):
+                Active and ready for traffic.
+            DELETING (3):
+                Being deleted.
+        """
         STATE_UNSPECIFIED = 0
         CREATING = 1
         READY = 2

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