prefect-client 3.4.3.dev2__py3-none-any.whl → 3.4.4__py3-none-any.whl

prefect/_build_info.py

@@ -1,5 +1,5 @@
 # Generated by versioningit
-__version__ = "3.4.3.dev2"
-__build_date__ = "2025-05-21 08:09:05.236151+00:00"
-__git_commit__ = "7d4d41615e614b9f46eb317a2948a3d0643a07f5"
+__version__ = "3.4.4"
+__build_date__ = "2025-05-29 21:36:59.371770+00:00"
+__git_commit__ = "0367d7aa7939aa1a26152a9db9997a75aadd6e3b"
 __dirty__ = False

prefect/_internal/concurrency/calls.py

@@ -222,7 +222,7 @@ class Future(concurrent.futures.Future[T]):
             self._cancel_scope = None
 
 
-@dataclasses.dataclass
+@dataclasses.dataclass(eq=False)
 class Call(Generic[T]):
     """
     A deferred function call.
@@ -236,6 +236,42 @@ class Call(Generic[T]):
     timeout: Optional[float]
     runner: Optional["Portal"] = None
 
+    def __eq__(self, other: object) -> bool:
+        """this is to avoid attempts at invalid access of args/kwargs in <3.13 stemming from the
+        auto-generated __eq__ method on the dataclass.
+
+        this will no longer be required in 3.13+, see https://github.com/python/cpython/issues/128294
+        """
+        if self is other:
+            return True
+        if not isinstance(other, Call):
+            return NotImplemented
+
+        try:
+            # Attempt to access args/kwargs. If any are missing on self or other,
+            # an AttributeError will be raised by the access attempt on one of them.
+            s_args, s_kwargs = self.args, self.kwargs
+            o_args, o_kwargs = other.args, other.kwargs
+        except AttributeError:
+            # If args/kwargs are missing on self or other (and self is not other),
+            # they are considered not equal. This ensures that a Call with deleted
+            # args/kwargs compares as different from one that still has them
+            return False
+
+        # If all args/kwargs were accessible on both, proceed with full field comparison.
+        # Note: self.future == other.future will use Future's __eq__ (default is identity).
+        return (
+            (self.future == other.future)
+            and (self.fn == other.fn)
+            and (s_args == o_args)
+            and (s_kwargs == o_kwargs)
+            and (self.context == other.context)
+            and (self.timeout == other.timeout)
+            and (self.runner == other.runner)
+        )
+
+    __hash__ = None  # type: ignore
+
     @classmethod
     def new(
         cls,

prefect/_internal/schemas/validators.py

@@ -402,6 +402,18 @@ def validate_compressionlib(value: str) -> str:
 
 
 # TODO: if we use this elsewhere we can change the error message to be more generic
+@overload
+def list_length_50_or_less(v: int) -> int: ...
+
+
+@overload
+def list_length_50_or_less(v: float) -> float: ...
+
+
+@overload
+def list_length_50_or_less(v: list[int]) -> list[int]: ...
+
+
 @overload
 def list_length_50_or_less(v: list[float]) -> list[float]: ...
 
@@ -410,7 +422,9 @@ def list_length_50_or_less(v: list[float]) -> list[float]: ...
 def list_length_50_or_less(v: None) -> None: ...
 
 
-def list_length_50_or_less(v: Optional[list[float]]) -> Optional[list[float]]:
+def list_length_50_or_less(
+    v: Optional[int | float | list[int] | list[float]],
+) -> Optional[int | float | list[int] | list[float]]:
     if isinstance(v, list) and (len(v) > 50):
         raise ValueError("Can not configure more than 50 retry delays per task.")
     return v

prefect/client/schemas/objects.py

@@ -698,7 +698,7 @@ class TaskRunPolicy(PrefectBaseModel):
         deprecated=True,
     )
     retries: Optional[int] = Field(default=None, description="The number of retries.")
-    retry_delay: Union[None, int, list[int]] = Field(
+    retry_delay: Union[None, int, float, list[int], list[float]] = Field(
         default=None,
         description="A delay time or list of delay times between retries, in seconds.",
     )
@@ -728,8 +728,8 @@ class TaskRunPolicy(PrefectBaseModel):
     @field_validator("retry_delay")
     @classmethod
     def validate_configured_retry_delays(
-        cls, v: Optional[list[float]]
-    ) -> Optional[list[float]]:
+        cls, v: Optional[int | float | list[int] | list[float]]
+    ) -> Optional[int | float | list[int] | list[float]]:
         return list_length_50_or_less(v)
 
     @field_validator("retry_jitter_factor")

prefect/server/api/clients.py

@@ -18,7 +18,7 @@ from prefect.server.schemas.actions import DeploymentFlowRunCreate, StateCreate
 from prefect.server.schemas.core import WorkPool
 from prefect.server.schemas.filters import VariableFilter, VariableFilterName
 from prefect.server.schemas.responses import DeploymentResponse, OrchestrationResult
-from prefect.settings import PREFECT_SERVER_API_AUTH_STRING
+from prefect.settings import get_current_settings
 from prefect.types import StrictVariableValue
 
 if TYPE_CHECKING:
@@ -39,18 +39,19 @@ class BaseClient:
         # will point it to the the currently running server instance
         api_app = create_app()
 
-        # we pull the auth string from _server_ settings because this client is run on the server
-        auth_string = PREFECT_SERVER_API_AUTH_STRING.value()
+        settings = get_current_settings()
 
-        if auth_string:
-            token = base64.b64encode(auth_string.encode("utf-8")).decode("utf-8")
-            additional_headers.setdefault("Authorization", f"Basic {token}")
+        # we pull the auth string from _server_ settings because this client is run on the server
+        if auth_string_secret := settings.server.api.auth_string:
+            if auth_string := auth_string_secret.get_secret_value():
+                token = base64.b64encode(auth_string.encode("utf-8")).decode("utf-8")
+                additional_headers.setdefault("Authorization", f"Basic {token}")
 
         self._http_client = PrefectHttpxAsyncClient(
             transport=httpx.ASGITransport(app=api_app, raise_app_exceptions=False),
             headers={**additional_headers},
             base_url="http://prefect-in-memory/api",
-            enable_csrf_support=False,
+            enable_csrf_support=settings.server.api.csrf_protection_enabled,
             raise_on_all_errors=False,
         )
 

prefect/settings/models/tasks.py

@@ -63,6 +63,11 @@ class TasksSettings(PrefectBaseSettings):
         description="If `True`, sets the default cache policy on all tasks to `NO_CACHE`.",
     )
 
+    disable_caching: bool = Field(
+        default=False,
+        description="If `True`, disables caching on all tasks regardless of cache policy.",
+    )
+
     default_retries: int = Field(
         default=0,
         ge=0,

prefect/task_runners.py

@@ -11,11 +11,8 @@ from typing import (
     TYPE_CHECKING,
     Any,
     Coroutine,
-    Dict,
     Generic,
     Iterable,
-    List,
-    Optional,
     overload,
 )
 
@@ -110,7 +107,7 @@ class TaskRunner(abc.ABC, Generic[F]):
         self,
         task: "Task[P, R]",
         parameters: dict[str, Any | unmapped[Any] | allow_failure[Any]],
-        wait_for: Optional[Iterable[PrefectFuture[R]]] = None,
+        wait_for: Iterable[PrefectFuture[R]] | None = None,
     ) -> PrefectFutureList[F]:
         """
         Submit multiple tasks to the task run engine.
