docs: Add documentation for enums (#198)

* 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

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

google/cloud/managedidentities_v1/services/managed_identities_service/client.py

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

google/cloud/managedidentities_v1/types/resource.py

@@ -81,7 +81,28 @@ class Domain(proto.Message):
     """
 
     class State(proto.Enum):
-        r"""Represents the different states of a managed domain."""
+        r"""Represents the different states of a managed domain.
+
+        Values:
+            STATE_UNSPECIFIED (0):
+                Not set.
+            CREATING (1):
+                The domain is being created.
+            READY (2):
+                The domain has been created and is fully
+                usable.
+            UPDATING (3):
+                The domain's configuration is being updated.
+            DELETING (4):
+                The domain is being deleted.
+            REPAIRING (5):
+                The domain is being repaired and may be unusable. Details
+                can be found in the ``status_message`` field.
+            PERFORMING_MAINTENANCE (6):
+                The domain is undergoing maintenance.
+            UNAVAILABLE (7):
+                The domain is not serving requests.
+        """
         STATE_UNSPECIFIED = 0
         CREATING = 1
         READY = 2
@@ -192,7 +213,22 @@ class Trust(proto.Message):
     """
 
     class State(proto.Enum):
-        r"""Represents the different states of a domain trust."""
+        r"""Represents the different states of a domain trust.
+
+        Values:
+            STATE_UNSPECIFIED (0):
+                Not set.
+            CREATING (1):
+                The domain trust is being created.
+            UPDATING (2):
+                The domain trust is being updated.
+            DELETING (3):
+                The domain trust is being deleted.
+            CONNECTED (4):
+                The domain trust is connected.
+            DISCONNECTED (5):
+                The domain trust is disconnected.
+        """
         STATE_UNSPECIFIED = 0
         CREATING = 1
         UPDATING = 2
@@ -201,7 +237,16 @@ class State(proto.Enum):
         DISCONNECTED = 5
 
     class TrustType(proto.Enum):
-        r"""Represents the different inter-forest trust types."""
+        r"""Represents the different inter-forest trust types.
+
+        Values:
+            TRUST_TYPE_UNSPECIFIED (0):
+                Not set.
+            FOREST (1):
+                The forest trust.
+            EXTERNAL (2):
+                The external domain trust.
+        """
         TRUST_TYPE_UNSPECIFIED = 0
         FOREST = 1
         EXTERNAL = 2
@@ -210,6 +255,19 @@ class TrustDirection(proto.Enum):
         r"""Represents the direction of trust. See
         `System.DirectoryServices.ActiveDirectory.TrustDirection <https://docs.microsoft.com/en-us/dotnet/api/system.directoryservices.activedirectory.trustdirection?view=netframework-4.7.2>`__
         for more information.
+
+        Values:
+            TRUST_DIRECTION_UNSPECIFIED (0):
+                Not set.
+            INBOUND (1):
+                The inbound direction represents the trusting
+                side.
+            OUTBOUND (2):
+                The outboud direction represents the trusted
+                side.
+            BIDIRECTIONAL (3):
+                The bidirectional direction represents the
+                trusted / trusting side.
         """
         TRUST_DIRECTION_UNSPECIFIED = 0
         INBOUND = 1

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

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-managed-identities",
-    "version": "1.7.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {