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": [
     {