@@ -183,7 +180,7 @@ class TaskRunner(abc.ABC, Generic[F]):
 
         map_length = list(lengths)[0]
 
-        futures: List[PrefectFuture[Any]] = []
+        futures: list[PrefectFuture[Any]] = []
         for i in range(map_length):
             call_parameters: dict[str, Any] = {
                 key: value[i] for key, value in iterable_parameters.items()
@@ -229,15 +226,32 @@ class TaskRunner(abc.ABC, Generic[F]):
 
 
 class ThreadPoolTaskRunner(TaskRunner[PrefectConcurrentFuture[R]]):
-    def __init__(self, max_workers: Optional[int] = None):
+    """
+    A task runner that executes tasks in a separate thread pool.
+
+    Attributes:
+        max_workers: The maximum number of threads to use for executing tasks.
+            Defaults to `PREFECT_TASK_RUNNER_THREAD_POOL_MAX_WORKERS` or `sys.maxsize`.
+
+    Note:
+        This runner uses `contextvars.copy_context()` for thread-safe context propagation.
+        However, because contextvars are thread-local, frequent task submissions
+        that modify context (e.g., using `prefect.tags` in a loop) can lead to
+        new thread creation per task. This may cause an increase in threads and
+        file descriptors, potentially hitting OS limits (`OSError: Too many open files`).
+        If this occurs, consider minimizing context changes within looped tasks or
+        adjusting system limits for open file descriptors.
+    """
+
+    def __init__(self, max_workers: int | None = None):
         super().__init__()
-        self._executor: Optional[ThreadPoolExecutor] = None
+        self._executor: ThreadPoolExecutor | None = None
         self._max_workers = (
             (PREFECT_TASK_RUNNER_THREAD_POOL_MAX_WORKERS.value() or sys.maxsize)
             if max_workers is None
             else max_workers
         )
-        self._cancel_events: Dict[uuid.UUID, threading.Event] = {}
+        self._cancel_events: dict[uuid.UUID, threading.Event] = {}
 
     def duplicate(self) -> "ThreadPoolTaskRunner[R]":
         return type(self)(max_workers=self._max_workers)

prefect/tasks.py

@@ -466,6 +466,10 @@ class Task(Generic[P, R]):
             ):
                 persist_result = True
 
