docs: Add documentation for enums (#145)

* 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/debugger_v2/services/controller2/client.py

@@ -783,7 +783,7 @@ def sample_update_active_breakpoint():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "Controller2Client":
         return self
 
     def __exit__(self, type, value, traceback):

google/cloud/debugger_v2/services/debugger2/client.py

@@ -1017,7 +1017,7 @@ def sample_list_debuggees():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "Debugger2Client":
         return self
 
     def __exit__(self, type, value, traceback):

google/cloud/debugger_v2/types/data.py

@@ -82,7 +82,29 @@ class StatusMessage(proto.Message):
     """
 
     class Reference(proto.Enum):
-        r"""Enumerates references to which the message applies."""
+        r"""Enumerates references to which the message applies.
+
+        Values:
+            UNSPECIFIED (0):
+                Status doesn't refer to any particular input.
+            BREAKPOINT_SOURCE_LOCATION (3):
+                Status applies to the breakpoint and is
+                related to its location.
+            BREAKPOINT_CONDITION (4):
+                Status applies to the breakpoint and is
+                related to its condition.
+            BREAKPOINT_EXPRESSION (7):
+                Status applies to the breakpoint and is
+                related to its expressions.
+            BREAKPOINT_AGE (8):
+                Status applies to the breakpoint and is
+                related to its age.
+            VARIABLE_NAME (5):
+                Status applies to the entire variable.
+            VARIABLE_VALUE (6):
+                Status applies to variable value (variable
+                name is valid).
+        """
         UNSPECIFIED = 0
         BREAKPOINT_SOURCE_LOCATION = 3
         BREAKPOINT_CONDITION = 4
@@ -439,12 +461,31 @@ class Action(proto.Enum):
         r"""Actions that can be taken when a breakpoint hits.
         Agents should reject breakpoints with unsupported or unknown
         action values.
+
+        Values:
+            CAPTURE (0):
+                Capture stack frame and variables and update
+                the breakpoint. The data is only captured once.
+                After that the breakpoint is set in a final
+                state.
+            LOG (1):
+                Log each breakpoint hit. The breakpoint
+                remains active until deleted or expired.
         """
         CAPTURE = 0
         LOG = 1
 
     class LogLevel(proto.Enum):
-        r"""Log severity levels."""
+        r"""Log severity levels.
+
+        Values:
+            INFO (0):
+                Information log message.
+            WARNING (1):
+                Warning log message.
+            ERROR (2):
+                Error log message.
+        """
         INFO = 0
         WARNING = 1
         ERROR = 2

samples/generated_samples/snippet_metadata_google.devtools.clouddebugger.v2.json

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-debugger-client",
-    "version": "1.6.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {