docs: Add documentation for enums (#177)

* 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 23, 2023 · 334a497 · 334a497
1 parent 38c56b6
commit 334a497
Show file tree

Hide file tree

Showing 3 changed files with 16 additions and 3 deletions.
diff --git a/google/cloud/privatecatalog_v1beta1/services/private_catalog/client.py b/google/cloud/privatecatalog_v1beta1/services/private_catalog/client.py
@@ -784,7 +784,7 @@ def sample_search_versions():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "PrivateCatalogClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/google/cloud/privatecatalog_v1beta1/types/private_catalog.py b/google/cloud/privatecatalog_v1beta1/types/private_catalog.py
@@ -583,7 +583,20 @@ class AssetReference(proto.Message):
     """
 
     class AssetValidationState(proto.Enum):
-        r"""Possible validation steates of an asset reference."""
+        r"""Possible validation steates of an asset reference.
+
+        Values:
+            ASSET_VALIDATION_STATE_UNSPECIFIED (0):
+                Unknown state.
+            PENDING (1):
+                The validation is still in process.
+            VALID (2):
+                The validation is done and the asset
+                reference is valid.
+            INVALID (3):
+                The validation is done and the asset
+                reference is invalid.
+        """
         ASSET_VALIDATION_STATE_UNSPECIFIED = 0
         PENDING = 1
         VALID = 2

diff --git a/samples/generated_samples/snippet_metadata_google.cloud.privatecatalog.v1beta1.json b/samples/generated_samples/snippet_metadata_google.cloud.privatecatalog.v1beta1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-private-catalog",
-    "version": "0.9.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {