google-api-core 2.31.0__tar.gz → 2.32.0__tar.gz

{google_api_core-2.31.0/google_api_core.egg-info → google_api_core-2.32.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-api-core
-Version: 2.31.0
+Version: 2.32.0
 Summary: Google API client core library
 Author-email: Google LLC <googleapis-packages@google.com>
 License: Apache 2.0

{google_api_core-2.31.0 → google_api_core-2.32.0}/google/api_core/exceptions.py

@@ -18,12 +18,11 @@ This module provides base classes for all errors raised by libraries based
 on :mod:`google.api_core`, including both HTTP and gRPC clients.
 """
 
-from __future__ import absolute_import
-from __future__ import unicode_literals
+from __future__ import absolute_import, unicode_literals
 
 import http.client
-from typing import Optional, Dict
 import warnings
+from typing import Dict, Optional
 
 from google.rpc import error_details_pb2
 
@@ -657,9 +656,20 @@ def from_grpc_error(rpc_exc):
         grpc is not None and isinstance(rpc_exc, grpc.Call)
     ) or _is_informative_grpc_error(rpc_exc):
         details, err_info = _parse_grpc_error_details(rpc_exc)
+        message = rpc_exc.details()
+        if (
+            grpc is not None
+            and rpc_exc.code() == grpc.StatusCode.UNIMPLEMENTED
+            and "Received http2 header with status: 404" in message
+        ):
+            message = (
+                f"{message}. This usually indicates that the 'api_endpoint' "
+                "configuration in ClientOptions is incorrect, contains a typo, "
+                "or is an invalid regional endpoint for this service."
+            )
         return from_grpc_status(
             rpc_exc.code(),
-            rpc_exc.details(),
+            message,
             errors=(rpc_exc,),
             details=details,
             response=rpc_exc,

google_api_core-2.32.0/google/api_core/gapic_v1/__init__.py

@@ -0,0 +1,55 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import importlib.util
+from typing import Set
+
+_has_grpc = importlib.util.find_spec("grpc") is not None
+
+# PEP 0810: Explicit Lazy Imports
+# Python 3.15+ natively intercepts and defers these imports.
+# Developers can disable this behavior and force eager imports.
+# For more information, see:
+# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter
+# Older Python versions safely ignore this variable.
+__lazy_modules__: Set[str] = {
+    "google.api_core.gapic_v1.client_info",
+    "google.api_core.gapic_v1.routing_header",
+}
+__all__ = ["client_info", "routing_header"]
+
+if _has_grpc:
+    __lazy_modules__.update(
+        {
+            "google.api_core.gapic_v1.config",
+            "google.api_core.gapic_v1.config_async",
+            "google.api_core.gapic_v1.method",
+            "google.api_core.gapic_v1.method_async",
+        }
+    )
+
+from google.api_core.gapic_v1 import (  # noqa: E402
+    client_info,
+    routing_header,
+)
+
+if _has_grpc:
+    from google.api_core.gapic_v1 import (  # noqa: F401
+        config,
+        config_async,
+        method,
+        method_async,
+    )
+
+    __all__.extend(["config", "config_async", "method", "method_async"])

google_api_core-2.32.0/google/api_core/operations_v1/__init__.py

@@ -0,0 +1,81 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Package for interacting with the google.longrunning.operations meta-API."""
+
+import importlib.util
+from typing import Set
+
+try:
+    _has_async_rest = (
+        importlib.util.find_spec("google.auth.aio.transport.sessions") is not None
+    )
+except ModuleNotFoundError:
+    _has_async_rest = False
+
+# PEP 0810: Explicit Lazy Imports
+# Python 3.15+ natively intercepts and defers these imports.
+# Developers can disable this behavior and force eager imports.
+# For more information, see:
+# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter
+# Older Python versions safely ignore this variable.
+# NOTE: We statically define all modules here (including async ones) to ensure
+# static analysis tools (mypy, pyright, Ruff) can easily parse them. If async
+# support is not present, the imports are ignored, making their presence safe.
+__lazy_modules__: Set[str] = {
+    "google.api_core.operations_v1.abstract_operations_client",
+    "google.api_core.operations_v1.operations_async_client",
+    "google.api_core.operations_v1.operations_client",
+    "google.api_core.operations_v1.transports.rest",
+    "google.api_core.operations_v1.transports.rest_asyncio",
+    "google.api_core.operations_v1.operations_rest_client_async",
+}
+
+__all__ = [
+    "AbstractOperationsClient",
+    "OperationsAsyncClient",
+    "OperationsClient",
+    "OperationsRestTransport",
+]
+
+
+from google.api_core.operations_v1.abstract_operations_client import (  # noqa: E402
+    AbstractOperationsClient,
+)
+from google.api_core.operations_v1.operations_async_client import (  # noqa: E402
+    OperationsAsyncClient,
+)
+from google.api_core.operations_v1.operations_client import (  # noqa: E402
+    OperationsClient,
+)
+from google.api_core.operations_v1.transports.rest import (  # noqa: E402
+    OperationsRestTransport,
+)
+
+if _has_async_rest:
+    try:
+        # On Python 3.15+, PEP 0810 lazy loading means these imports will succeed
+        # instantly (returning a lazy proxy). Any actual ImportErrors (e.g., due to
+        # missing aiohttp/auth dependencies) are deferred until the proxies are accessed.
+        from google.api_core.operations_v1.transports.rest_asyncio import (  # noqa: E402, F401
+            AsyncOperationsRestTransport,
+        )
+        from google.api_core.operations_v1.operations_rest_client_async import (  # noqa: E402, F401
+            AsyncOperationsRestClient,
+        )
+
+        __all__.extend(["AsyncOperationsRestClient", "AsyncOperationsRestTransport"])
+    except ImportError:
+        # Fallback for older python/environments when importlib find_spec succeeds but actual import fails
+        pass

{google_api_core-2.31.0 → google_api_core-2.32.0}/google/api_core/version.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__version__ = "2.31.0"
+__version__ = "2.32.0"

{google_api_core-2.31.0 → google_api_core-2.32.0/google_api_core.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-api-core
-Version: 2.31.0
+Version: 2.32.0
 Summary: Google API client core library
 Author-email: Google LLC <googleapis-packages@google.com>
 License: Apache 2.0

{google_api_core-2.31.0 → google_api_core-2.32.0}/tests/asyncio/retry/test_retry_streaming_async.py

@@ -293,7 +293,7 @@ class TestAsyncStreamingRetry(Test_BaseRetry):
         generator = await retry_(self._generator_mock)(error_on=3)
         with pytest.raises(TypeError) as exc_info:
             await generator.asend("cannot send to fresh generator")
-            assert exc_info.match("can't send non-None value")
+        assert exc_info.match("can't send non-None value")
         await generator.aclose()
 
         # error thrown on 3

{google_api_core-2.31.0 → google_api_core-2.32.0}/tests/unit/retry/test_retry_streaming.py

@@ -263,7 +263,7 @@ class TestStreamingRetry(Test_BaseRetry):
         with pytest.raises(TypeError) as exc_info:
             # calling first send with non-None input should raise a TypeError
             result.send("can not send to fresh generator")
-            assert exc_info.match("can't send non-None value")
+        assert exc_info.match("can't send non-None value")
         # initiate iteration with None
         result = retry_(self._generator_mock)(error_on=3)
         assert result.send(None) == 0

{google_api_core-2.31.0 → google_api_core-2.32.0}/tests/unit/test_exceptions.py

@@ -25,10 +25,11 @@ try:
 except ImportError:  # pragma: NO COVER
     grpc = rpc_status = None
 
-from google.api_core import exceptions
 from google.protobuf import any_pb2, json_format
 from google.rpc import error_details_pb2, status_pb2
 
+from google.api_core import exceptions
+
 
 def test_create_google_cloud_error():
     exception = exceptions.GoogleAPICallError("Testing")
@@ -393,3 +394,18 @@ def test_error_details_from_grpc_response_unknown_error():
         and exception.domain is None
         and exception.metadata is None
     )
+
+
+@pytest.mark.skipif(grpc is None, reason="No grpc")
+def test_from_grpc_error_misleading_404():
+    message = "Received http2 header with status: 404"
+    error = mock.create_autospec(grpc.Call, instance=True)
+    error.code.return_value = grpc.StatusCode.UNIMPLEMENTED
+    error.details.return_value = message
+
+    exception = exceptions.from_grpc_error(error)
+
+    assert isinstance(exception, exceptions.MethodNotImplemented)
+    assert exception.grpc_status_code == grpc.StatusCode.UNIMPLEMENTED
+    assert "Received http2 header with status: 404" in exception.message
+    assert "api_endpoint" in exception.message

{google_api_core-2.31.0 → google_api_core-2.32.0}/tests/unit/test_python_version_support.py

@@ -12,20 +12,20 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import pytest
 import datetime
 import textwrap
 import warnings
 from collections import namedtuple
-
 from unittest.mock import patch
 
+import pytest
+
 # Code to be tested
 from google.api_core._python_version_support import (
+    PYTHON_VERSION_INFO,
+    PythonVersionStatus,
     _flatten_message,
     check_python_version,
-    PythonVersionStatus,
-    PYTHON_VERSION_INFO,
 )
 
 # Helper object for mocking sys.version_info
@@ -65,10 +65,12 @@ def _create_failure_message(
     )
 
 
-def generate_tracked_version_test_cases():
+def get_tracked_version_test_cases():
     """
-    Yields test parameters for all tracked versions and boundary conditions.
+    Returns a list of test parameters for all tracked versions and boundary conditions.
     """
+    results = []
+
     for version_tuple, version_info in PYTHON_VERSION_INFO.items():
         py_version_str = f"{version_tuple[0]}.{version_tuple[1]}"
         gapic_dep = version_info.gapic_deprecation or (
@@ -111,20 +113,23 @@ def generate_tracked_version_test_cases():
         }
 
         for name, params in test_cases.items():
-            yield pytest.param(
-                version_tuple,
-                params["date"],
-                params["expected"],
-                gapic_dep,
-                gapic_end,
-                eol_warning_starts,
-                id=f"{py_version_str}-{name}",
+            results.append(
+                pytest.param(
+                    version_tuple,
+                    params["date"],
+                    params["expected"],
+                    gapic_dep,
+                    gapic_end,
+                    eol_warning_starts,
+                    id=f"{py_version_str}-{name}",
+                )
             )
+    return results
 
 
 @pytest.mark.parametrize(
     "version_tuple, mock_date, expected_status, gapic_dep, gapic_end, eol_warning_starts",
-    generate_tracked_version_test_cases(),
+    get_tracked_version_test_cases(),
 )
 def test_all_tracked_versions_and_date_scenarios(
     version_tuple, mock_date, expected_status, gapic_dep, gapic_end, eol_warning_starts

google_api_core-2.31.0/google/api_core/gapic_v1/__init__.py

@@ -1,29 +0,0 @@
-# Copyright 2017 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-from google.api_core.gapic_v1 import client_info
-from google.api_core.gapic_v1 import config
-from google.api_core.gapic_v1 import config_async
-from google.api_core.gapic_v1 import method
-from google.api_core.gapic_v1 import method_async
-from google.api_core.gapic_v1 import routing_header
-
-__all__ = [
-    "client_info",
-    "config",
-    "config_async",
-    "method",
-    "method_async",
-    "routing_header",
-]

google_api_core-2.31.0/google/api_core/operations_v1/__init__.py

@@ -1,40 +0,0 @@
-# Copyright 2017 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""Package for interacting with the google.longrunning.operations meta-API."""
-
-from google.api_core.operations_v1.abstract_operations_client import AbstractOperationsClient
-from google.api_core.operations_v1.operations_async_client import OperationsAsyncClient
-from google.api_core.operations_v1.operations_client import OperationsClient
-from google.api_core.operations_v1.transports.rest import OperationsRestTransport
-
-__all__ = [
-    "AbstractOperationsClient",
-    "OperationsAsyncClient",
-    "OperationsClient",
-    "OperationsRestTransport"
-]
-
-try:
-    from google.api_core.operations_v1.transports.rest_asyncio import (
-        AsyncOperationsRestTransport,
-    )
-    from google.api_core.operations_v1.operations_rest_client_async import AsyncOperationsRestClient
-
-    __all__ += ["AsyncOperationsRestClient", "AsyncOperationsRestTransport"]
-except ImportError:
-    # This import requires the `async_rest` extra.
-    # Don't raise an exception if `AsyncOperationsRestTransport` cannot be imported
-    # as other transports are still available.
-    pass