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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-api-core
-Version: 2.31.0
+Version: 2.33.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.33.0}/google/api_core/__init__.py

@@ -17,8 +17,7 @@
 This package contains common code and utilities used by Google client libraries.
 """
 
-from google.api_core import _python_package_support
-from google.api_core import _python_version_support
+from google.api_core import _python_package_support, _python_version_support
 from google.api_core import version as api_core_version
 
 __version__ = api_core_version.__version__

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/_python_package_support.py

@@ -15,17 +15,15 @@
 """Code to check versions of dependencies used by Google Cloud Client Libraries."""
 
 import warnings
-from typing import Optional, Tuple
-
 from collections import namedtuple
+from importlib import metadata
+from typing import Optional, Tuple
 
 from ._python_version_support import (
     _flatten_message,
     _get_distribution_and_import_packages,
 )
 
-from importlib import metadata
-
 ParsedVersion = Tuple[int, ...]
 
 # Here we list all the packages for which we want to issue warnings

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/_python_version_support.py

@@ -17,13 +17,12 @@
 import datetime
 import enum
 import functools
-from importlib import metadata
 import logging
-import warnings
 import sys
 import textwrap
-from typing import Any, List, NamedTuple, Optional, Dict, Tuple
-
+import warnings
+from importlib import metadata
+from typing import Any, Dict, List, NamedTuple, Optional, Tuple
 
 _LOGGER = logging.getLogger(__name__)
 

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/bidi.py

@@ -113,7 +113,7 @@ class _RequestQueueGenerator(object):
             except queue_module.Empty:
                 if not self._is_active():
                     _LOGGER.debug(
-                        "Empty queue and inactive call, exiting request " "generator."
+                        "Empty queue and inactive call, exiting request generator."
                     )
                     return
                 else:

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/bidi_async.py

@@ -18,14 +18,12 @@ import asyncio
 import logging
 from typing import Callable, Optional, Union
 
+from google.protobuf.message import Message as ProtobufMessage
 from grpc import aio
 
 from google.api_core import exceptions
 from google.api_core.bidi_base import BidiRpcBase
 
-from google.protobuf.message import Message as ProtobufMessage
-
-
 _LOGGER = logging.getLogger(__name__)
 
 

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/client_logging.py

@@ -1,7 +1,6 @@
-import logging
 import json
+import logging
 import os
-
 from typing import List, Optional
 
 _LOGGING_INITIALIZED = False

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/datetime_helpers.py

@@ -20,7 +20,6 @@ import re
 
 from google.protobuf import timestamp_pb2
 
-
 _UTC_EPOCH = datetime.datetime(1970, 1, 1, tzinfo=datetime.timezone.utc)
 _RFC3339_MICROS = "%Y-%m-%dT%H:%M:%S.%fZ"
 _RFC3339_NO_FRACTION = "%Y-%m-%dT%H:%M:%S"

{google_api_core-2.31.0 → google_api_core-2.33.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.31.0 → google_api_core-2.33.0}/google/api_core/future/_helpers.py

@@ -17,7 +17,6 @@
 import logging
 import threading
 
-
 _LOGGER = logging.getLogger(__name__)
 
 

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/future/async_future.py

@@ -16,9 +16,7 @@
 
 import asyncio
 
-from google.api_core import exceptions
-from google.api_core import retry
-from google.api_core import retry_async
+from google.api_core import exceptions, retry, retry_async
 from google.api_core.future import base
 
 
@@ -101,7 +99,7 @@ class AsyncFuture(base.Future):
             await retry_(self._done_or_raise)()
         except exceptions.RetryError:
             raise asyncio.TimeoutError(
-                "Operation did not complete within the designated " "timeout."
+                "Operation did not complete within the designated timeout."
             )
 
     async def result(self, timeout=None):

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/future/polling.py

@@ -19,8 +19,7 @@ import concurrent.futures
 
 from google.api_core import exceptions
 from google.api_core import retry as retries
-from google.api_core.future import _helpers
-from google.api_core.future import base
+from google.api_core.future import _helpers, base
 
 
 class _OperationNotComplete(Exception):

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

@@ -0,0 +1,57 @@
+# 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.requests",
+    "google.api_core.gapic_v1.routing_header",
+}
+__all__ = ["client_info", "requests", "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,
+    requests,
+    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.31.0 → google_api_core-2.33.0}/google/api_core/gapic_v1/client_info.py

@@ -20,7 +20,6 @@ such as the library and Python version, to API services.
 
 from google.api_core import client_info
 
-
 METRICS_METADATA_KEY = "x-goog-api-client"
 
 

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/gapic_v1/config.py

@@ -22,10 +22,7 @@ import collections
 
 import grpc
 
-from google.api_core import exceptions
-from google.api_core import retry
-from google.api_core import timeout
-
+from google.api_core import exceptions, retry, timeout
 
 _MILLIS_PER_SECOND = 1000.0
 

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/gapic_v1/method_async.py

@@ -21,9 +21,11 @@ import functools
 
 from google.api_core import grpc_helpers_async
 from google.api_core.gapic_v1 import client_info
-from google.api_core.gapic_v1.method import _GapicCallable
-from google.api_core.gapic_v1.method import DEFAULT  # noqa: F401
-from google.api_core.gapic_v1.method import USE_DEFAULT_METADATA  # noqa: F401
+from google.api_core.gapic_v1.method import (  # noqa: F401
+    DEFAULT,
+    USE_DEFAULT_METADATA,
+    _GapicCallable,
+)
 
 _DEFAULT_ASYNC_TRANSPORT_KIND = "grpc_asyncio"
 

google_api_core-2.33.0/google/api_core/gapic_v1/requests.py

@@ -0,0 +1,72 @@
+# -*- coding: utf-8 -*-
+# Copyright 2026 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.
+#
+
+"""Helpers for preparing and structuring API requests.
+
+This module provides utilities to preprocess request parameters and objects
+before invoking API methods, such as automatically generating request IDs
+if they are not already set.
+"""
+
+import uuid
+from typing import Union
+
+import google.protobuf.message
+
+
+def setup_request_id(
+    request: Union[google.protobuf.message.Message, dict, None],
+    field_name: str,
+    is_proto3_optional: bool,
+) -> None:
+    """Populate a UUID4 field in the request if it is not already set.
+
+    This helper is used to ensure request idempotency by automatically
+    generating a unique identifier (such as `request_id`) for requests
+    that support it. If a request is retried, the same identifier can be
+    sent on subsequent retries, allowing the server to recognize the retried
+    request and prevent duplicate processing (e.g., creating duplicate
+    resources).
+
+    Args:
+        request (Union[google.protobuf.message.Message, dict]): The
+            request object.
+        field_name (str): The name of the field to populate.
+        is_proto3_optional (bool): Whether the field is proto3 optional.
+    """
+    if request is None:
+        return
+
+    if isinstance(request, dict):
+        if is_proto3_optional:
+            if field_name not in request or request[field_name] is None:
+                request[field_name] = str(uuid.uuid4())
+        elif not request.get(field_name):
+            request[field_name] = str(uuid.uuid4())
+        return
+
+    if is_proto3_optional:
+        try:
+            # Pure protobuf messages
+            if not request.HasField(field_name):
+                setattr(request, field_name, str(uuid.uuid4()))
+        except (AttributeError, ValueError):
+            # Proto-plus messages or other objects
+            if getattr(request, field_name, None) is None:
+                setattr(request, field_name, str(uuid.uuid4()))
+    else:
+        if not getattr(request, field_name, None):
+            setattr(request, field_name, str(uuid.uuid4()))

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/grpc_helpers_async.py

@@ -21,7 +21,6 @@ functions. This module is implementing the same surface with AsyncIO semantics.
 import asyncio
 import functools
 import warnings
-
 from typing import AsyncGenerator, Generic, Iterator, Optional, TypeVar
 
 import grpc

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operation.py

@@ -39,13 +39,13 @@ Or asynchronously using callbacks and :meth:`Operation.add_done_callback`:
 import functools
 import threading
 
-from google.api_core import exceptions
-from google.api_core import protobuf_helpers
-from google.api_core.future import polling
 from google.longrunning import operations_pb2
 from google.protobuf import json_format
 from google.rpc import code_pb2
 
+from google.api_core import exceptions, protobuf_helpers
+from google.api_core.future import polling
+
 
 class Operation(polling.PollingFuture):
     """A Future for interacting with a Google API Long-Running Operation.

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operation_async.py

