docs: Add documentation for enums (#17)

* 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/edgecontainer_v1/services/edge_container/client.py

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

google/cloud/edgecontainer_v1/types/resources.py

@@ -45,6 +45,16 @@
 class KmsKeyState(proto.Enum):
  r"""Represents the accessibility state of a customer-managed KMS
  key used for CMEK integration.
+
+ Values:
+ KMS_KEY_STATE_UNSPECIFIED (0):
+ Unspecified.
+ KMS_KEY_STATE_KEY_AVAILABLE (1):
+ The key is available for use, and dependent
+ resources should be accessible.
+ KMS_KEY_STATE_KEY_UNAVAILABLE (2):
+ The key is unavailable for an unspecified
+ reason. Dependent resources may be inaccessible.
  """
  KMS_KEY_STATE_UNSPECIFIED = 0
  KMS_KEY_STATE_KEY_AVAILABLE = 1
@@ -456,7 +466,16 @@ class VpnConnection(proto.Message):
  """
 
  class BgpRoutingMode(proto.Enum):
- r"""Routing mode."""
+ r"""Routing mode.
+
+ Values:
+ BGP_ROUTING_MODE_UNSPECIFIED (0):
+ Unknown.
+ REGIONAL (1):
+ Regional mode.
+ GLOBAL (2):
+ Global mode.
+ """
  BGP_ROUTING_MODE_UNSPECIFIED = 0
  REGIONAL = 1
  GLOBAL = 2
@@ -505,7 +524,18 @@ class Details(proto.Message):
  """
 
  class State(proto.Enum):
- r"""The current connection state."""
+ r"""The current connection state.
+
+ Values:
+ STATE_UNSPECIFIED (0):
+ Unknown.
+ STATE_CONNECTED (1):
+ Connected.
+ STATE_CONNECTING (2):
+ Still connecting.
+ STATE_ERROR (3):
+ Error occurred.
+ """
  STATE_UNSPECIFIED = 0
  STATE_CONNECTED = 1
  STATE_CONNECTING = 2

samples/generated_samples/snippet_metadata_google.cloud.edgecontainer.v1.json

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