google-cloud-memorystore 0.5.4__tar.gz → 0.5.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. {google_cloud_memorystore-0.5.4/google_cloud_memorystore.egg-info → google_cloud_memorystore-0.5.5}/PKG-INFO +3 -2
  2. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore/gapic_version.py +1 -1
  3. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/__init__.py +3 -87
  4. google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1/_compat.py +262 -0
  5. {google_cloud_memorystore-0.5.4/google/cloud/memorystore_v1beta → google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1}/gapic_version.py +1 -1
  6. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/client.py +23 -157
  7. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/rest.py +280 -328
  8. google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1/services/memorystore/transports/rest_base.py +588 -0
  9. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/__init__.py +3 -87
  10. google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1beta/_compat.py +262 -0
  11. {google_cloud_memorystore-0.5.4/google/cloud/memorystore_v1 → google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1beta}/gapic_version.py +1 -1
  12. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/client.py +23 -157
  13. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/rest.py +280 -328
  14. google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1beta/services/memorystore/transports/rest_base.py +588 -0
  15. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5/google_cloud_memorystore.egg-info}/PKG-INFO +3 -2
  16. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/SOURCES.txt +4 -0
  17. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/requires.txt +1 -1
  18. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/setup.py +2 -1
  19. google_cloud_memorystore-0.5.5/tests/unit/gapic/memorystore_v1/test_compat.py +429 -0
  20. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/gapic/memorystore_v1/test_memorystore.py +233 -825
  21. google_cloud_memorystore-0.5.5/tests/unit/gapic/memorystore_v1beta/test_compat.py +429 -0
  22. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/gapic/memorystore_v1beta/test_memorystore.py +233 -825
  23. google_cloud_memorystore-0.5.4/google/cloud/memorystore_v1/services/memorystore/transports/rest_base.py +0 -1512
  24. google_cloud_memorystore-0.5.4/google/cloud/memorystore_v1beta/services/memorystore/transports/rest_base.py +0 -1512
  25. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/LICENSE +0 -0
  26. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/MANIFEST.in +0 -0
  27. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/README.rst +0 -0
  28. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore/__init__.py +0 -0
  29. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore/py.typed +0 -0
  30. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/gapic_metadata.json +0 -0
  31. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/py.typed +0 -0
  32. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/__init__.py +0 -0
  33. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/__init__.py +0 -0
  34. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/async_client.py +0 -0
  35. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/pagers.py +0 -0
  36. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/__init__.py +0 -0
  37. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/base.py +0 -0
  38. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/grpc.py +0 -0
  39. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/grpc_asyncio.py +0 -0
  40. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/types/__init__.py +0 -0
  41. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/types/memorystore.py +0 -0
  42. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/gapic_metadata.json +0 -0
  43. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/py.typed +0 -0
  44. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/__init__.py +0 -0
  45. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/__init__.py +0 -0
  46. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/async_client.py +0 -0
  47. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/pagers.py +0 -0
  48. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/__init__.py +0 -0
  49. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/base.py +0 -0
  50. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/grpc.py +0 -0
  51. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/grpc_asyncio.py +0 -0
  52. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/types/__init__.py +0 -0
  53. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/types/memorystore.py +0 -0
  54. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/dependency_links.txt +0 -0
  55. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/not-zip-safe +0 -0
  56. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/top_level.txt +0 -0
  57. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/setup.cfg +0 -0
  58. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/__init__.py +0 -0
  59. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/__init__.py +0 -0
  60. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/gapic/__init__.py +0 -0
  61. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/gapic/memorystore_v1/__init__.py +0 -0
  62. {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/gapic/memorystore_v1beta/__init__.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: google-cloud-memorystore
3
- Version: 0.5.4
3
+ Version: 0.5.5
4
4
  Summary: Google Cloud Memorystore API client library
5
5
  Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-memorystore
6
6
  Author: Google LLC
@@ -17,11 +17,12 @@ Classifier: Programming Language :: Python :: 3.11
17
17
  Classifier: Programming Language :: Python :: 3.12
18
18
  Classifier: Programming Language :: Python :: 3.13
19
19
  Classifier: Programming Language :: Python :: 3.14
20
+ Classifier: Programming Language :: Python :: 3.15
20
21
  Classifier: Operating System :: OS Independent
21
22
  Classifier: Topic :: Internet
22
23
  Requires-Python: >=3.10
23
24
  License-File: LICENSE
24
- Requires-Dist: google-api-core[grpc]<3.0.0,>=2.25.0
25
+ Requires-Dist: google-api-core[grpc]<3.0.0,>=2.28.0
25
26
  Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
26
27
  Requires-Dist: grpcio<2.0.0,>=1.59.0
27
28
  Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
@@ -13,4 +13,4 @@
13
13
  # See the License for the specific language governing permissions and
14
14
  # limitations under the License.
15
15
  #
16
- __version__ = "0.5.4" # {x-release-please-version}
16
+ __version__ = "0.5.5" # {x-release-please-version}
@@ -13,16 +13,12 @@
13
13
  # See the License for the specific language governing permissions and
14
14
  # limitations under the License.
15
15
  #
16
- import sys
17
-
18
16
  import google.api_core as api_core
19
17
 
20
18
  from google.cloud.memorystore_v1 import gapic_version as package_version
21
19
 
22
20
  __version__ = package_version.__version__
23
21
 
24
- from importlib import metadata
25
-
26
22
  # PEP 0810: Explicit Lazy Imports
27
23
  # Python 3.15+ natively intercepts and defers these imports.
28
24
  # Developers can disable this behavior and force eager imports.
@@ -95,89 +91,6 @@ from .types.memorystore import (
95
91
  ZoneDistributionConfig,
96
92
  )
97
93
 
98
- if hasattr(api_core, "check_python_version") and hasattr(
99
- api_core, "check_dependency_versions"
100
- ): # pragma: NO COVER
101
- api_core.check_python_version("google.cloud.memorystore_v1") # type: ignore
102
- api_core.check_dependency_versions("google.cloud.memorystore_v1") # type: ignore
103
- else: # pragma: NO COVER
104
- # An older version of api_core is installed which does not define the
105
- # functions above. We do equivalent checks manually.
106
- try:
107
- import warnings
108
-
109
- _py_version_str = sys.version.split()[0]
110
- _package_label = "google.cloud.memorystore_v1"
111
- if sys.version_info < (3, 10):
112
- warnings.warn(
113
- "You are using a non-supported Python version "
114
- + f"({_py_version_str}). Google will not post any further "
115
- + f"updates to {_package_label} supporting this Python version. "
116
- + "Please upgrade to the latest Python version, or at "
117
- + f"least to Python 3.10, and then update {_package_label}.",
118
- FutureWarning,
119
- )
120
-
121
- def parse_version_to_tuple(version_string: str):
122
- """Safely converts a semantic version string to a comparable tuple of integers.
123
- Example: "6.33.5" -> (6, 33, 5)
124
- Ignores non-numeric parts and handles common version formats.
125
- Args:
126
- version_string: Version string in the format "x.y.z" or "x.y.z<suffix>"
127
- Returns:
128
- Tuple of integers for the parsed version string.
129
- """
130
- parts = []
131
- for part in version_string.split("."):
132
- try:
133
- parts.append(int(part))
134
- except ValueError:
135
- # If it's a non-numeric part (e.g., '1.0.0b1' -> 'b1'), stop here.
136
- # This is a simplification compared to 'packaging.parse_version', but sufficient
137
- # for comparing strictly numeric semantic versions.
138
- break
139
- return tuple(parts)
140
-
141
- def _get_version(dependency_name):
142
- try:
143
- version_string: str = metadata.version(dependency_name)
144
- parsed_version = parse_version_to_tuple(version_string)
145
- return (parsed_version, version_string)
146
- except Exception:
147
- # Catch exceptions from metadata.version() (e.g., PackageNotFoundError)
148
- # or errors during parse_version_to_tuple
149
- return (None, "--")
150
-
151
- _dependency_package = "google.protobuf"
152
- _next_supported_version = "6.33.5"
153
- _next_supported_version_tuple = (6, 33, 5)
154
- _recommendation = " (we recommend 7.x)"
155
- (_version_used, _version_used_string) = _get_version(_dependency_package)
156
- if _version_used and _version_used < _next_supported_version_tuple:
157
- warnings.warn(
158
- f"Package {_package_label} depends on "
159
- + f"{_dependency_package}, currently installed at version "
160
- + f"{_version_used_string}. Future updates to "
161
- + f"{_package_label} will require {_dependency_package} at "
162
- + f"version {_next_supported_version} or higher{_recommendation}."
163
- + " Please ensure "
164
- + "that either (a) your Python environment doesn't pin the "
165
- + f"version of {_dependency_package}, so that updates to "
166
- + f"{_package_label} can require the higher version, or "
167
- + "(b) you manually update your Python environment to use at "
168
- + f"least version {_next_supported_version} of "
169
- + f"{_dependency_package}.",
170
- FutureWarning,
171
- )
172
- except Exception:
173
- warnings.warn(
174
- "Could not determine the version of Python "
175
- + "currently being used. To continue receiving "
176
- + "updates for {_package_label}, ensure you are "
177
- + "using a supported version of Python; see "
178
- + "https://devguide.python.org/versions/"
179
- )
180
-
181
94
  __all__ = (
182
95
  "MemorystoreAsyncClient",
183
96
  "AddAuthTokenRequest",
@@ -238,3 +151,6 @@ __all__ = (
238
151
  "WeeklyMaintenanceWindow",
239
152
  "ZoneDistributionConfig",
240
153
  )
154
+
155
+ api_core.check_python_version("google.cloud.memorystore_v1")
156
+ api_core.check_dependency_versions("google.cloud.memorystore_v1")
@@ -0,0 +1,262 @@
1
+ # -*- coding: utf-8 -*-
2
+ # Copyright 2026 Google LLC
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+ #
16
+ """A compatibility module for older versions of google-api-core."""
17
+
18
+ import json
19
+ import os
20
+ from typing import Any, Dict, List, Optional, Tuple
21
+ from urllib.parse import urlparse, urlunparse
22
+
23
+ from google.api_core import path_template
24
+ from google.api_core.universe import EmptyUniverseError
25
+ from google.auth.exceptions import MutualTLSChannelError
26
+ from google.protobuf import json_format
27
+
28
+ try:
29
+ # note: `#type: ignore` is added because the return type for `should_use_client_cert`
30
+ # is different than that of the fallback implementation below. This will be removed once
31
+ # we bump the minimum supported version of google-auth.
32
+ from google.auth.transport.mtls import should_use_client_cert # type: ignore
33
+ except ImportError: # pragma: NO COVER
34
+
35
+ def should_use_client_cert():
36
+ """Returns whether client certificate should be used for mTLS."""
37
+ use_client_cert = os.getenv(
38
+ "GOOGLE_API_USE_CLIENT_CERTIFICATE", "false"
39
+ ).lower()
40
+ if use_client_cert not in ("true", "false"):
41
+ raise ValueError(
42
+ "Environment variable `GOOGLE_API_USE_CLIENT_CERTIFICATE` must be"
43
+ " either `true` or `false`"
44
+ )
45
+ return use_client_cert == "true"
46
+
47
+
48
+ def read_environment_variables():
49
+ """Returns the environment variables used by the client.
50
+
51
+ Returns:
52
+ Tuple[bool, str, str]: returns the GOOGLE_API_USE_CLIENT_CERTIFICATE,
53
+ GOOGLE_API_USE_MTLS_ENDPOINT, and GOOGLE_CLOUD_UNIVERSE_DOMAIN environment variables.
54
+
55
+ Raises:
56
+ ValueError: If GOOGLE_API_USE_CLIENT_CERTIFICATE is not
57
+ any of ["true", "false"].
58
+ google.auth.exceptions.MutualTLSChannelError: If GOOGLE_API_USE_MTLS_ENDPOINT
59
+ is not any of ["auto", "never", "always"].
60
+ """
61
+ use_client_cert = should_use_client_cert()
62
+ use_mtls_endpoint = os.getenv("GOOGLE_API_USE_MTLS_ENDPOINT", "auto").lower()
63
+ universe_domain_env = os.getenv("GOOGLE_CLOUD_UNIVERSE_DOMAIN")
64
+ if use_mtls_endpoint not in ("auto", "never", "always"):
65
+ raise MutualTLSChannelError(
66
+ "Environment variable `GOOGLE_API_USE_MTLS_ENDPOINT` must be `never`,"
67
+ " `auto` or `always`"
68
+ )
69
+ return use_client_cert, use_mtls_endpoint, universe_domain_env
70
+
71
+
72
+ DEFAULT_UNIVERSE = "googleapis.com"
73
+
74
+ try:
75
+ from google.api_core.universe import get_default_mtls_endpoint
76
+ except ImportError: # pragma: NO COVER
77
+
78
+ def get_default_mtls_endpoint(api_endpoint: Optional[str]) -> Optional[str]:
79
+ """Converts api endpoint to mTLS endpoint.
80
+
81
+ Convert "*.sandbox.googleapis.com" and "*.googleapis.com" to
82
+ "*.mtls.sandbox.googleapis.com" and "*.mtls.googleapis.com" respectively.
83
+ Other URLs (including those that do not match these domain suffixes or
84
+ already contain '.mtls.') are passed through as-is.
85
+
86
+ Args:
87
+ api_endpoint (Optional[str]): the api endpoint to convert.
88
+
89
+ Returns:
90
+ Optional[str]: converted mTLS api endpoint.
91
+ """
92
+ if not api_endpoint or ".mtls." in api_endpoint.lower():
93
+ return api_endpoint
94
+
95
+ has_scheme = "://" in api_endpoint
96
+ if not has_scheme:
97
+ parsed = urlparse("//" + api_endpoint)
98
+ else:
99
+ parsed = urlparse(api_endpoint)
100
+
101
+ host = parsed.hostname
102
+ if not host:
103
+ return api_endpoint
104
+
105
+ port = f":{parsed.port}" if parsed.port else ""
106
+
107
+ lowered_host = host.lower()
108
+ suffix_sandbox = ".sandbox.googleapis.com"
109
+ suffix_google = ".googleapis.com"
110
+ if lowered_host.endswith(suffix_sandbox):
111
+ new_host = host[: -len(suffix_sandbox)] + ".mtls.sandbox.googleapis.com"
112
+ elif lowered_host.endswith(suffix_google):
113
+ new_host = host[: -len(suffix_google)] + ".mtls.googleapis.com"
114
+ else:
115
+ return api_endpoint
116
+
117
+ netloc = new_host + port
118
+ new_parsed = parsed._replace(netloc=netloc)
119
+
120
+ if not has_scheme:
121
+ return urlunparse(new_parsed)[2:]
122
+ else:
123
+ return urlunparse(new_parsed)
124
+
125
+
126
+ try:
127
+ from google.api_core.universe import get_api_endpoint
128
+ except ImportError: # pragma: NO COVER
129
+
130
+ def get_api_endpoint(
131
+ api_override: Optional[str],
132
+ universe_domain: str,
133
+ default_universe: str,
134
+ default_mtls_endpoint: Optional[str],
135
+ default_endpoint_template: str,
136
+ use_mtls: bool,
137
+ ) -> str:
138
+ """Return the API endpoint used by the client.
139
+
140
+ Args:
141
+ api_override (Optional[str]): The API endpoint override. If specified,
142
+ this is always returned.
143
+ universe_domain (str): The universe domain used by the client.
144
+ default_universe (str): The default universe domain.
145
+ default_mtls_endpoint (Optional[str]): The default mTLS endpoint.
146
+ default_endpoint_template (str): The default endpoint template containing
147
+ a placeholder `{UNIVERSE_DOMAIN}`.
148
+ use_mtls (bool): Whether to use the mTLS endpoint.
149
+
150
+ Returns:
151
+ str: The API endpoint to be used by the client.
152
+
153
+ Raises:
154
+ google.auth.exceptions.MutualTLSChannelError: If mTLS is requested but
155
+ not supported in the configured universe domain.
156
+ ValueError: If mTLS is requested but no mTLS endpoint is available.
157
+ """
158
+ if api_override is not None:
159
+ return api_override
160
+
161
+ if use_mtls:
162
+ if universe_domain.lower() != default_universe.lower():
163
+ raise MutualTLSChannelError(
164
+ f"mTLS is not supported in any universe other than {default_universe}."
165
+ )
166
+ if not default_mtls_endpoint:
167
+ raise ValueError("mTLS endpoint is not available.")
168
+ return default_mtls_endpoint
169
+ else:
170
+ return default_endpoint_template.format(UNIVERSE_DOMAIN=universe_domain)
171
+
172
+
173
+ try:
174
+ from google.api_core.universe import get_universe_domain
175
+ except ImportError: # pragma: NO COVER
176
+
177
+ def get_universe_domain(
178
+ *potential_universes: Optional[str],
179
+ default_universe: str,
180
+ ) -> str:
181
+ """Return the universe domain used by the client.
182
+
183
+ Args:
184
+ *potential_universes (Optional[str]): Potential universe domains in order of preference.
185
+ default_universe (str): The default universe domain.
186
+
187
+ Returns:
188
+ str: The universe domain to be used by the client.
189
+
190
+ Raises:
191
+ EmptyUniverseError: If the resolved universe domain is an empty string.
192
+ """
193
+ resolved = next(
194
+ (x.strip() for x in potential_universes if x is not None),
195
+ default_universe,
196
+ )
197
+
198
+ if not resolved:
199
+ raise EmptyUniverseError()
200
+ return resolved
201
+
202
+
203
+ try:
204
+ from google.api_core.rest_helpers import transcode_request # type: ignore
205
+ except ImportError: # pragma: NO COVER
206
+
207
+ def transcode_request(
208
+ http_options: List[Dict[str, str]],
209
+ request: Any,
210
+ required_fields_default_values: Optional[Dict[str, Any]] = None,
211
+ rest_numeric_enums: bool = False,
212
+ ) -> Tuple[Dict[str, Any], Optional[str], Dict[str, Any]]:
213
+ """Transcodes a request into HTTP method, URI, body, and query parameters.
214
+
215
+ Args:
216
+ http_options (List[Dict[str, str]]): List of HTTP transcoding rules.
217
+ request (Any): The protobuf or proto-plus request message.
218
+ required_fields_default_values (Optional[Dict[str, Any]]): Dictionary
219
+ of required fields default values to merge into query parameters if missing.
220
+ rest_numeric_enums (bool): Whether to encode enums as integers.
221
+
222
+ Returns:
223
+ Tuple[Dict[str, Any], Optional[str], Dict[str, Any]]: A tuple containing:
224
+ - The raw transcoded request dictionary (containing keys like 'uri', 'method').
225
+ - The serialized request body JSON string, or None if no body.
226
+ - The query parameters dictionary.
227
+ """
228
+ if request is None:
229
+ raise TypeError("request cannot be None")
230
+
231
+ # Convert proto-plus message to its underlying protobuf message if needed
232
+ pb_request = getattr(request, "_pb", request)
233
+
234
+ transcoded_request = path_template.transcode(http_options, pb_request)
235
+
236
+ body_json = None
237
+ if transcoded_request.get("body") is not None:
238
+ body_json = json_format.MessageToJson(
239
+ transcoded_request["body"],
240
+ use_integers_for_enums=rest_numeric_enums,
241
+ )
242
+
243
+ query_params_json = {}
244
+ if transcoded_request.get("query_params") is not None:
245
+ query_params_json = json.loads(
246
+ json_format.MessageToJson(
247
+ transcoded_request["query_params"],
248
+ use_integers_for_enums=rest_numeric_enums,
249
+ )
250
+ )
251
+
252
+ # If required_fields_default_values is provided, we merge default values for missing
253
+ # required fields into the query parameters.
254
+ if required_fields_default_values:
255
+ for k, v in required_fields_default_values.items():
256
+ if k not in query_params_json:
257
+ query_params_json[k] = v
258
+
259
+ if rest_numeric_enums:
260
+ query_params_json["$alt"] = "json;enum-encoding=int"
261
+
262
+ return transcoded_request, body_json, query_params_json
@@ -13,4 +13,4 @@
13
13
  # See the License for the specific language governing permissions and
14
14
  # limitations under the License.
15
15
  #
16
- __version__ = "0.5.4" # {x-release-please-version}
16
+ __version__ = "0.5.5" # {x-release-please-version}
@@ -46,6 +46,13 @@ from google.auth.transport.grpc import SslCredentials # type: ignore
46
46
  from google.oauth2 import service_account # type: ignore
47
47
 
48
48
  from google.cloud.memorystore_v1 import gapic_version as package_version
49
+ from google.cloud.memorystore_v1._compat import (
50
+ get_api_endpoint,
51
+ get_default_mtls_endpoint,
52
+ get_universe_domain,
53
+ read_environment_variables,
54
+ should_use_client_cert,
55
+ )
49
56
 
50
57
  try:
51
58
  OptionalRetry = Union[retries.Retry, gapic_v1.method._MethodDefault, None]
@@ -116,77 +123,13 @@ class MemorystoreClientMeta(type):
116
123
  class MemorystoreClient(metaclass=MemorystoreClientMeta):
117
124
  """Service describing handlers for resources"""
118
125
 
119
- @staticmethod
120
- def _get_default_mtls_endpoint(api_endpoint) -> Optional[str]:
121
- """Converts api endpoint to mTLS endpoint.
122
-
123
- Convert "*.sandbox.googleapis.com" and "*.googleapis.com" to
124
- "*.mtls.sandbox.googleapis.com" and "*.mtls.googleapis.com" respectively.
125
- Args:
126
- api_endpoint (Optional[str]): the api endpoint to convert.
127
- Returns:
128
- Optional[str]: converted mTLS api endpoint.
129
- """
130
- if not api_endpoint:
131
- return api_endpoint
132
-
133
- mtls_endpoint_re = re.compile(
134
- r"(?P<name>[^.]+)(?P<mtls>\.mtls)?(?P<sandbox>\.sandbox)?(?P<googledomain>\.googleapis\.com)?"
135
- )
136
-
137
- m = mtls_endpoint_re.match(api_endpoint)
138
- if m is None:
139
- # Could not parse api_endpoint; return as-is.
140
- return api_endpoint
141
-
142
- name, mtls, sandbox, googledomain = m.groups()
143
- if mtls or not googledomain:
144
- return api_endpoint
145
-
146
- if sandbox:
147
- return api_endpoint.replace(
148
- "sandbox.googleapis.com", "mtls.sandbox.googleapis.com"
149
- )
150
-
151
- return api_endpoint.replace(".googleapis.com", ".mtls.googleapis.com")
152
-
153
126
  # Note: DEFAULT_ENDPOINT is deprecated. Use _DEFAULT_ENDPOINT_TEMPLATE instead.
154
127
  DEFAULT_ENDPOINT = "memorystore.googleapis.com"
155
- DEFAULT_MTLS_ENDPOINT = _get_default_mtls_endpoint.__func__( # type: ignore
156
- DEFAULT_ENDPOINT
157
- )
128
+ DEFAULT_MTLS_ENDPOINT = get_default_mtls_endpoint(DEFAULT_ENDPOINT)
158
129
 
159
130
  _DEFAULT_ENDPOINT_TEMPLATE = "memorystore.{UNIVERSE_DOMAIN}"
160
131
  _DEFAULT_UNIVERSE = "googleapis.com"
161
132
 
162
- @staticmethod
163
- def _use_client_cert_effective():
164
- """Returns whether client certificate should be used for mTLS if the
165
- google-auth version supports should_use_client_cert automatic mTLS enablement.
166
-
167
- Alternatively, read from the GOOGLE_API_USE_CLIENT_CERTIFICATE env var.
168
-
169
- Returns:
170
- bool: whether client certificate should be used for mTLS
171
- Raises:
172
- ValueError: (If using a version of google-auth without should_use_client_cert and
173
- GOOGLE_API_USE_CLIENT_CERTIFICATE is set to an unexpected value.)
174
- """
175
- # check if google-auth version supports should_use_client_cert for automatic mTLS enablement
176
- if hasattr(mtls, "should_use_client_cert"): # pragma: NO COVER
177
- return mtls.should_use_client_cert()
178
- else: # pragma: NO COVER
179
- # if unsupported, fallback to reading from env var
180
- use_client_cert_str = os.getenv(
181
- "GOOGLE_API_USE_CLIENT_CERTIFICATE", "false"
182
- ).lower()
183
- if use_client_cert_str not in ("true", "false"):
184
- raise ValueError(
185
- "Environment variable `GOOGLE_API_USE_CLIENT_CERTIFICATE` must be"
186
- " either `true` or `false`"
187
- )
188
- return use_client_cert_str == "true"
189
-
190
133
  @classmethod
191
134
  def from_service_account_info(cls, info: dict, *args, **kwargs):
192
135
  """Creates an instance of this client using the provided credentials
@@ -669,7 +612,7 @@ class MemorystoreClient(metaclass=MemorystoreClientMeta):
669
612
  )
670
613
  if client_options is None:
671
614
  client_options = client_options_lib.ClientOptions()
672
- use_client_cert = MemorystoreClient._use_client_cert_effective()
615
+ use_client_cert = should_use_client_cert()
673
616
  use_mtls_endpoint = os.getenv("GOOGLE_API_USE_MTLS_ENDPOINT", "auto")
674
617
  if use_mtls_endpoint not in ("auto", "never", "always"):
675
618
  raise MutualTLSChannelError(
@@ -690,35 +633,12 @@ class MemorystoreClient(metaclass=MemorystoreClientMeta):
690
633
  elif use_mtls_endpoint == "always" or (
691
634
  use_mtls_endpoint == "auto" and client_cert_source
692
635
  ):
693
- api_endpoint = cls.DEFAULT_MTLS_ENDPOINT
636
+ api_endpoint = cls.DEFAULT_MTLS_ENDPOINT # type: ignore
694
637
  else:
695
638
  api_endpoint = cls.DEFAULT_ENDPOINT
696
639
 
697
640
  return api_endpoint, client_cert_source
698
641
 
699
- @staticmethod
700
- def _read_environment_variables():
701
- """Returns the environment variables used by the client.
702
-
703
- Returns:
704
- Tuple[bool, str, str]: returns the GOOGLE_API_USE_CLIENT_CERTIFICATE,
705
- GOOGLE_API_USE_MTLS_ENDPOINT, and GOOGLE_CLOUD_UNIVERSE_DOMAIN environment variables.
706
-
707
- Raises:
708
- ValueError: If GOOGLE_API_USE_CLIENT_CERTIFICATE is not
709
- any of ["true", "false"].
710
- google.auth.exceptions.MutualTLSChannelError: If GOOGLE_API_USE_MTLS_ENDPOINT
711
- is not any of ["auto", "never", "always"].
712
- """
713
- use_client_cert = MemorystoreClient._use_client_cert_effective()
714
- use_mtls_endpoint = os.getenv("GOOGLE_API_USE_MTLS_ENDPOINT", "auto").lower()
715
- universe_domain_env = os.getenv("GOOGLE_CLOUD_UNIVERSE_DOMAIN")
716
- if use_mtls_endpoint not in ("auto", "never", "always"):
717
- raise MutualTLSChannelError(
718
- "Environment variable `GOOGLE_API_USE_MTLS_ENDPOINT` must be `never`, `auto` or `always`"
719
- )
720
- return use_client_cert, use_mtls_endpoint, universe_domain_env
721
-
722
642
  @staticmethod
723
643
  def _get_client_cert_source(provided_cert_source, use_cert_flag):
724
644
  """Return the client cert source to be used by the client.
@@ -738,65 +658,6 @@ class MemorystoreClient(metaclass=MemorystoreClientMeta):
738
658
  client_cert_source = mtls.default_client_cert_source()
739
659
  return client_cert_source
740
660
 
741
- @staticmethod
742
- def _get_api_endpoint(
743
- api_override, client_cert_source, universe_domain, use_mtls_endpoint
744
- ) -> str:
745
- """Return the API endpoint used by the client.
746
-
747
- Args:
748
- api_override (str): The API endpoint override. If specified, this is always
749
- the return value of this function and the other arguments are not used.
750
- client_cert_source (bytes): The client certificate source used by the client.
751
- universe_domain (str): The universe domain used by the client.
752
- use_mtls_endpoint (str): How to use the mTLS endpoint, which depends also on the other parameters.
753
- Possible values are "always", "auto", or "never".
754
-
755
- Returns:
756
- str: The API endpoint to be used by the client.
757
- """
758
- if api_override is not None:
759
- api_endpoint = api_override
760
- elif use_mtls_endpoint == "always" or (
761
- use_mtls_endpoint == "auto" and client_cert_source
762
- ):
763
- _default_universe = MemorystoreClient._DEFAULT_UNIVERSE
764
- if universe_domain != _default_universe:
765
- raise MutualTLSChannelError(
766
- f"mTLS is not supported in any universe other than {_default_universe}."
767
- )
768
- api_endpoint = MemorystoreClient.DEFAULT_MTLS_ENDPOINT
769
- else:
770
- api_endpoint = MemorystoreClient._DEFAULT_ENDPOINT_TEMPLATE.format(
771
- UNIVERSE_DOMAIN=universe_domain
772
- )
773
- return api_endpoint
774
-
775
- @staticmethod
776
- def _get_universe_domain(
777
- client_universe_domain: Optional[str], universe_domain_env: Optional[str]
778
- ) -> str:
779
- """Return the universe domain used by the client.
780
-
781
- Args:
782
- client_universe_domain (Optional[str]): The universe domain configured via the client options.
783
- universe_domain_env (Optional[str]): The universe domain configured via the "GOOGLE_CLOUD_UNIVERSE_DOMAIN" environment variable.
784
-
785
- Returns:
786
- str: The universe domain to be used by the client.
787
-
788
- Raises:
789
- ValueError: If the universe domain is an empty string.
790
- """
791
- universe_domain = MemorystoreClient._DEFAULT_UNIVERSE
792
- if client_universe_domain is not None:
793
- universe_domain = client_universe_domain
794
- elif universe_domain_env is not None:
795
- universe_domain = universe_domain_env
796
- if len(universe_domain.strip()) == 0:
797
- raise ValueError("Universe Domain cannot be an empty string.")
798
- return universe_domain
799
-
800
661
  def _validate_universe_domain(self):
801
662
  """Validates client's and credentials' universe domains are consistent.
802
663
 
@@ -926,13 +787,15 @@ class MemorystoreClient(metaclass=MemorystoreClientMeta):
926
787
  universe_domain_opt = getattr(self._client_options, "universe_domain", None)
927
788
 
928
789
  self._use_client_cert, self._use_mtls_endpoint, self._universe_domain_env = (
929
- MemorystoreClient._read_environment_variables()
790
+ read_environment_variables()
930
791
  )
931
792
  self._client_cert_source = MemorystoreClient._get_client_cert_source(
932
793
  self._client_options.client_cert_source, self._use_client_cert
933
794
  )
934
- self._universe_domain = MemorystoreClient._get_universe_domain(
935
- universe_domain_opt, self._universe_domain_env
795
+ self._universe_domain = get_universe_domain(
796
+ universe_domain_opt,
797
+ self._universe_domain_env,
798
+ default_universe=MemorystoreClient._DEFAULT_UNIVERSE,
936
799
  )
937
800
  self._api_endpoint: str = "" # updated below, depending on `transport`
938
801
 
@@ -967,11 +830,14 @@ class MemorystoreClient(metaclass=MemorystoreClientMeta):
967
830
  self._transport = cast(MemorystoreTransport, transport)
968
831
  self._api_endpoint = self._transport.host
969
832
 
970
- self._api_endpoint = self._api_endpoint or MemorystoreClient._get_api_endpoint(
971
- self._client_options.api_endpoint,
972
- self._client_cert_source,
973
- self._universe_domain,
974
- self._use_mtls_endpoint,
833
+ self._api_endpoint = self._api_endpoint or get_api_endpoint(
834
+ api_override=self._client_options.api_endpoint,
835
+ universe_domain=self._universe_domain,
836
+ default_universe=MemorystoreClient._DEFAULT_UNIVERSE,
837
+ default_mtls_endpoint=MemorystoreClient.DEFAULT_MTLS_ENDPOINT,
838
+ default_endpoint_template=MemorystoreClient._DEFAULT_ENDPOINT_TEMPLATE,
839
+ use_mtls=self._use_mtls_endpoint == "always"
840
+ or (self._use_mtls_endpoint == "auto" and self._client_cert_source),
975
841
  )
976
842
 
977
843
  if not transport_provided: