prefect-client 3.7.4.dev4__py3-none-any.whl → 3.7.5.dev2__py3-none-any.whl

prefect/_build_info.py

@@ -1,5 +1,5 @@
 # Generated by versioningit
-__version__ = "3.7.4.dev4"
-__build_date__ = "2026-06-05 09:16:11.920641+00:00"
-__git_commit__ = "0bad21f4ce99db95716f64cc2eab836eb274b52c"
+__version__ = "3.7.5.dev2"
+__build_date__ = "2026-06-09 09:16:08.541278+00:00"
+__git_commit__ = "d858cb6725864c9a993be6a6633009b03b5e6f5e"
 __dirty__ = False

prefect/client/schemas/schedules.py

@@ -26,6 +26,26 @@ MAX_ITERATIONS = 1000
 MAX_RRULE_LENGTH = 6500
 
 
+def _iana_timezone_name(tzinfo: datetime.tzinfo) -> str:
+    """Return a valid IANA timezone name for *tzinfo*, or `"UTC"`."""
+    for attr in ("key", "name"):
+        value: Optional[str] = getattr(tzinfo, attr, None)
+        if value and is_valid_timezone(value):
+            return value
+
+    filename: Optional[str] = getattr(tzinfo, "_filename", None)
+    if filename:
+        normalized = filename.replace("\\", "/")
+        marker = "/zoneinfo/"
+        idx = normalized.find(marker)
+        if idx != -1:
+            candidate = normalized[idx + len(marker) :]
+            if candidate and is_valid_timezone(candidate):
+                return candidate
+
+    return "UTC"
+
+
 def is_valid_timezone(v: str) -> bool:
     """
     Validate that the provided timezone is a valid IANA timezone.
@@ -204,26 +224,27 @@ class RRuleSchedule(PrefectBaseModel):
         if isinstance(rrule, dateutil.rrule.rrule):
             dtstart = _rrule_dt(rrule)
             if dtstart and dtstart.tzinfo is not None:
-                timezone = dtstart.tzinfo.tzname(dtstart)
+                timezone = _iana_timezone_name(dtstart.tzinfo)
             else:
                 timezone = "UTC"
             return RRuleSchedule(rrule=str(rrule), timezone=timezone)
         rrules = _rrule(rrule)
         dtstarts = [dts for rr in rrules if (dts := _rrule_dt(rr)) is not None]
         unique_dstarts = set(d.astimezone(ZoneInfo("UTC")) for d in dtstarts)
-        unique_timezones = set(d.tzinfo for d in dtstarts if d.tzinfo is not None)
+        unique_tz_names = set(
+            _iana_timezone_name(d.tzinfo) for d in dtstarts if d.tzinfo is not None
+        )
 
-        if len(unique_timezones) > 1:
+        if len(unique_tz_names) > 1:
             raise ValueError(
-                f"rruleset has too many dtstart timezones: {unique_timezones}"
+                f"rruleset has too many dtstart timezones: {unique_tz_names}"
             )
 
         if len(unique_dstarts) > 1:
             raise ValueError(f"rruleset has too many dtstarts: {unique_dstarts}")
 
-        if unique_dstarts and unique_timezones:
-            [unique_tz] = unique_timezones
-            timezone = unique_tz.tzname(dtstarts[0])
+        if unique_dstarts and unique_tz_names:
+            [timezone] = unique_tz_names
         else:
             timezone = "UTC"
 

prefect/deployments/base.py

@@ -278,6 +278,33 @@ def _interval_schedule_to_dict(schedule: IntervalSchedule) -> dict[str, Any]:
     return schedule_config
 
 
+def _deployment_already_saved_to_prefect_file(
+    deployment: dict[str, Any],
+    prefect_file: Path = Path("prefect.yaml"),
+) -> bool:
+    """
+    Return True if `prefect.yaml` already contains a deployment entry matching the
+    given deployment's name and entrypoint.
+
+    Used to decide whether the interactive `prefect deploy` flow should offer to
+    persist a newly-created deployment: a deployment that is already declared in
+    the file does not need to be saved again, but a brand-new one (even when the
+    file otherwise exists) should still be offered up for saving.
+    """
+    if not prefect_file.exists():
+        return False
+
+    with prefect_file.open(mode="r") as f:
+        contents = yaml.safe_load(f) or {}
+
+    for existing in contents.get("deployments") or []:
+        if existing.get("name") == deployment.get("name") and existing.get(
+            "entrypoint"
+        ) == deployment.get("entrypoint"):
+            return True
+    return False
+
+
 def _save_deployment_to_prefect_file(
     deployment: dict[str, Any],
     build_steps: list[dict[str, Any]] | None = None,

prefect/flows.py

@@ -706,7 +706,11 @@ class Flow(Generic[P, R]):
                 from fastapi.encoders import jsonable_encoder
 
                 serialized_parameters[key] = jsonable_encoder(value)
-            except (TypeError, ValueError):
+            except (TypeError, ValueError, RecursionError):
+                # `jsonable_encoder` recurses into unknown objects with no cycle
+                # or depth limit, so a deeply-nested or self-referential value
+                # raises `RecursionError`. Treat it like any other unserializable
+                # value and fall back to the placeholder below.
                 logger.debug(
                     f"Parameter {key!r} for flow {self.name!r} is unserializable. "
                     f"Type {type(value).__name__!r} and will not be stored "

prefect/server/api/workers.py

@@ -25,8 +25,10 @@ import prefect.server.models as models
 import prefect.server.schemas as schemas
 from prefect._internal.uuid7 import uuid7
 from prefect.client.schemas.worker_channel import (
+    CLEANUP_DELIVERY_CAPABILITY,
     WORK_POOL_SNAPSHOT_CAPABILITY,
     WORKER_HEARTBEAT_CAPABILITY,
+    WorkerChannelCapability,
     WorkerChannelCloseReason,
     WorkerChannelProtocolError,
     WorkerHelloFrame,
@@ -48,6 +50,10 @@ from prefect.server.schemas.statuses import WorkQueueStatus
 from prefect.server.utilities import subscriptions
 from prefect.server.utilities import worker_channel as worker_channel_utils
 from prefect.server.utilities.server import PrefectRouter
+from prefect.server.worker_communication.cleanup_queue import (
+    WorkerCleanupQueue,
+    get_worker_cleanup_queue,
+)
 from prefect.types import DateTime
 from prefect.types._datetime import now
 
@@ -61,7 +67,7 @@ router: PrefectRouter = PrefectRouter(
 )
 logger: Logger = get_logger("prefect.server.api.workers")
 
-_OSS_WORKER_CHANNEL_ACCEPTED_CAPABILITIES = [
+_OSS_WORKER_CHANNEL_REQUIRED_CAPABILITIES: list[WorkerChannelCapability] = [
     WORKER_HEARTBEAT_CAPABILITY,
     WORK_POOL_SNAPSHOT_CAPABILITY,
 ]
@@ -183,6 +189,26 @@ class WorkerChannelWorkPoolUpdateEvent:
     changed_fields: dict[str, dict[str, Any]]
 
 
+def _worker_requested_cleanup_delivery(hello: WorkerHelloFrame) -> bool:
+    return (
+        CLEANUP_DELIVERY_CAPABILITY in hello.payload.requested_capabilities
+        and bool(hello.payload.handled_cleanup_kinds)
+        and hello.payload.max_cleanup_concurrency > 0
+    )
+
+
+def _accepted_worker_channel_capabilities(
+    hello: WorkerHelloFrame,
+    *,
+    cleanup_queue_available: bool,
+) -> list[WorkerChannelCapability]:
+    accepted = list(_OSS_WORKER_CHANNEL_REQUIRED_CAPABILITIES)
+    if cleanup_queue_available and _worker_requested_cleanup_delivery(hello):
+        accepted.append(CLEANUP_DELIVERY_CAPABILITY)
+
+    return accepted
+
+
 async def _receive_worker_hello(websocket: WebSocket) -> WorkerHelloFrame:
     try:
         message = await websocket.receive_json()
@@ -290,6 +316,7 @@ async def _build_worker_ready_frame(
     session: AsyncSession,
     work_pool_name: str,
     hello: WorkerHelloFrame,
+    cleanup_queue_available: bool,
 ) -> tuple[WorkerReadyFrame, WorkerChannelWorkPoolUpdateEvent | None]:
     try:
         selected_channel_version = select_worker_channel_version(
@@ -371,7 +398,10 @@ async def _build_worker_ready_frame(
     )
 
     requested_capabilities = list(dict.fromkeys(hello.payload.requested_capabilities))
-    accepted = _OSS_WORKER_CHANNEL_ACCEPTED_CAPABILITIES
+    accepted = _accepted_worker_channel_capabilities(
+        hello,
+        cleanup_queue_available=cleanup_queue_available,
+    )
     accepted_set = set(accepted)
     rejected = [
         capability
@@ -393,7 +423,11 @@ async def _build_worker_ready_frame(
                 ),
                 "accepted_capabilities": accepted,
                 "rejected_capabilities": rejected,
-                "effective_max_cleanup_concurrency": 0,
+                "effective_max_cleanup_concurrency": (
+                    hello.payload.max_cleanup_concurrency
+                    if CLEANUP_DELIVERY_CAPABILITY in accepted_set
+                    else 0
+                ),
                 "resolved_work_queues": [
                     {"id": work_queue.id, "name": work_queue.name}
                     for work_queue in work_queues
@@ -1058,6 +1092,16 @@ async def worker_channel_connect(
 
     try:
         hello = await _receive_worker_hello(websocket)
+        cleanup_queue: WorkerCleanupQueue | None = None
+        if _worker_requested_cleanup_delivery(hello):
+            try:
+                cleanup_queue = get_worker_cleanup_queue()
+            except Exception:
+                logger.exception(
+                    "Worker cleanup delivery queue initialization failed; "
+                    "rejecting cleanup delivery capability"
+                )
+
         async with worker_channel_utils.messaging.ephemeral_subscription(
             worker_channel_utils.WORKER_CHANNEL_SNAPSHOT_TOPIC,
         ) as consumer_kwargs:
@@ -1066,6 +1110,7 @@ async def worker_channel_connect(
                     session=session,
                     work_pool_name=work_pool_name,
                     hello=hello,
+                    cleanup_queue_available=cleanup_queue is not None,
                 )
 
             if work_pool_update_event is not None:
@@ -1094,6 +1139,17 @@ async def worker_channel_connect(
                 work_pool_id=ready.payload.initial_snapshot.work_pool.id,
                 consumer_id=hello.payload.consumer_id,
                 worker_name=hello.payload.worker_name,
+                cleanup_queue=(
+                    cleanup_queue
+                    if CLEANUP_DELIVERY_CAPABILITY
+                    in ready.payload.accepted_capabilities
+                    else None
+                ),
+                cleanup_kinds=tuple(hello.payload.handled_cleanup_kinds),
+                cleanup_work_queue_ids=tuple(
+                    work_queue.id for work_queue in ready.payload.resolved_work_queues
+                ),
+                max_cleanup_concurrency=ready.payload.effective_max_cleanup_concurrency,
             )
             await connection.run(ready, consumer_kwargs)
 

{prefect_client-3.7.4.dev4.dist-info → prefect_client-3.7.5.dev2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.7.4.dev4
+Version: 3.7.5.dev2
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io

{prefect_client-3.7.4.dev4.dist-info → prefect_client-3.7.5.dev2.dist-info}/RECORD

@@ -2,7 +2,7 @@ prefect/.prefectignore,sha256=awSprvKT0vI8a64mEOLrMxhxqcO-b0ERQeYpA2rNKVQ,390
 prefect/AGENTS.md,sha256=SNF9LRWtYJ2pIHUVswgtMaWlloKszhNTL6dhPreh5kc,10484
 prefect/__init__.py,sha256=Z8rwfLbEOLh-5WcznTZP3FG2-9UgGZxY-prj8sL0-Qk,6828
 prefect/__main__.py,sha256=WFjw3kaYJY6pOTA7WDOgqjsz8zUEUZHCcj3P5wyVa-g,66
-prefect/_build_info.py,sha256=WU2mNlfcFQA8kDMsDtikipEG6vTO45zBeh_8fxO-rg0,185
+prefect/_build_info.py,sha256=MI6U3f99m0YbYm29YRaf-ZheYXnRNX5o_CuzpKn0Fq0,185
 prefect/_flow_run_suspension.py,sha256=5zTTB7ZIBHzoS0pVrhNn23-9hK51qZ3CQA6C-azluC0,4144
 prefect/agent.py,sha256=dPvG1jDGD5HSH7aM2utwtk6RaJ9qg13XjkA0lAIgQmY,287
 prefect/artifacts.py,sha256=ZdMLJeJGK82hibtRzbsVa-g95dMa0D2UP1LiESoXmf4,23951
@@ -14,7 +14,7 @@ prefect/exceptions.py,sha256=S7H01rpzGz-2Z6NcZVPdwy-3cZnvx51XCBRp7Nsp5xI,12599
 prefect/filesystems.py,sha256=O3zvpFWTDRyrpJ0UJXSsRdLjy2dkch2_7ZBc9ncD8cQ,26884
 prefect/flow_engine.py,sha256=v4-olTdSucuxYpfbkvjeUalODFfG0t96nQ0qkDn8FUg,87580
 prefect/flow_runs.py,sha256=0LiTnz9B24kD5wGc-EiKmlg8GJb90ua6kMHv3ZH-YfA,29595
-prefect/flows.py,sha256=74dswq5Tvaf0sNRFwq-g0WEUE8xaBi9ra4GpxVb8KJY,146276
+prefect/flows.py,sha256=zrLb-BYwlDznvKrVRGqbUgRNOKUvMuFA1o6ewWbkHzw,146598
 prefect/futures.py,sha256=XOxNAjlW-hMfSRZvm3ecCNdpKIUzM283832Uq92h8pI,31276
 prefect/main.py,sha256=di4yjyllPls3P421pBPhDlkmpSn2KvJZVM9sIQo8qzo,2648
 prefect/plugins.py,sha256=ZeTd95NHo8IKCTena5g7buaHGG9Bb2NDd_t-ljbzLFg,2558
@@ -193,7 +193,7 @@ prefect/client/schemas/events.py,sha256=yTbuFSM1AgAs66mS-ex-FqQqPMOXB6X5FUsL11sB
 prefect/client/schemas/filters.py,sha256=g_YFDQUfNpiZv0sPlnlzPeUXpFHHuP2AiHIi52syoTY,38687
 prefect/client/schemas/objects.py,sha256=iqxt5IRIRrcwNnYha90G_1j74tBzkrhbTAYmohaSHuc,61024
 prefect/client/schemas/responses.py,sha256=8Ibsy3s3K2jm2gm15N-DiMh5_bOVUdRPSagkUNTBv84,19297
-prefect/client/schemas/schedules.py,sha256=wwi48rYK7Id4sR8V4PfdB-2O_lhIl2R6KNGS634fEOI,14856
+prefect/client/schemas/schedules.py,sha256=dhynyu2ua9M0Bd8MhVuDssjXNOxfdVHXOgxx2lLjZtg,15526
 prefect/client/schemas/sorting.py,sha256=L-2Mx-igZPtsUoRUguTcG3nIEstMEMPD97NwPM2Ox5s,2579
 prefect/client/schemas/worker_channel.py,sha256=RVta43ctg5NmIP-4vpwMv602vIAn-lSMp6RwJ8CPTsw,19594
 prefect/client/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -217,7 +217,7 @@ prefect/concurrency/v1/services.py,sha256=ppVCllzb2qeKc-xntobFu45dEh3J-ZTtLDPuHr
 prefect/concurrency/v1/sync.py,sha256=N_CHNkbV_eNQvDsJoJaehQo8H68MFlX6B1ObDZuYlTM,2112
 prefect/deployments/AGENTS.md,sha256=jiYmO4WaKYNvvUXojVaNgQJcuMrz-ik-XemVP19LdjY,3979
 prefect/deployments/__init__.py,sha256=_j4kxNjtKNSsI3C8d0skqpu3fR_rnLslw774b1iflzM,1094
-prefect/deployments/base.py,sha256=RBvEKwNyLbmLTWhZZwr6-MNQMZ8egG6oPILebdFpg4g,12132
+prefect/deployments/base.py,sha256=ue8T0AqVHU0un2efsrNatJIkHEGc-1SIqF2PVg7F1kQ,13107
 prefect/deployments/deployments.py,sha256=K3Rgnpjxo_T8I8LMwlq24OKqZiZBTE8-YnPg-YGUStM,171
 prefect/deployments/flow_runs.py,sha256=RYnAfQb95KczY2Du6DesRn3HwVpw2iAyLAzCKxBGoW0,17065
 prefect/deployments/runner.py,sha256=nane16WsAQ9e1OOozRWiUtIZAEY2nuYK-XIdw32DOWc,77543
@@ -329,7 +329,7 @@ prefect/server/api/templates.py,sha256=EW5aJOuvSXBeShd5VIygI1f9W0uTUpGb32ADrL9LG
 prefect/server/api/validation.py,sha256=DPofXjLFejs_qusUQgzRkG89X2EFoviAy9J08pnNvyM,14543
 prefect/server/api/variables.py,sha256=8Ursuf20R5zXUS015ZexCH72K7R6Yv76ehkr_l3Xt0k,6186
 prefect/server/api/work_queues.py,sha256=wEb_Hx1MlTrg5juOguk5nvGKwLmTGSIHEUyt_-2GJiE,11957
-prefect/server/api/workers.py,sha256=NS6aAZn0EPjbJDZJg6-t4vjFytdQGBO64sAi6NWeS08,42909
+prefect/server/api/workers.py,sha256=Z_K6h1uIuJ7IwRGGL0brpcZbVsxbMa1PFRdV8okyYhY,45063
 prefect/server/api/collections_data/views/aggregate-worker-metadata.json,sha256=otKGMKJUh_ySkQyNBFCe84E6VRbuR-Z7_676D21YKsw,81525
 prefect/server/api/static/prefect-logo-mark-gradient.png,sha256=ylRjJkI_JHCw8VbQasNnXQHwZW-sH-IQiUGSD3aWP1E,73430
 prefect/server/api/ui/__init__.py,sha256=TCXO4ZUZCqCbm2QoNvWNTErkzWiX2nSACuO-0Tiomvg,93
@@ -441,7 +441,7 @@ prefect/workers/_worker_channel/_protocol.py,sha256=GpCNh1o3qmmqHA_UOOTge1QVC6IR
 prefect/workers/_worker_channel/_state.py,sha256=eQTFZtAVDZH1vVWps3SdeY6aW3qu2wx1UKYQXK3AyuE,5369
 prefect/workers/_worker_channel/_sync.py,sha256=G5G8_UaQYbeLebi5Mb1Z_KgGfXfyjXo5uT9la5_zwqY,14984
 prefect/workers/_worker_channel/_transport.py,sha256=_8aWX16tdbZcpqBg4HCX_vCzl2FX47jsYPKMPLAANRA,9181
-prefect_client-3.7.4.dev4.dist-info/METADATA,sha256=EYFFmUZzlJxZSMymnKmFW8N7gLOFm1BsIQbCF2aPx1Y,7527
-prefect_client-3.7.4.dev4.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-prefect_client-3.7.4.dev4.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
-prefect_client-3.7.4.dev4.dist-info/RECORD,,
+prefect_client-3.7.5.dev2.dist-info/METADATA,sha256=1xTQB5z_FyMNprGwjWQlf7TqNgU3mhzkqc3haWiEGs0,7527
+prefect_client-3.7.5.dev2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+prefect_client-3.7.5.dev2.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
+prefect_client-3.7.5.dev2.dist-info/RECORD,,