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: https://github.com/googleapis/googleapis-gen/commit/0080f830dec37c3384157082bce279e37079ea58 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>

Author: gcf-owl-bot[bot]

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):

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

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": [
  {