docs: Add documentation for enums (#216)

* 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/artifactregistry_v1/services/artifact_registry/client.py

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

google/cloud/artifactregistry_v1/types/apt_artifact.py

@@ -58,7 +58,16 @@ class AptArtifact(proto.Message):
  """
 
  class PackageType(proto.Enum):
- r"""Package type is either binary or source."""
+ r"""Package type is either binary or source.
+
+ Values:
+ PACKAGE_TYPE_UNSPECIFIED (0):
+ Package type is not specified.
+ BINARY (1):
+ Binary package.
+ SOURCE (2):
+ Source package.
+ """
  PACKAGE_TYPE_UNSPECIFIED = 0
  BINARY = 1
  SOURCE = 2

google/cloud/artifactregistry_v1/types/file.py

@@ -41,7 +41,16 @@ class Hash(proto.Message):
  """
 
  class HashType(proto.Enum):
- r"""The algorithm used to compute the hash."""
+ r"""The algorithm used to compute the hash.
+
+ Values:
+ HASH_TYPE_UNSPECIFIED (0):
+ Unspecified.
+ SHA256 (1):
+ SHA256 hash.
+ MD5 (2):
+ MD5 hash.
+ """
  HASH_TYPE_UNSPECIFIED = 0
  SHA256 = 1
  MD5 = 2

google/cloud/artifactregistry_v1/types/repository.py

@@ -77,7 +77,24 @@ class Repository(proto.Message):
  """
 
  class Format(proto.Enum):
- r"""A package format."""
+ r"""A package format.
+
+ Values:
+ FORMAT_UNSPECIFIED (0):
+ Unspecified package format.
+ DOCKER (1):
+ Docker package format.
+ MAVEN (2):
+ Maven package format.
+ NPM (3):
+ NPM package format.
+ APT (5):
+ APT package format.
+ YUM (6):
+ YUM package format.
+ PYTHON (8):
+ Python package format.
+ """
  FORMAT_UNSPECIFIED = 0
  DOCKER = 1
  MAVEN = 2
@@ -101,7 +118,20 @@ class MavenRepositoryConfig(proto.Message):
  """
 
  class VersionPolicy(proto.Enum):
- r"""VersionPolicy is the version policy for the repository."""
+ r"""VersionPolicy is the version policy for the repository.
+
+ Values:
+ VERSION_POLICY_UNSPECIFIED (0):
+ VERSION_POLICY_UNSPECIFIED - the version policy is not
+ defined. When the version policy is not defined, no
+ validation is performed for the versions.
+ RELEASE (1):
+ RELEASE - repository will accept only Release
+ versions.
+ SNAPSHOT (2):
+ SNAPSHOT - repository will accept only
+ Snapshot versions.
+ """
  VERSION_POLICY_UNSPECIFIED = 0
  RELEASE = 1
  SNAPSHOT = 2

google/cloud/artifactregistry_v1/types/settings.py

@@ -45,7 +45,19 @@ class ProjectSettings(proto.Message):
  """
 
  class RedirectionState(proto.Enum):
- r"""The possible redirection states for legacy repositories."""
+ r"""The possible redirection states for legacy repositories.
+
+ Values:
+ REDIRECTION_STATE_UNSPECIFIED (0):
+ No redirection status has been set.
+ REDIRECTION_FROM_GCR_IO_DISABLED (1):
+ Redirection is disabled.
+ REDIRECTION_FROM_GCR_IO_ENABLED (2):
+ Redirection is enabled.
+ REDIRECTION_FROM_GCR_IO_FINALIZED (3):
+ Redirection is enabled, and has been
+ finalized so cannot be reverted.
+ """
  REDIRECTION_STATE_UNSPECIFIED = 0
  REDIRECTION_FROM_GCR_IO_DISABLED = 1
  REDIRECTION_FROM_GCR_IO_ENABLED = 2

google/cloud/artifactregistry_v1/types/version.py

@@ -37,6 +37,16 @@
 class VersionView(proto.Enum):
  r"""The view, which determines what version information is
  returned in a response.
+
+ Values:
+ VERSION_VIEW_UNSPECIFIED (0):
+ The default / unset value.
+ The API will default to the BASIC view.
+ BASIC (1):
+ Includes basic information about the version,
+ but not any related tags.
+ FULL (2):
+ Include everything.
  """
  VERSION_VIEW_UNSPECIFIED = 0
  BASIC = 1

google/cloud/artifactregistry_v1/types/yum_artifact.py

@@ -50,7 +50,16 @@ class YumArtifact(proto.Message):
  """
 
  class PackageType(proto.Enum):
- r"""Package type is either binary or source."""
+ r"""Package type is either binary or source.
+
+ Values:
+ PACKAGE_TYPE_UNSPECIFIED (0):
+ Package type is not specified.
+ BINARY (1):
+ Binary package (.rpm).
+ SOURCE (2):
+ Source package (.srpm).
+ """
  PACKAGE_TYPE_UNSPECIFIED = 0
  BINARY = 1
  SOURCE = 2

google/cloud/artifactregistry_v1beta2/services/artifact_registry/client.py

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

google/cloud/artifactregistry_v1beta2/types/apt_artifact.py

@@ -58,7 +58,16 @@ class AptArtifact(proto.Message):
  """
 
  class PackageType(proto.Enum):
- r"""Package type is either binary or source."""
+ r"""Package type is either binary or source.
+
+ Values:
+ PACKAGE_TYPE_UNSPECIFIED (0):
+ Package type is not specified.
+ BINARY (1):
+ Binary package.
+ SOURCE (2):
+ Source package.
+ """
  PACKAGE_TYPE_UNSPECIFIED = 0
  BINARY = 1
  SOURCE = 2

google/cloud/artifactregistry_v1beta2/types/file.py

@@ -41,7 +41,16 @@ class Hash(proto.Message):
  """
 
  class HashType(proto.Enum):
- r"""The algorithm used to compute the hash."""
+ r"""The algorithm used to compute the hash.
+
+ Values:
+ HASH_TYPE_UNSPECIFIED (0):
+ Unspecified.
+ SHA256 (1):
+ SHA256 hash.
+ MD5 (2):
+ MD5 hash.
+ """
  HASH_TYPE_UNSPECIFIED = 0
  SHA256 = 1
  MD5 = 2