prefect-client 3.4.2.dev3__py3-none-any.whl → 3.4.2.dev5__py3-none-any.whl

prefect/_build_info.py

@@ -1,5 +1,5 @@
 # Generated by versioningit
-__version__ = "3.4.2.dev3"
-__build_date__ = "2025-05-14 08:08:44.736788+00:00"
-__git_commit__ = "951cfc2519e6d8677c42565c3e7b24fd647f31c8"
+__version__ = "3.4.2.dev5"
+__build_date__ = "2025-05-16 08:08:49.856216+00:00"
+__git_commit__ = "554a7b6cb42c108cc8053368259ec6988ef67f74"
 __dirty__ = False

prefect/_internal/uuid7.py

@@ -1,11 +1,119 @@
-from typing import cast
-from uuid import UUID
+from __future__ import annotations
 
-from uuid_extensions import uuid7 as _uuid7  # pyright: ignore[reportMissingTypeStubs]
+import os
+import time
+import uuid
+from typing import Callable, Optional
 
 
-def uuid7() -> UUID:
-    return cast(UUID, _uuid7())
+def _time_ms() -> int:
+    return time.time_ns() // 1_000_000
 
 
-__all__ = ["uuid7"]
+def uuid7(
+    ms: Optional[int] = None,
+    time_func: Callable[[], int] = _time_ms,
+) -> uuid.UUID:
+    """
+    UUID v7, following the proposed extension to RFC4122 described in
+    https://www.ietf.org/id/draft-peabody-dispatch-new-uuid-format-02.html.
+    All representations (string, byte array, int) sort chronologically,
+    with a potential time resolution of 50ns (if the system clock
+    supports this).
+
+    Parameters
+    ----------
+
+    ms      - Optional integer with the whole number of milliseconds
+                since Unix epoch, to set the "as of" timestamp.
+
+    as_type - Optional string to return the UUID in a different format.
+                A uuid.UUID (version 7, variant 0x10) is returned unless
+                this is one of 'str', 'int', 'hex' or 'bytes'.
+
+    time_func - Set the time function, which must return integer
+                milliseconds since the Unix epoch, midnight on 1-Jan-1970.
+                Defaults to time.time_ns()/1e6. This is exposed because
+                time.time_ns() may have a low resolution on Windows.
+
+    Returns
+    -------
+
+    A UUID object, or if as_type is specified, a string, int or
+    bytes of length 16.
+
+    Implementation notes
+    --------------------
+
+    The 128 bits in the UUID are allocated as follows:
+    - 36 bits of whole seconds
+    - 24 bits of fractional seconds, giving approx 50ns resolution
+    - 14 bits of sequential counter, if called repeatedly in same time tick
+    - 48 bits of randomness
+    plus, at locations defined by RFC4122, 4 bits for the
+    uuid version (0b111) and 2 bits for the uuid variant (0b10).
+
+     0                   1                   2                   3
+    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+    |                           unix_ts_ms                          |
+    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+    |          unix_ts_ms           |  ver  |       rand_a          |
+    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+    |var|                        rand_b                             |
+    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+    |                            rand_b                             |
+    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+    Indicative timings:
+    - uuid.uuid4()            2.4us
+    - uuid7()                 3.7us
+    - uuid7(as_type='int')    1.6us
+    - uuid7(as_type='str')    2.5us
+
+    Examples
+    --------
+
+    >>> uuid7()
+    UUID('061cb26a-54b8-7a52-8000-2124e7041024')
+
+    >>> for fmt in ('bytes', 'hex', 'int', 'str', 'uuid', None):
+    ...     print(fmt, repr(uuid7(as_type=fmt)))
+    bytes b'\x06\x1c\xb8\xfe\x0f\x0b|9\x80\x00\tjt\x85\xb3\xbb'
+    hex '061cb8fe0f0b7c3980011863b956b758'
+    int 8124504378724980906989670469352026642
+    str '061cb8fe-0f0b-7c39-8003-d44a7ee0bdf6'
+    uuid UUID('061cb8fe-0f0b-7c39-8004-0489578299f6')
+    None UUID('061cb8fe-0f0f-7df2-8000-afd57c2bf446')
+    """
+    if ms is None:
+        ms = time_func()
+    else:
+        ms = int(ms)  # Fail fast if not an int
+
+    rand_a = int.from_bytes(bytes=os.urandom(2), byteorder="big")
+    rand_b = int.from_bytes(bytes=os.urandom(8), byteorder="big")
+    uuid_bytes = uuidfromvalues(ms, rand_a, rand_b)
+
+    uuid_int = int.from_bytes(bytes=uuid_bytes, byteorder="big")
+    return uuid.UUID(int=uuid_int)
+
+
+def uuidfromvalues(unix_ts_ms: int, rand_a: int, rand_b: int):
+    version = 0x07
+    var = 2
+    rand_a &= 0xFFF
+    rand_b &= 0x3FFFFFFFFFFFFFFF
+
+    final_bytes = unix_ts_ms.to_bytes(length=6, byteorder="big")
+    final_bytes += ((version << 12) + rand_a).to_bytes(length=2, byteorder="big")
+    final_bytes += ((var << 62) + rand_b).to_bytes(length=8, byteorder="big")
+
+    return final_bytes
+
+
+def format_byte_array_as_uuid(arr: bytes):
+    return f"{arr[:4].hex()}-{arr[4:6].hex()}-{arr[6:8].hex()}-{arr[8:10].hex()}-{arr[10:].hex()}"
+
+
+__all__ = ("uuid7",)

