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.
- {google_cloud_memorystore-0.5.4/google_cloud_memorystore.egg-info → google_cloud_memorystore-0.5.5}/PKG-INFO +3 -2
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore/gapic_version.py +1 -1
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/__init__.py +3 -87
- google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1/_compat.py +262 -0
- {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
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/client.py +23 -157
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/rest.py +280 -328
- google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1/services/memorystore/transports/rest_base.py +588 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/__init__.py +3 -87
- google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1beta/_compat.py +262 -0
- {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
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/client.py +23 -157
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/rest.py +280 -328
- google_cloud_memorystore-0.5.5/google/cloud/memorystore_v1beta/services/memorystore/transports/rest_base.py +588 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5/google_cloud_memorystore.egg-info}/PKG-INFO +3 -2
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/SOURCES.txt +4 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/requires.txt +1 -1
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/setup.py +2 -1
- google_cloud_memorystore-0.5.5/tests/unit/gapic/memorystore_v1/test_compat.py +429 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/gapic/memorystore_v1/test_memorystore.py +233 -825
- google_cloud_memorystore-0.5.5/tests/unit/gapic/memorystore_v1beta/test_compat.py +429 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/gapic/memorystore_v1beta/test_memorystore.py +233 -825
- google_cloud_memorystore-0.5.4/google/cloud/memorystore_v1/services/memorystore/transports/rest_base.py +0 -1512
- google_cloud_memorystore-0.5.4/google/cloud/memorystore_v1beta/services/memorystore/transports/rest_base.py +0 -1512
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/LICENSE +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/MANIFEST.in +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/README.rst +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore/py.typed +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/gapic_metadata.json +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/py.typed +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/async_client.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/pagers.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/base.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/grpc.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/services/memorystore/transports/grpc_asyncio.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/types/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1/types/memorystore.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/gapic_metadata.json +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/py.typed +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/async_client.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/pagers.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/base.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/grpc.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/services/memorystore/transports/grpc_asyncio.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/types/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google/cloud/memorystore_v1beta/types/memorystore.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/dependency_links.txt +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/not-zip-safe +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/google_cloud_memorystore.egg-info/top_level.txt +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/setup.cfg +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/gapic/__init__.py +0 -0
- {google_cloud_memorystore-0.5.4 → google_cloud_memorystore-0.5.5}/tests/unit/gapic/memorystore_v1/__init__.py +0 -0
- {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.
|
|
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
|
+
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,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
|
|
@@ -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 =
|
|
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 =
|
|
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
|
-
|
|
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 =
|
|
935
|
-
universe_domain_opt,
|
|
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
|
|
971
|
-
self._client_options.api_endpoint,
|
|
972
|
-
self.
|
|
973
|
-
|
|
974
|
-
|
|
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:
|