From 9f415dc09232c0b454a1e13da2e972ab1fe471d0 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 13:39:26 -0500
Subject: [PATCH] docs: Add documentation for enums (#188)
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>
---
 .../eventarc_v1/services/eventarc/client.py   |  2 +-
 .../google/cloud/eventarc_v1/types/channel.py | 30 ++++++++++++++++++-
 ...pet_metadata_google.cloud.eventarc.v1.json |  2 +-
 3 files changed, 31 insertions(+), 3 deletions(-)

diff --git a/packages/google-cloud-eventarc/google/cloud/eventarc_v1/services/eventarc/client.py b/packages/google-cloud-eventarc/google/cloud/eventarc_v1/services/eventarc/client.py
index d2915af15325..3a3169fa4a55 100644
--- a/packages/google-cloud-eventarc/google/cloud/eventarc_v1/services/eventarc/client.py
+++ b/packages/google-cloud-eventarc/google/cloud/eventarc_v1/services/eventarc/client.py
@@ -2844,7 +2844,7 @@ def sample_update_google_channel_config():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "EventarcClient":
         return self
 
     def __exit__(self, type, value, traceback):
diff --git a/packages/google-cloud-eventarc/google/cloud/eventarc_v1/types/channel.py b/packages/google-cloud-eventarc/google/cloud/eventarc_v1/types/channel.py
index 164a5173c82b..cf62903da26a 100644
--- a/packages/google-cloud-eventarc/google/cloud/eventarc_v1/types/channel.py
+++ b/packages/google-cloud-eventarc/google/cloud/eventarc_v1/types/channel.py
@@ -77,7 +77,35 @@ class Channel(proto.Message):
     """
 
     class State(proto.Enum):
-        r"""State lists all the possible states of a Channel"""
+        r"""State lists all the possible states of a Channel
+
+        Values:
+            STATE_UNSPECIFIED (0):
+                Default value. This value is unused.
+            PENDING (1):
+                The PENDING state indicates that a Channel
+                has been created successfully and there is a new
+                activation token available for the subscriber to
+                use to convey the Channel to the provider in
+                order to create a Connection.
+            ACTIVE (2):
+                The ACTIVE state indicates that a Channel has
+                been successfully connected with the event
+                provider. An ACTIVE Channel is ready to receive
+                and route events from the event provider.
+            INACTIVE (3):
+                The INACTIVE state indicates that the Channel
+                cannot receive events permanently. There are two
+                possible cases this state can happen:
+                1. The SaaS provider disconnected from this
+                Channel. 2. The Channel activation token has
+                expired but the SaaS provider    wasn't
+                connected.
+
+                To re-establish a Connection with a provider,
+                the subscriber should create a new Channel and
+                give it to the provider.
+        """
         STATE_UNSPECIFIED = 0
         PENDING = 1
         ACTIVE = 2
diff --git a/packages/google-cloud-eventarc/samples/generated_samples/snippet_metadata_google.cloud.eventarc.v1.json b/packages/google-cloud-eventarc/samples/generated_samples/snippet_metadata_google.cloud.eventarc.v1.json
index e26de00505af..596aaecb1b9c 100644
--- a/packages/google-cloud-eventarc/samples/generated_samples/snippet_metadata_google.cloud.eventarc.v1.json
+++ b/packages/google-cloud-eventarc/samples/generated_samples/snippet_metadata_google.cloud.eventarc.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-eventarc",
-    "version": "1.8.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {