From 29246d4f4dc201a3faab34b3cb16f8629289be82 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 16:04:44 -0500 Subject: [PATCH 1/2] docs: Add documentation for enums (#238) 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 --- .../services/cloud_memcache/client.py | 2 +- .../cloud/memcache_v1/types/cloud_memcache.py | 70 +++++++++++++++++-- .../services/cloud_memcache/client.py | 2 +- .../memcache_v1beta2/types/cloud_memcache.py | 70 +++++++++++++++++-- ...pet_metadata_google.cloud.memcache.v1.json | 2 +- ...etadata_google.cloud.memcache.v1beta2.json | 2 +- 6 files changed, 134 insertions(+), 14 deletions(-) diff --git a/google/cloud/memcache_v1/services/cloud_memcache/client.py b/google/cloud/memcache_v1/services/cloud_memcache/client.py index 7dd9eef..7c3bfe9 100644 --- a/google/cloud/memcache_v1/services/cloud_memcache/client.py +++ b/google/cloud/memcache_v1/services/cloud_memcache/client.py @@ -1529,7 +1529,7 @@ def sample_reschedule_maintenance(): # Done; return the response. return response - def __enter__(self): + def __enter__(self) -> "CloudMemcacheClient": return self def __exit__(self, type, value, traceback): diff --git a/google/cloud/memcache_v1/types/cloud_memcache.py b/google/cloud/memcache_v1/types/cloud_memcache.py index bc1947e..8c552e9 100644 --- a/google/cloud/memcache_v1/types/cloud_memcache.py +++ b/google/cloud/memcache_v1/types/cloud_memcache.py @@ -48,7 +48,14 @@ class MemcacheVersion(proto.Enum): - r"""Memcached versions supported by our service.""" + r"""Memcached versions supported by our service. + + Values: + MEMCACHE_VERSION_UNSPECIFIED (0): + + MEMCACHE_1_5 (1): + Memcached 1.5 version. + """ MEMCACHE_VERSION_UNSPECIFIED = 0 MEMCACHE_1_5 = 1 @@ -138,7 +145,25 @@ class Instance(proto.Message): """ class State(proto.Enum): - r"""Different states of a Memcached instance.""" + r"""Different states of a Memcached instance. + + Values: + STATE_UNSPECIFIED (0): + State not set. + CREATING (1): + Memcached instance is being created. + READY (2): + Memcached instance has been created and ready + to be used. + UPDATING (3): + Memcached instance is updating configuration + such as maintenance policy and schedule. + DELETING (4): + Memcached instance is being deleted. + PERFORMING_MAINTENANCE (5): + Memcached instance is going through + maintenance, e.g. data plane rollout. + """ STATE_UNSPECIFIED = 0 CREATING = 1 READY = 2 @@ -193,7 +218,20 @@ class Node(proto.Message): """ class State(proto.Enum): - r"""Different states of a Memcached node.""" + r"""Different states of a Memcached node. + + Values: + STATE_UNSPECIFIED (0): + Node state is not set. + CREATING (1): + Node is being created. + READY (2): + Node has been created and ready to be used. + DELETING (3): + Node is being deleted. + UPDATING (4): + Node is being updated. + """ STATE_UNSPECIFIED = 0 CREATING = 1 READY = 2 @@ -240,7 +278,14 @@ class InstanceMessage(proto.Message): """ class Code(proto.Enum): - r"""""" + r""" + + Values: + CODE_UNSPECIFIED (0): + Message Code not set. + ZONE_DISTRIBUTION_UNBALANCED (1): + Memcached nodes are distributed unevenly. + """ CODE_UNSPECIFIED = 0 ZONE_DISTRIBUTION_UNBALANCED = 1 @@ -465,7 +510,22 @@ class RescheduleMaintenanceRequest(proto.Message): """ class RescheduleType(proto.Enum): - r"""Reschedule options.""" + r"""Reschedule options. + + Values: + RESCHEDULE_TYPE_UNSPECIFIED (0): + Not set. + IMMEDIATE (1): + If the user wants to schedule the maintenance + to happen now. + NEXT_AVAILABLE_WINDOW (2): + If the user wants to use the existing + maintenance policy to find the next available + window. + SPECIFIC_TIME (3): + If the user wants to reschedule the + maintenance to a specific time. + """ RESCHEDULE_TYPE_UNSPECIFIED = 0 IMMEDIATE = 1 NEXT_AVAILABLE_WINDOW = 2 diff --git a/google/cloud/memcache_v1beta2/services/cloud_memcache/client.py b/google/cloud/memcache_v1beta2/services/cloud_memcache/client.py index 2ecc7ce..865ea44 100644 --- a/google/cloud/memcache_v1beta2/services/cloud_memcache/client.py +++ b/google/cloud/memcache_v1beta2/services/cloud_memcache/client.py @@ -1676,7 +1676,7 @@ def sample_reschedule_maintenance(): # Done; return the response. return response - def __enter__(self): + def __enter__(self) -> "CloudMemcacheClient": return self def __exit__(self, type, value, traceback): diff --git a/google/cloud/memcache_v1beta2/types/cloud_memcache.py b/google/cloud/memcache_v1beta2/types/cloud_memcache.py index 6cd3f19..2809a23 100644 --- a/google/cloud/memcache_v1beta2/types/cloud_memcache.py +++ b/google/cloud/memcache_v1beta2/types/cloud_memcache.py @@ -49,7 +49,14 @@ class MemcacheVersion(proto.Enum): - r"""Memcached versions supported by our service.""" + r"""Memcached versions supported by our service. + + Values: + MEMCACHE_VERSION_UNSPECIFIED (0): + + MEMCACHE_1_5 (1): + Memcached 1.5 version. + """ MEMCACHE_VERSION_UNSPECIFIED = 0 MEMCACHE_1_5 = 1 @@ -143,7 +150,25 @@ class Instance(proto.Message): """ class State(proto.Enum): - r"""Different states of a Memcached instance.""" + r"""Different states of a Memcached instance. + + Values: + STATE_UNSPECIFIED (0): + State not set. + CREATING (1): + Memcached instance is being created. + READY (2): + Memcached instance has been created and ready + to be used. + UPDATING (3): + Memcached instance is updating configuration + such as maintenance policy and schedule. + DELETING (4): + Memcached instance is being deleted. + PERFORMING_MAINTENANCE (5): + Memcached instance is going through + maintenance, e.g. data plane rollout. + """ STATE_UNSPECIFIED = 0 CREATING = 1 READY = 2 @@ -201,7 +226,20 @@ class Node(proto.Message): """ class State(proto.Enum): - r"""Different states of a Memcached node.""" + r"""Different states of a Memcached node. + + Values: + STATE_UNSPECIFIED (0): + Node state is not set. + CREATING (1): + Node is being created. + READY (2): + Node has been created and ready to be used. + DELETING (3): + Node is being deleted. + UPDATING (4): + Node is being updated. + """ STATE_UNSPECIFIED = 0 CREATING = 1 READY = 2 @@ -252,7 +290,14 @@ class InstanceMessage(proto.Message): """ class Code(proto.Enum): - r"""""" + r""" + + Values: + CODE_UNSPECIFIED (0): + Message Code not set. + ZONE_DISTRIBUTION_UNBALANCED (1): + Memcached nodes are distributed unevenly. + """ CODE_UNSPECIFIED = 0 ZONE_DISTRIBUTION_UNBALANCED = 1 @@ -673,7 +718,22 @@ class RescheduleMaintenanceRequest(proto.Message): """ class RescheduleType(proto.Enum): - r"""Reschedule options.""" + r"""Reschedule options. + + Values: + RESCHEDULE_TYPE_UNSPECIFIED (0): + Not set. + IMMEDIATE (1): + If the user wants to schedule the maintenance + to happen now. + NEXT_AVAILABLE_WINDOW (2): + If the user wants to use the existing + maintenance policy to find the next available + window. + SPECIFIC_TIME (3): + If the user wants to reschedule the + maintenance to a specific time. + """ RESCHEDULE_TYPE_UNSPECIFIED = 0 IMMEDIATE = 1 NEXT_AVAILABLE_WINDOW = 2 diff --git a/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1.json b/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1.json index 136b2f8..4fbe6f0 100644 --- a/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1.json +++ b/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-memcache", - "version": "1.6.0" + "version": "0.1.0" }, "snippets": [ { diff --git a/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1beta2.json b/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1beta2.json index 95573dd..a19a59a 100644 --- a/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1beta2.json +++ b/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1beta2.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-memcache", - "version": "1.6.0" + "version": "0.1.0" }, "snippets": [ { From 45f7d75841e7640f2b3378131b09c07b4f861adf Mon Sep 17 00:00:00 2001 From: "release-please[bot]" <55107282+release-please[bot]@users.noreply.github.com> Date: Mon, 23 Jan 2023 10:38:07 -0500 Subject: [PATCH 2/2] chore(main): release 1.6.1 (#239) Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> --- .release-please-manifest.json | 2 +- CHANGELOG.md | 12 ++++++++++++ google/cloud/memcache/gapic_version.py | 2 +- google/cloud/memcache_v1/gapic_version.py | 2 +- google/cloud/memcache_v1beta2/gapic_version.py | 2 +- .../snippet_metadata_google.cloud.memcache.v1.json | 2 +- ...ippet_metadata_google.cloud.memcache.v1beta2.json | 2 +- 7 files changed, 18 insertions(+), 6 deletions(-) diff --git a/.release-please-manifest.json b/.release-please-manifest.json index 0d1bebe..093be7e 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "1.6.0" + ".": "1.6.1" } diff --git a/CHANGELOG.md b/CHANGELOG.md index 72d69fb..e5d22cd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,17 @@ # Changelog +## [1.6.1](https://github.com/googleapis/python-memcache/compare/v1.6.0...v1.6.1) (2023-01-20) + + +### Bug Fixes + +* Add context manager return types ([29246d4](https://github.com/googleapis/python-memcache/commit/29246d4f4dc201a3faab34b3cb16f8629289be82)) + + +### Documentation + +* Add documentation for enums ([29246d4](https://github.com/googleapis/python-memcache/commit/29246d4f4dc201a3faab34b3cb16f8629289be82)) + ## [1.6.0](https://github.com/googleapis/python-memcache/compare/v1.5.0...v1.6.0) (2023-01-10) diff --git a/google/cloud/memcache/gapic_version.py b/google/cloud/memcache/gapic_version.py index a016bdf..b4028ab 100644 --- a/google/cloud/memcache/gapic_version.py +++ b/google/cloud/memcache/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "1.6.0" # {x-release-please-version} +__version__ = "1.6.1" # {x-release-please-version} diff --git a/google/cloud/memcache_v1/gapic_version.py b/google/cloud/memcache_v1/gapic_version.py index a016bdf..b4028ab 100644 --- a/google/cloud/memcache_v1/gapic_version.py +++ b/google/cloud/memcache_v1/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "1.6.0" # {x-release-please-version} +__version__ = "1.6.1" # {x-release-please-version} diff --git a/google/cloud/memcache_v1beta2/gapic_version.py b/google/cloud/memcache_v1beta2/gapic_version.py index a016bdf..b4028ab 100644 --- a/google/cloud/memcache_v1beta2/gapic_version.py +++ b/google/cloud/memcache_v1beta2/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "1.6.0" # {x-release-please-version} +__version__ = "1.6.1" # {x-release-please-version} diff --git a/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1.json b/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1.json index 4fbe6f0..ee47435 100644 --- a/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1.json +++ b/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-memcache", - "version": "0.1.0" + "version": "1.6.1" }, "snippets": [ { diff --git a/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1beta2.json b/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1beta2.json index a19a59a..56253ca 100644 --- a/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1beta2.json +++ b/samples/generated_samples/snippet_metadata_google.cloud.memcache.v1beta2.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-memcache", - "version": "0.1.0" + "version": "1.6.1" }, "snippets": [ {