prefect/settings/models/tasks.py

@@ -1,9 +1,10 @@
-from typing import ClassVar, Optional, Union
+from typing import ClassVar, Optional
 
 from pydantic import AliasChoices, AliasPath, Field
 from pydantic_settings import SettingsConfigDict
 
 from prefect.settings.base import PrefectBaseSettings, build_settings_config
+from prefect.types import TaskRetryDelaySeconds
 
 
 class TasksRunnerSettings(PrefectBaseSettings):
@@ -73,7 +74,7 @@ class TasksSettings(PrefectBaseSettings):
         ),
     )
 
-    default_retry_delay_seconds: Union[int, float, list[float]] = Field(
+    default_retry_delay_seconds: TaskRetryDelaySeconds = Field(
         default=0,
         description="This value sets the default retry delay seconds for all tasks.",
         validation_alias=AliasChoices(

prefect/types/__init__.py

@@ -1,8 +1,7 @@
 from __future__ import annotations
 
 from functools import partial
-from typing import Annotated, Any, Optional, TypeVar, Union, cast
-from uuid import UUID
+from typing import Annotated, Any, Optional, TypeVar, Union
 from typing_extensions import Literal
 import orjson
 import pydantic
@@ -132,6 +131,52 @@ ClientRetryExtraCodes = Annotated[
     BeforeValidator(partial(validate_set_T_from_delim_string, type_=StatusCode)),
 ]
 
+
+def parse_retry_delay_input(value: Any) -> Any:
+    """
+    Parses various inputs (string, int, float, list) into a format suitable
+    for TaskRetryDelaySeconds (int, float, list[float], or None).
+    Handles comma-separated strings for lists of delays.
+    """
+    if isinstance(value, str):
+        stripped_value = value.strip()
+        if not stripped_value:
+            return None  # Treat empty or whitespace-only string as None
+
+        delim = ","
+        # Split and filter empty strings that result from multiple commas (e.g., "10,,20")
+        parts = [s.strip() for s in stripped_value.split(delim) if s.strip()]
+
+        if not parts:  # e.g., value was just "," or " , "
+            return None
+
+        def _parse_num_part(part_str: str) -> Union[float, int]:
+            try:
+                # Prefer float to align with list[float] in TaskRetryDelaySeconds
+                return TypeAdapter(float).validate_strings(part_str)
+            except pydantic.ValidationError:
+                try:
+                    return TypeAdapter(int).validate_strings(part_str)
+                except pydantic.ValidationError as e_int:
+                    raise ValueError(
+                        f"Invalid number format '{part_str}' for retry delay."
+                    ) from e_int
+
+        if len(parts) == 1:
+            return _parse_num_part(parts[0])
+        else:
+            return [_parse_num_part(p) for p in parts]
+
+    # For non-string inputs (int, float, list, None, etc.), pass them through.
+    # Pydantic will then validate them against Union[int, float, list[float], None].
+    return value
+
+
+TaskRetryDelaySeconds = Annotated[
+    Union[str, int, float, list[float], None],
+    BeforeValidator(parse_retry_delay_input),
+]
+
 LogLevel = Annotated[
     Literal["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"],
     BeforeValidator(lambda x: x.upper()),
@@ -173,4 +218,5 @@ __all__ = [
     "SecretDict",
     "StatusCode",
     "StrictVariableValue",
+    "TaskRetryDelaySeconds",
 ]

{prefect_client-3.4.2.dev3.dist-info → prefect_client-3.4.2.dev5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.4.2.dev3
+Version: 3.4.2.dev5
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
@@ -60,7 +60,6 @@ Requires-Dist: sniffio<2.0.0,>=1.3.0
 Requires-Dist: toml>=0.10.0
 Requires-Dist: typing-extensions<5.0.0,>=4.10.0
 Requires-Dist: ujson<6.0.0,>=5.8.0
-Requires-Dist: uuid7>=0.1.0
 Requires-Dist: uvicorn!=0.29.0,>=0.14.0
 Requires-Dist: websockets<16.0,>=13.0
 Requires-Dist: whenever<0.9.0,>=0.7.3; python_version >= '3.13'

{prefect_client-3.4.2.dev3.dist-info → prefect_client-3.4.2.dev5.dist-info}/RECORD

@@ -1,7 +1,7 @@
 prefect/.prefectignore,sha256=awSprvKT0vI8a64mEOLrMxhxqcO-b0ERQeYpA2rNKVQ,390
 prefect/__init__.py,sha256=iCdcC5ZmeewikCdnPEP6YBAjPNV5dvfxpYCTpw30Hkw,3685
 prefect/__main__.py,sha256=WFjw3kaYJY6pOTA7WDOgqjsz8zUEUZHCcj3P5wyVa-g,66
-prefect/_build_info.py,sha256=XdQrk5WfZqL08ADpDNeCb9MymVHjSo9jKylGZ-rci8g,185
+prefect/_build_info.py,sha256=AWVLbjCFHwKUP8q5HwClWRDz36Fc5bNwB4xEWyjMum0,185
 prefect/_result_records.py,sha256=S6QmsODkehGVSzbMm6ig022PYbI6gNKz671p_8kBYx4,7789
 prefect/_versioning.py,sha256=YqR5cxXrY4P6LM1Pmhd8iMo7v_G2KJpGNdsf4EvDFQ0,14132
 prefect/_waiters.py,sha256=Ia2ITaXdHzevtyWIgJoOg95lrEXQqNEOquHvw3T33UQ,9026
@@ -43,7 +43,7 @@ prefect/_internal/_logging.py,sha256=Igy2tCM2Hv9wNiDPcee0s5N1fTc6oRP7OffCJBqAekY
 prefect/_internal/integrations.py,sha256=U4cZMDbnilzZSKaMxvzZcSL27a1tzRMjDoTfr2ul_eY,231
 prefect/_internal/pytz.py,sha256=Sy_cD-Hkmo_Yrhx2Jucy7DgTRhvO8ZD0whW1ywbSg_U,13765
 prefect/_internal/retries.py,sha256=pMHofrTQPDSxbVWclDwXbfhFKaDC6sxe1DkUOWugV6k,3040
-prefect/_internal/uuid7.py,sha256=-Wl5rFozDSKRyhSfa9WT8BK1U5Rq8ehEgZB5aV5lodU,211
+prefect/_internal/uuid7.py,sha256=yvndhibNDrqnYrG-qUncas4XQp8bKVbmM8XfF7JrjJI,4203
 prefect/_internal/compatibility/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 prefect/_internal/compatibility/async_dispatch.py,sha256=cUXOqSeseMUaje9oYUzasVPtNttyiHvrqfJl0zK66XI,2949
 prefect/_internal/compatibility/blocks.py,sha256=SSZXoWVuCMYu1EzjqmTa4lKjDCyxvOFK47XMj6s4hsk,984
@@ -257,7 +257,7 @@ prefect/settings/models/logging.py,sha256=Sj9GDNr5QMFaP6CN0WJyfpwhpOk4p1yhv45dyQ
 prefect/settings/models/results.py,sha256=VWFplQSSJyc0LXnziw1H5b3N_PDS32QBe_q2MWwYni0,1484
 prefect/settings/models/root.py,sha256=HpXt_I6T_kJw6QAxez4pCZl8p058etihzJbBNRylN3c,16767
 prefect/settings/models/runner.py,sha256=rD8OmNLwILmqnGe9YkM1dWKsulx3clYm4LI5N9vD5yM,1991
-prefect/settings/models/tasks.py,sha256=XA83-EmWv1FKvODSzvI1cvS3tGEbNs2qtdh0AbUdblQ,3640
+prefect/settings/models/tasks.py,sha256=Rj3Tl8S04swCZIWgBCdn8sHct0B2IVgfPmM370Muj3E,3672
 prefect/settings/models/testing.py,sha256=j9YH_WkB14iEzOjUtTmvY978qRSbgCypFSEi_cOs8no,1820
 prefect/settings/models/worker.py,sha256=zeDU71aR4CEvEOKyH-1jgEyol8XYe29PExjIC6a8Wv0,1378
 prefect/settings/models/server/__init__.py,sha256=KJmffmlHb8GYnClaeYcerae-IaeNsNMucKKRRS_zG9Q,33
@@ -278,7 +278,7 @@ prefect/telemetry/logging.py,sha256=ktIVTXbdZ46v6fUhoHNidFrpvpNJR-Pj-hQ4V9b40W4,
 prefect/telemetry/processors.py,sha256=jw6j6LviOVxw3IBJe7cSjsxFk0zzY43jUmy6C9pcfCE,2272
 prefect/telemetry/run_telemetry.py,sha256=_FbjiPqPemu4xvZuI2YBPwXeRJ2BcKRJ6qgO4UMzKKE,8571
 prefect/telemetry/services.py,sha256=DxgNNDTeWNtHBtioX8cjua4IrCbTiJJdYecx-gugg-w,2358
-prefect/types/__init__.py,sha256=SwyWpbxSevAKU9lWpfauD61whUP7kksvfx-mtq3UE6E,4288
+prefect/types/__init__.py,sha256=uZyu9xcaxoNg4T3_GHVyE_dlEXSetCjXpco9oKiJb80,6038
 prefect/types/_datetime.py,sha256=ZE-4YK5XJuyxnp5pqldZwtIjkxCpxDGnCSfZiTl7-TU,7566
 prefect/types/entrypoint.py,sha256=2FF03-wLPgtnqR_bKJDB2BsXXINPdu8ptY9ZYEZnXg8,328
 prefect/types/names.py,sha256=CMMZD928iiod2UvB0qrsfXEBC5jj_bO0ge1fFXcrtgM,3450
@@ -322,7 +322,7 @@ prefect/workers/cloud.py,sha256=dPvG1jDGD5HSH7aM2utwtk6RaJ9qg13XjkA0lAIgQmY,287
 prefect/workers/process.py,sha256=Yi5D0U5AQ51wHT86GdwtImXSefe0gJf3LGq4r4z9zwM,11090
 prefect/workers/server.py,sha256=2pmVeJZiVbEK02SO6BEZaBIvHMsn6G8LzjW8BXyiTtk,1952
 prefect/workers/utilities.py,sha256=VfPfAlGtTuDj0-Kb8WlMgAuOfgXCdrGAnKMapPSBrwc,2483
-prefect_client-3.4.2.dev3.dist-info/METADATA,sha256=8Prpr9Dv91MDdCLVe6wwH-XzvHtUO821oLHXJ8bEH1c,7500
-prefect_client-3.4.2.dev3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-prefect_client-3.4.2.dev3.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
-prefect_client-3.4.2.dev3.dist-info/RECORD,,
+prefect_client-3.4.2.dev5.dist-info/METADATA,sha256=n8zQ-Q4hRbiwFNqO9cBv4FduMfchIcQ1GNdszSDPsDY,7472
+prefect_client-3.4.2.dev5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+prefect_client-3.4.2.dev5.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
+prefect_client-3.4.2.dev5.dist-info/RECORD,,