@@ -39,12 +39,12 @@ Or asynchronously using callbacks and :meth:`Operation.add_done_callback`:
 import functools
 import threading
 
-from google.api_core import exceptions
-from google.api_core import protobuf_helpers
-from google.api_core.future import async_future
 from google.longrunning import operations_pb2
 from google.rpc import code_pb2
 
+from google.api_core import exceptions, protobuf_helpers
+from google.api_core.future import async_future
+
 
 class AsyncOperation(async_future.AsyncFuture):
     """A Future for interacting with a Google API Long-Running Operation.

google_api_core-2.33.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.operations_rest_client_async import (  # noqa: E402, F401
+            AsyncOperationsRestClient,
+        )
+        from google.api_core.operations_v1.transports.rest_asyncio import (  # noqa: E402, F401
+            AsyncOperationsRestTransport,
+        )
+
+        __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.33.0}/google/api_core/operations_v1/abstract_operations_base_client.py

@@ -13,9 +13,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from collections import OrderedDict
 import os
 import re
+from collections import OrderedDict
 from typing import Dict, Optional, Type, Union
 
 from google.api_core import client_options as client_options_lib  # type: ignore
@@ -358,8 +358,7 @@ class AbstractOperationsBaseClient(metaclass=AbstractOperationsBaseClientMeta):
                 )
             if client_options.scopes:
                 raise ValueError(
-                    "When providing a transport instance, provide its scopes "
-                    "directly."
+                    "When providing a transport instance, provide its scopes directly."
                 )
             self._transport = transport
         else:

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operations_v1/abstract_operations_client.py

@@ -15,21 +15,22 @@
 #
 from typing import Optional, Sequence, Tuple, Union
 
+import grpc
+from google.auth import credentials as ga_credentials  # type: ignore
+from google.longrunning import operations_pb2
+from google.oauth2 import service_account  # type: ignore
+
 from google.api_core import client_options as client_options_lib  # type: ignore
 from google.api_core import gapic_v1  # type: ignore
 from google.api_core import retry as retries  # type: ignore
 from google.api_core.operations_v1 import pagers
+from google.api_core.operations_v1.abstract_operations_base_client import (
+    AbstractOperationsBaseClient,
+)
 from google.api_core.operations_v1.transports.base import (
     DEFAULT_CLIENT_INFO,
     OperationsTransport,
 )
-from google.api_core.operations_v1.abstract_operations_base_client import (
-    AbstractOperationsBaseClient,
-)
-from google.auth import credentials as ga_credentials  # type: ignore
-from google.longrunning import operations_pb2
-from google.oauth2 import service_account  # type: ignore
-import grpc
 
 OptionalRetry = Union[retries.Retry, object]
 

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operations_v1/operations_async_client.py

@@ -24,12 +24,13 @@
 
 import functools
 
+from google.longrunning import operations_pb2
+from grpc import Compression
+
 from google.api_core import exceptions as core_exceptions
 from google.api_core import gapic_v1, page_iterator_async
 from google.api_core import retry_async as retries
 from google.api_core import timeout as timeouts
-from google.longrunning import operations_pb2
-from grpc import Compression
 
 
 class OperationsAsyncClient:

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operations_v1/operations_client.py

@@ -37,13 +37,13 @@ automatically by another client class to deal with operations.
 
 import functools
 
+from google.longrunning import operations_pb2
+from grpc import Compression
+
 from google.api_core import exceptions as core_exceptions
-from google.api_core import gapic_v1
-from google.api_core import page_iterator
+from google.api_core import gapic_v1, page_iterator
 from google.api_core import retry as retries
 from google.api_core import timeout as timeouts
-from google.longrunning import operations_pb2
-from grpc import Compression
 
 
 class OperationsClient(object):

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operations_v1/operations_rest_client_async.py

@@ -15,17 +15,18 @@
 #
 from typing import Optional, Sequence, Tuple, Union
 
+from google.longrunning import operations_pb2
+
 from google.api_core import client_options as client_options_lib  # type: ignore
 from google.api_core import gapic_v1  # type: ignore
 from google.api_core.operations_v1 import pagers_async as pagers
+from google.api_core.operations_v1.abstract_operations_base_client import (
+    AbstractOperationsBaseClient,
+)
 from google.api_core.operations_v1.transports.base import (
     DEFAULT_CLIENT_INFO,
     OperationsTransport,
 )
-from google.api_core.operations_v1.abstract_operations_base_client import (
-    AbstractOperationsBaseClient,
-)
-from google.longrunning import operations_pb2
 
 try:
     from google.auth.aio import credentials as ga_credentials  # type: ignore

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operations_v1/pagers.py

@@ -21,6 +21,7 @@ from typing import (
 )
 
 from google.longrunning import operations_pb2
+
 from google.api_core.operations_v1.pagers_base import ListOperationsPagerBase
 
 

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operations_v1/pagers_async.py

@@ -14,13 +14,14 @@
 # limitations under the License.
 #
 from typing import (
-    Callable,
     AsyncIterator,
+    Callable,
     Sequence,
     Tuple,
 )
 
 from google.longrunning import operations_pb2
+
 from google.api_core.operations_v1.pagers_base import ListOperationsPagerBase
 
 

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operations_v1/transports/__init__.py

@@ -14,7 +14,7 @@
 # limitations under the License.
 #
 from collections import OrderedDict
-from typing import cast, Dict, Tuple
+from typing import Dict, Tuple, cast
 
 from .base import OperationsTransport
 from .rest import OperationsRestTransport

{google_api_core-2.31.0 → google_api_core-2.33.0}/google/api_core/operations_v1/transports/base.py

@@ -15,23 +15,25 @@
 #
 import abc
 import re
-from typing import Awaitable, Callable, Optional, Sequence, Union
 import warnings
+from typing import Awaitable, Callable, Optional, Sequence, Union
 
 import google.auth  # type: ignore
+import google.protobuf
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.longrunning import operations_pb2
 from google.oauth2 import service_account  # type: ignore
-import google.protobuf
 from google.protobuf import empty_pb2, json_format  # type: ignore
 from grpc import Compression
 
 import google.api_core  # type: ignore
 from google.api_core import exceptions as core_exceptions  # type: ignore
-from google.api_core import gapic_v1  # type: ignore
-from google.api_core import general_helpers
+from google.api_core import (
+    gapic_v1,  # type: ignore
+    general_helpers,
+    version,
+)
 from google.api_core import retry as retries  # type: ignore
-from google.api_core import version
 
 PROTOBUF_VERSION = google.protobuf.__version__