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

{google_api_core-2.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.0 → google_api_core-2.33.0}/google/api_core/gapic_v1/__init__.py

@@ -25,9 +25,10 @@ _has_grpc = importlib.util.find_spec("grpc") is not None
 # 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", "routing_header"]
+__all__ = ["client_info", "requests", "routing_header"]
 
 if _has_grpc:
     __lazy_modules__.update(
@@ -41,6 +42,7 @@ if _has_grpc:
 
 from google.api_core.gapic_v1 import (  # noqa: E402
     client_info,
+    requests,
     routing_header,
 )
 

{google_api_core-2.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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.32.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__
 

{google_api_core-2.32.0 → google_api_core-2.33.0}/google/api_core/operations_v1/transports/rest.py

@@ -14,23 +14,27 @@
 # limitations under the License.
 #
 
-from typing import Callable, Dict, Optional, Sequence, Tuple, Union
 import warnings
+from typing import Callable, Dict, Optional, Sequence, Tuple, Union
 
+import google.protobuf
+import grpc
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.auth.transport.requests import AuthorizedSession  # type: ignore
 from google.longrunning import operations_pb2  # type: ignore
-import google.protobuf
-from google.protobuf import empty_pb2  # type: ignore
-from google.protobuf import json_format  # type: ignore
-import grpc
+from google.protobuf import (
+    empty_pb2,  # type: ignore
+    json_format,  # type: ignore
+)
 from requests import __version__ as requests_version
 
 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 path_template  # type: ignore
-from google.api_core import rest_helpers  # type: ignore
+from google.api_core import (
+    gapic_v1,  # type: ignore
+    general_helpers,
+    path_template,  # type: ignore
+    rest_helpers,  # type: ignore
+)
 from google.api_core import retry as retries  # type: ignore
 
 from .base import DEFAULT_CLIENT_INFO as BASE_DEFAULT_CLIENT_INFO

{google_api_core-2.32.0 → google_api_core-2.33.0}/google/api_core/operations_v1/transports/rest_asyncio.py

@@ -15,31 +15,39 @@
 #
 
 import json
-from typing import Any, Callable, Coroutine, Dict, Optional, Sequence, Tuple
 import warnings
+from typing import Any, Callable, Coroutine, Dict, Optional, Sequence, Tuple
 
 from google.auth import __version__ as auth_version
 
 try:
-    from google.auth.aio.transport.sessions import AsyncAuthorizedSession  # type: ignore
+    from google.auth.aio.transport.sessions import (
+        AsyncAuthorizedSession,  # type: ignore
+    )
 except ImportError as e:  # pragma: NO COVER
     raise ImportError(
         "The `async_rest` extra of `google-api-core` is required to use long-running operations.  Install it by running "
         "`pip install google-api-core[async_rest]`."
     ) from e
 
-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 path_template  # type: ignore
-from google.api_core import rest_helpers  # type: ignore
-from google.api_core import retry_async as retries_async  # type: ignore
 from google.auth.aio import credentials as ga_credentials_async  # type: ignore
 from google.longrunning import operations_pb2  # type: ignore
-from google.protobuf import empty_pb2  # type: ignore
-from google.protobuf import json_format  # type: ignore
+from google.protobuf import (
+    empty_pb2,  # type: ignore
+    json_format,  # type: ignore
+)
+
+from google.api_core import exceptions as core_exceptions  # type: ignore
+from google.api_core import (
+    gapic_v1,  # type: ignore
+    general_helpers,
+    path_template,  # type: ignore
+    rest_helpers,  # type: ignore
+)
+from google.api_core import retry_async as retries_async  # type: ignore
 
-from .base import DEFAULT_CLIENT_INFO as BASE_DEFAULT_CLIENT_INFO, OperationsTransport
+from .base import DEFAULT_CLIENT_INFO as BASE_DEFAULT_CLIENT_INFO
+from .base import OperationsTransport
 
 DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo(
     gapic_version=BASE_DEFAULT_CLIENT_INFO.gapic_version,
@@ -307,7 +315,9 @@ class AsyncOperationsRestTransport(OperationsTransport):
         if response.status_code >= 400:
             payload = json.loads(content.decode("utf-8"))
             request_url = "{host}{uri}".format(host=self._host, uri=uri)
-            raise core_exceptions.format_http_response_error(response, method, request_url, payload)  # type: ignore
+            raise core_exceptions.format_http_response_error(
+                response, method, request_url, payload
+            )  # type: ignore
 
         # Return the response
         api_response = operations_pb2.ListOperationsResponse()
@@ -385,7 +395,9 @@ class AsyncOperationsRestTransport(OperationsTransport):
         if response.status_code >= 400:
             payload = json.loads(content.decode("utf-8"))
             request_url = "{host}{uri}".format(host=self._host, uri=uri)
-            raise core_exceptions.format_http_response_error(response, method, request_url, payload)  # type: ignore
+            raise core_exceptions.format_http_response_error(
+                response, method, request_url, payload
+            )  # type: ignore
 
         # Return the response
         api_response = operations_pb2.Operation()
@@ -459,7 +471,9 @@ class AsyncOperationsRestTransport(OperationsTransport):
             content = await response.read()
             payload = json.loads(content.decode("utf-8"))
             request_url = "{host}{uri}".format(host=self._host, uri=uri)
-            raise core_exceptions.format_http_response_error(response, method, request_url, payload)  # type: ignore
+            raise core_exceptions.format_http_response_error(
+                response, method, request_url, payload
+            )  # type: ignore
 
         return empty_pb2.Empty()
 
@@ -539,7 +553,9 @@ class AsyncOperationsRestTransport(OperationsTransport):
             content = await response.read()
             payload = json.loads(content.decode("utf-8"))
             request_url = "{host}{uri}".format(host=self._host, uri=uri)
-            raise core_exceptions.format_http_response_error(response, method, request_url, payload)  # type: ignore
+            raise core_exceptions.format_http_response_error(
+                response, method, request_url, payload
+            )  # type: ignore
 
         return empty_pb2.Empty()
 

{google_api_core-2.32.0 → google_api_core-2.33.0}/google/api_core/path_template.py

@@ -25,10 +25,10 @@ in Google APIs for `resource names`_.
 
 from __future__ import unicode_literals
 
-from collections import deque
 import copy
 import functools
 import re
+from collections import deque
 
 # Regular expression for extracting variable parts from a path template.
 # The variables can be expressed as:
@@ -321,8 +321,7 @@ def transcode(http_options, message=None, **request_kwargs):
         return request
 
     bindings_description = [
-        '\n\tURI: "{}"'
-        "\n\tRequired request fields:\n\t\t{}".format(
+        '\n\tURI: "{}"\n\tRequired request fields:\n\t\t{}'.format(
             uri,
             "\n\t\t".join(
                 [