docs: Add documentation for enums (#390)

* 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 * 🦉 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/secretmanager_v1/services/secret_manager_service/client.py

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

google/cloud/secretmanager_v1/types/resources.py

@@ -238,6 +238,27 @@ class State(proto.Enum):
  r"""The state of a
  [SecretVersion][google.cloud.secretmanager.v1.SecretVersion],
  indicating if it can be accessed.
+
+ Values:
+ STATE_UNSPECIFIED (0):
+ Not specified. This value is unused and
+ invalid.
+ ENABLED (1):
+ The
+ [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]
+ may be accessed.
+ DISABLED (2):
+ The
+ [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]
+ may not be accessed, but the secret data is still available
+ and can be placed back into the
+ [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED]
+ state.
+ DESTROYED (3):
+ The
+ [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]
+ is destroyed and the secret data is no longer stored. A
+ version may not leave this state once entered.
  """
  STATE_UNSPECIFIED = 0
  ENABLED = 1

google/cloud/secretmanager_v1beta1/services/secret_manager_service/client.py

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

google/cloud/secretmanager_v1beta1/types/resources.py

@@ -121,6 +121,27 @@ class State(proto.Enum):
  r"""The state of a
  [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion],
  indicating if it can be accessed.
+
+ Values:
+ STATE_UNSPECIFIED (0):
+ Not specified. This value is unused and
+ invalid.
+ ENABLED (1):
+ The
+ [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]
+ may be accessed.
+ DISABLED (2):
+ The
+ [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]
+ may not be accessed, but the secret data is still available
+ and can be placed back into the
+ [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED]
+ state.
+ DESTROYED (3):
+ The
+ [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]
+ is destroyed and the secret data is no longer stored. A
+ version may not leave this state once entered.
  """
  STATE_UNSPECIFIED = 0
  ENABLED = 1

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

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