From c87b2bbc6e50bd433e86a6a1b5f7e2ff023ea16c Mon Sep 17 00:00:00 2001
From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com>
Date: Fri, 20 Jan 2023 10:44:46 -0500
Subject: [PATCH] docs: Add documentation for enums (#63)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 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: https://github.com/googleapis/googleapis/commit/a391fd1dac18dfdfa00c18c8404f2c3a6ff8e98e

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>
---
 .../services/provisioning/client.py           |  2 +-
 .../services/registry/client.py               |  2 +-
 .../types/provisioning_service.py             | 23 ++++++++++++++++++-
 ...tadata_google.cloud.apigeeregistry.v1.json |  2 +-
 4 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/services/provisioning/client.py b/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/services/provisioning/client.py
index c45844ab03ff..4156dbaba531 100644
--- a/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/services/provisioning/client.py
+++ b/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/services/provisioning/client.py
@@ -821,7 +821,7 @@ def sample_get_instance():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "ProvisioningClient":
         return self
 
     def __exit__(self, type, value, traceback):
diff --git a/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/services/registry/client.py b/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/services/registry/client.py
index 785e8019d2b1..5648570f06b6 100644
--- a/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/services/registry/client.py
+++ b/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/services/registry/client.py
@@ -4491,7 +4491,7 @@ def sample_delete_artifact():
             metadata=metadata,
         )
 
-    def __enter__(self):
+    def __enter__(self) -> "RegistryClient":
         return self
 
     def __exit__(self, type, value, traceback):
diff --git a/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/types/provisioning_service.py b/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/types/provisioning_service.py
index a49bea4ae99f..534074400388 100644
--- a/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/types/provisioning_service.py
+++ b/packages/google-cloud-apigee-registry/google/cloud/apigee_registry_v1/types/provisioning_service.py
@@ -172,7 +172,28 @@ class Instance(proto.Message):
     """
 
     class State(proto.Enum):
-        r"""State of the Instance."""
+        r"""State of the Instance.
+
+        Values:
+            STATE_UNSPECIFIED (0):
+                The default value. This value is used if the
+                state is omitted.
+            INACTIVE (1):
+                The Instance has not been initialized or has
+                been deleted.
+            CREATING (2):
+                The Instance is being created.
+            ACTIVE (3):
+                The Instance has been created and is ready
+                for use.
+            UPDATING (4):
+                The Instance is being updated.
+            DELETING (5):
+                The Instance is being deleted.
+            FAILED (6):
+                The Instance encountered an error during a
+                state change.
+        """
         STATE_UNSPECIFIED = 0
         INACTIVE = 1
         CREATING = 2
diff --git a/packages/google-cloud-apigee-registry/samples/generated_samples/snippet_metadata_google.cloud.apigeeregistry.v1.json b/packages/google-cloud-apigee-registry/samples/generated_samples/snippet_metadata_google.cloud.apigeeregistry.v1.json
index 3bb69be8793c..399743edd3de 100644
--- a/packages/google-cloud-apigee-registry/samples/generated_samples/snippet_metadata_google.cloud.apigeeregistry.v1.json
+++ b/packages/google-cloud-apigee-registry/samples/generated_samples/snippet_metadata_google.cloud.apigeeregistry.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-apigee-registry",
-    "version": "0.6.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {