docs: Add documentation for enums (#48)

gcf-owl-bot[bot] · web-flow · commit 52b90c04d507 · 2023-01-20T10:56:57.000-05:00
* 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>
diff --git a/packages/google-cloud-beyondcorp-clientconnectorservices/google/cloud/beyondcorp_clientconnectorservices_v1/services/client_connector_services_service/client.py b/packages/google-cloud-beyondcorp-clientconnectorservices/google/cloud/beyondcorp_clientconnectorservices_v1/services/client_connector_services_service/client.py
@@ -1186,7 +1186,7 @@ def sample_delete_client_connector_service():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "ClientConnectorServicesServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):
diff --git a/packages/google-cloud-beyondcorp-clientconnectorservices/google/cloud/beyondcorp_clientconnectorservices_v1/types/client_connector_services_service.py b/packages/google-cloud-beyondcorp-clientconnectorservices/google/cloud/beyondcorp_clientconnectorservices_v1/types/client_connector_services_service.py
@@ -63,7 +63,27 @@ class ClientConnectorService(proto.Message):
     """
 
     class State(proto.Enum):
-        r"""Represents the different states of a ClientConnectorService."""
+        r"""Represents the different states of a ClientConnectorService.
+
+        Values:
+            STATE_UNSPECIFIED (0):
+                Default value. This value is unused.
+            CREATING (1):
+                ClientConnectorService is being created.
+            UPDATING (2):
+                ClientConnectorService is being updated.
+            DELETING (3):
+                ClientConnectorService is being deleted.
+            RUNNING (4):
+                ClientConnectorService is running.
+            DOWN (5):
+                ClientConnectorService is down and may be
+                restored in the future. This happens when CCFE
+                sends ProjectState = OFF.
+            ERROR (6):
+                ClientConnectorService encountered an error
+                and is in an indeterministic state.
+        """
         STATE_UNSPECIFIED = 0
         CREATING = 1
         UPDATING = 2
@@ -99,7 +119,14 @@ class Config(proto.Message):
             """
 
             class TransportProtocol(proto.Enum):
-                r"""The protocol used to connect to the server."""
+                r"""The protocol used to connect to the server.
+
+                Values:
+                    TRANSPORT_PROTOCOL_UNSPECIFIED (0):
+                        Default value. This value is unused.
+                    TCP (1):
+                        TCP protocol.
+                """
                 TRANSPORT_PROTOCOL_UNSPECIFIED = 0
                 TCP = 1
 
diff --git a/packages/google-cloud-beyondcorp-clientconnectorservices/samples/generated_samples/snippet_metadata_google.cloud.beyondcorp.clientconnectorservices.v1.json b/packages/google-cloud-beyondcorp-clientconnectorservices/samples/generated_samples/snippet_metadata_google.cloud.beyondcorp.clientconnectorservices.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-beyondcorp-clientconnectorservices",
-    "version": "0.4.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {

Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`],`
`9`	`9`	`"language": "PYTHON",`
`10`	`10`	`"name": "google-cloud-beyondcorp-clientconnectorservices",`
`11`		`- "version": "0.4.0"`
	`11`	`+ "version": "0.1.0"`
`12`	`12`	`},`
`13`	`13`	`"snippets": [`
`14`	`14`	`{`