+        # Check for global cache disable setting
+        if settings.tasks.disable_caching:
+            cache_policy = NO_CACHE
+
         if persist_result is False:
             self.cache_policy = None if cache_policy is None else NO_CACHE
             if cache_policy and cache_policy is not NotSet and cache_policy != NO_CACHE:

{prefect_client-3.4.3.dev2.dist-info → prefect_client-3.4.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.4.3.dev2
+Version: 3.4.4
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
@@ -23,7 +23,7 @@ Classifier: Topic :: Software Development :: Libraries
 Requires-Python: <3.14,>=3.9
 Requires-Dist: anyio<5.0.0,>=4.4.0
 Requires-Dist: asgi-lifespan<3.0,>=1.0
-Requires-Dist: cachetools<6.0,>=5.3
+Requires-Dist: cachetools<7.0,>=5.3
 Requires-Dist: cloudpickle<4.0,>=2.0
 Requires-Dist: coolname<3.0.0,>=1.0.4
 Requires-Dist: dateparser<2.0.0,>=1.1.1

{prefect_client-3.4.3.dev2.dist-info → prefect_client-3.4.4.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=3cVrM_qc7Q6Kdm1TIbmBwoGF5Kmc7_ptAVz6o6kphUs,185
+prefect/_build_info.py,sha256=QmfdmWUQCGFBVn2mDWhjq7ccUFcw17pNoZ_Rjpq8ejo,180
 prefect/_result_records.py,sha256=S6QmsODkehGVSzbMm6ig022PYbI6gNKz671p_8kBYx4,7789
 prefect/_versioning.py,sha256=YqR5cxXrY4P6LM1Pmhd8iMo7v_G2KJpGNdsf4EvDFQ0,14132
 prefect/_waiters.py,sha256=Ia2ITaXdHzevtyWIgJoOg95lrEXQqNEOquHvw3T33UQ,9026
@@ -25,10 +25,10 @@ prefect/schedules.py,sha256=dhq4OhImRvcmtxF7UH1m8RbwYdHT5RQsp_FrxVXfODE,7289
 prefect/serializers.py,sha256=lU9A1rGEfAfhr8nTl3rf-K7ED78QNShXOrmRBhgNk3Y,9566
 prefect/states.py,sha256=rh7l1bnIYpTXdlXt5nnpz66y9KLjBWAJrN9Eo5RwgQs,26023
 prefect/task_engine.py,sha256=MIHEpg10imcltIRoUKjBnPKf9XuW_lh1gf5FGos_g3E,62819
-prefect/task_runners.py,sha256=PozMYXXjiy5pMStifjdBTnLRTtP9uRuBa86KgafpPkQ,16243
+prefect/task_runners.py,sha256=ptgE5wuXg_IVHM0j7d6l7ELAVg3SXSy4vggnoHRF8dA,17040
 prefect/task_runs.py,sha256=7LIzfo3fondCyEUpU05sYFN5IfpZigBDXrhG5yc-8t0,9039
 prefect/task_worker.py,sha256=RifZ3bOl6ppoYPiOAd4TQp2_GEw9eDQoW483rq1q52Q,20805
-prefect/tasks.py,sha256=s8z5k_3KUC0FXzE10-VWH17Uc36a1GKbMOn3jYGbbjk,74954
+prefect/tasks.py,sha256=f63tjtkXiZEiV7LUVMs5LByXDb1gLeT3UYPO6VgDzZA,75083
 prefect/transactions.py,sha256=uIoPNudzJzH6NrMJhrgr5lyh6JxOJQqT1GvrXt69yNw,26068
 prefect/variables.py,sha256=dCK3vX7TbkqXZhnNT_v7rcGh3ISRqoR6pJVLpoll3Js,8342
 prefect/_experimental/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -51,7 +51,7 @@ prefect/_internal/compatibility/deprecated.py,sha256=YUK1IGOgZrDh6dYRez-9IYTB1eq
 prefect/_internal/compatibility/migration.py,sha256=Z_r28B90ZQkSngXjr4I_9zA6P74_u48mtp2jYWB9zGg,6797
 prefect/_internal/concurrency/__init__.py,sha256=YlTwU9ryjPNwbJa45adLJY00t_DGCh1QrdtY9WdVFfw,2140
 prefect/_internal/concurrency/api.py,sha256=9MuQ0icQVTxwxChujn9mnv0WXRqwToysQy9GWC3sJRg,7352
-prefect/_internal/concurrency/calls.py,sha256=DkXNOpOrEM8IhFNE7E_ondwg1gcBeceLgoWPH3F2ExM,16596
+prefect/_internal/concurrency/calls.py,sha256=e9eL7dmSairKdHg4KdRDWcM_L2CShZMtGyhp1JNxnpY,18176
 prefect/_internal/concurrency/cancellation.py,sha256=stCN22-S0f_kZPk50hCEEYzH35fBel3Nthq86FrW0MU,18675
 prefect/_internal/concurrency/event_loop.py,sha256=N6SyBV0vaSF5HD4_JM8zL7oBGd2nMuEKkeSPnBZdHw4,2136
 prefect/_internal/concurrency/inspection.py,sha256=wUWVbHi4G-BxuuYFWhTNmo5yc1C651lQrp5OMiHPU1E,3545
@@ -68,7 +68,7 @@ prefect/_internal/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 prefect/_internal/schemas/bases.py,sha256=wYBIa5f5BwiKid7Rwp90gqxs7mt4qGBURdtv5dgWJxk,4583
 prefect/_internal/schemas/fields.py,sha256=m4LrFNz8rA9uBhMk9VyQT6FIXmV_EVAW92hdXeSvHbY,837
 prefect/_internal/schemas/serializers.py,sha256=G_RGHfObjisUiRvd29p-zc6W4bwt5rE1OdR6TXNrRhQ,825
-prefect/_internal/schemas/validators.py,sha256=bOtuOYHWfRo-i6zqkE-wvCMXQ3Yww-itj86QLp3yu3Y,16681
+prefect/_internal/schemas/validators.py,sha256=h5LL6WuXf4rMmLHsYFflmJBlwqi5c7y0tYibMJzJANM,16933
 prefect/_vendor/croniter/__init__.py,sha256=NUFzdbyPcTQhIOFtzmFM0nbClAvBbKh2mlnTBa6NfHU,523
 prefect/_vendor/croniter/croniter.py,sha256=eJ2HzStNAYV-vNiLOgDXl4sYWWHOsSA0dgwbkQoguhY,53009
 prefect/blocks/__init__.py,sha256=D0hB72qMfgqnBB2EMZRxUxlX9yLfkab5zDChOwJZmkY,220
@@ -116,7 +116,7 @@ prefect/client/orchestration/_work_pools/client.py,sha256=s1DfUQQBgB2sLiVVPhLNTl
 prefect/client/schemas/__init__.py,sha256=InZcDzdeWA2oaV0TlyvoMcyLcbi_aaqU1U9D6Gx-eoU,2747
 prefect/client/schemas/actions.py,sha256=E46Mdq7vAq8hhYmMj6zqUF20uAPXZricViZcIYmgEf0,32443
 prefect/client/schemas/filters.py,sha256=qa--NNZduuSOcL1xw-YMd4FVIKMrDnBwPPY4m5Di0GA,35963
-prefect/client/schemas/objects.py,sha256=e5CMS6FhuYqTmxXK1U80eH5zEC0YkZ_vS_aJdr0VA5o,57912
+prefect/client/schemas/objects.py,sha256=6rR9ccLJ4f1Hw0J8ywzgX2L3FRw8--XCQX9blBrE7R8,57984
 prefect/client/schemas/responses.py,sha256=Zdcx7jlIaluEa2uYIOE5mK1HsJvWPErRAcaWM20oY_I,17336
 prefect/client/schemas/schedules.py,sha256=sxLFk0SmFY7X1Y9R9HyGDqOS3U5NINBWTciUU7vTTic,14836
 prefect/client/schemas/sorting.py,sha256=L-2Mx-igZPtsUoRUguTcG3nIEstMEMPD97NwPM2Ox5s,2579
@@ -204,7 +204,7 @@ prefect/server/api/block_capabilities.py,sha256=7Z5kUIOs-ATKgrFI6r4es5YtuS56jnTW
 prefect/server/api/block_documents.py,sha256=zK9Tgo2FaEHDFvt9f9jLjGd4a7OEWT78IvJzHZaQQnE,5837
 prefect/server/api/block_schemas.py,sha256=9iYVsRHhswAlNxysoYa2UMeddzzltudecwwhC6hP9-Y,5497
 prefect/server/api/block_types.py,sha256=_fXzKFiWtuj4jvopQ_tHVbD0QKKngVshcR4tKM9Jqm0,8327
-prefect/server/api/clients.py,sha256=7Xr10JPj3FykLJ3v6Id251LgW6W-6xaWyqSU_RWcolA,8867
+prefect/server/api/clients.py,sha256=IJWOatH4Bc9xOyxnMxbXEi9d1IychoMKzhXQ8_gtvZI,8995
 prefect/server/api/collections.py,sha256=RI7cjdM8RYFyAk2rgb35vqh06PWGXAamTvwThl83joY,2454
 prefect/server/api/concurrency_limits.py,sha256=E5TB2cJPIZjnxnm1pGxUJnwMDz5CS58gOGH-uGPmkes,10716
 prefect/server/api/concurrency_limits_v2.py,sha256=PGjG7W2Z65OojNTP0ezFu2z69plXo1N8paqwHlHAPj0,10183
@@ -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=Rj3Tl8S04swCZIWgBCdn8sHct0B2IVgfPmM370Muj3E,3672
+prefect/settings/models/tasks.py,sha256=Ky7SpSmm7Vamlf6qPFz2lIk72-5mSwzm9Dz1aVfYhV0,3829
 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
@@ -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.3.dev2.dist-info/METADATA,sha256=GYvxuDRydy5zqbVwTPjmKp3rITtujoiWeu_-g8p_dnU,7472
-prefect_client-3.4.3.dev2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-prefect_client-3.4.3.dev2.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
-prefect_client-3.4.3.dev2.dist-info/RECORD,,
+prefect_client-3.4.4.dist-info/METADATA,sha256=QQWXatVRk2TPpdV0K87UPewRvLZoli5XGyZBZjRuIzo,7467
+prefect_client-3.4.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+prefect_client-3.4.4.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
+prefect_client-3.4.4.dist-info/RECORD,,