docs: Add documentation for enums (#171)

* 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 · 9e48540 · 9e48540
1 parent 93fad3f
commit 9e48540
Show file tree

Hide file tree

Showing 4 changed files with 32 additions and 6 deletions.
diff --git a/...-cloud-apigee-connect/google/cloud/apigeeconnect_v1/services/connection_service/client.py b/...-cloud-apigee-connect/google/cloud/apigeeconnect_v1/services/connection_service/client.py
@@ -554,7 +554,7 @@ def sample_list_connections():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "ConnectionServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/packages/google-cloud-apigee-connect/google/cloud/apigeeconnect_v1/services/tether/client.py b/packages/google-cloud-apigee-connect/google/cloud/apigeeconnect_v1/services/tether/client.py
@@ -507,7 +507,7 @@ def request_generator():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "TetherClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/packages/google-cloud-apigee-connect/google/cloud/apigeeconnect_v1/types/tether.py b/packages/google-cloud-apigee-connect/google/cloud/apigeeconnect_v1/types/tether.py
@@ -38,21 +38,47 @@
 
 
 class Action(proto.Enum):
-    r"""The action taken by agent."""
+    r"""The action taken by agent.
+
+    Values:
+        ACTION_UNSPECIFIED (0):
+            Unspecified Action.
+        OPEN_NEW_STREAM (1):
+            Indicates that agent should open a new
+            stream.
+    """
     ACTION_UNSPECIFIED = 0
     OPEN_NEW_STREAM = 1
 
 
 class TetherEndpoint(proto.Enum):
-    r"""Endpoint indicates where the messages will be delivered."""
+    r"""Endpoint indicates where the messages will be delivered.
+
+    Values:
+        TETHER_ENDPOINT_UNSPECIFIED (0):
+            Unspecified tether endpoint.
+        APIGEE_MART (1):
+            Apigee MART endpoint.
+        APIGEE_RUNTIME (2):
+            Apigee Runtime endpoint.
+        APIGEE_MINT_RATING (3):
+            Apigee Mint Rating endpoint.
+    """
     TETHER_ENDPOINT_UNSPECIFIED = 0
     APIGEE_MART = 1
     APIGEE_RUNTIME = 2
     APIGEE_MINT_RATING = 3
 
 
 class Scheme(proto.Enum):
-    r"""HTTP Scheme."""
+    r"""HTTP Scheme.
+
+    Values:
+        SCHEME_UNSPECIFIED (0):
+            Unspecified scheme.
+        HTTPS (1):
+            HTTPS protocol.
+    """
     SCHEME_UNSPECIFIED = 0
     HTTPS = 1
 

diff --git a/...gee-connect/samples/generated_samples/snippet_metadata_google.cloud.apigeeconnect.v1.json b/...gee-connect/samples/generated_samples/snippet_metadata_google.cloud.apigeeconnect.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-apigee-connect",
-    "version": "1.7.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {