prefect-client 3.8.6.dev4__tar.gz → 3.8.7__tar.gz

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: prefect-client
-Version: 3.8.6.dev4
+Version: 3.8.7
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
@@ -49,7 +49,7 @@ Requires-Dist: pydantic-core<3.0.0,>=2.12.0
 Requires-Dist: pydantic-extra-types<3.0.0,>=2.8.2
 Requires-Dist: pydantic-settings<3.0.0,>=2.9.1
 Requires-Dist: python-dateutil<3.0.0,>=2.8.2
-Requires-Dist: python-slugify<9.0,>=5.0
+Requires-Dist: python-slugify<9.1,>=9
 Requires-Dist: pytz<2027,>=2021.1
 Requires-Dist: pyyaml<7.0.0,>=5.4.1
 Requires-Dist: rfc3339-validator<0.2.0,>=0.1.4

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/pyproject.toml

@@ -53,7 +53,7 @@ dependencies = [
     "pydantic_extra_types>=2.8.2,<3.0.0",
     "pydantic_settings>=2.9.1,<3.0.0",
     "python-dateutil>=2.8.2,<3.0.0",
-    "python-slugify>=5.0,<9.0",
+    "python-slugify>=9,<9.1",
     "pytz>=2021.1,<2027",
     "pyyaml>=5.4.1,<7.0.0",
     "rfc3339-validator>=0.1.4,<0.2.0",

prefect_client-3.8.7/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.8.7"
+__build_date__ = "2026-09-26 23:42:21.142838+00:00"
+__git_commit__ = "4f52bc6d0dd8186ca63bdd0552c5e21f05b483b2"
+__dirty__ = False

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/_internal/concurrency/cancellation.py

@@ -410,6 +410,11 @@ class WatcherThreadCancelScope(CancelScope):
     def __enter__(self):
         super().__enter__()
         self._event = threading.Event()
+        # Serializes exception delivery with the supervised thread's exit, so the
+        # exception is never injected into a thread that has already left the scope
+        # and is running arbitrary code.
+        self._exit_lock = threading.Lock()
+        self._exited = False
         self._enforcer_thread = None
         self._supervised_thread = threading.current_thread()
 
@@ -428,7 +433,9 @@ class WatcherThreadCancelScope(CancelScope):
         # this frame, so the event must be set from a `finally` to guarantee the
         # enforcer is always released.
         try:
-            retval = super().__exit__(*_)
+            with self._exit_lock:
+                self._exited = True
+                retval = super().__exit__(*_)
         finally:
             self._event.set()
             if self._enforcer_thread:
@@ -448,7 +455,13 @@ class WatcherThreadCancelScope(CancelScope):
                 self,
                 self._supervised_thread,
             )
-            with _get_thread_shield(self._supervised_thread):
+            # The shield is acquired before the exit lock: the supervised thread may
+            # exit the scope while shielded and must not wait on a lock held by a
+            # thread that is waiting for that shield.
+            with _get_thread_shield(self._supervised_thread), self._exit_lock:
+                if self._exited:
+                    logger.debug("%r already exited; not sending exception", self)
+                    return
                 try:
                     _send_exception_to_thread(self._supervised_thread, CancelledError)
                 except ValueError:
@@ -462,8 +475,7 @@ class WatcherThreadCancelScope(CancelScope):
         if not self._event.wait(self.timeout):
             logger.debug("%r enforcer detected timeout!", self)
             if self.cancel(throw=False):
-                with _get_thread_shield(self._supervised_thread):
-                    self._send_cancelled_error()
+                self._send_cancelled_error()
 
     def cancel(self, throw: bool = True):
         if not super().cancel():

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/bundles/_zip_extractor.py

@@ -113,6 +113,15 @@ class ZipExtractor:
             # Extract all
             zf.extractall(target_dir)
 
+            # `extractall` drops the archived permission bits, so executable
+            # files would arrive without their executable mode.
+            for info in zf.infolist():
+                if info.is_dir():
+                    continue
+                mode = info.external_attr >> 16 & 0o7777
+                if mode:
+                    (target_dir / info.filename).chmod(mode)
+
             # Build extracted paths list
             for member in members:
                 if not member.endswith("/"):  # Skip directories

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/bundles/execute.py

@@ -1,7 +1,9 @@
 import json
 import sys
+from pathlib import Path
 from typing import Any
 
+from prefect.bundles._zip_extractor import ZipExtractor
 from prefect.utilities.asyncutils import run_coro_as_sync
 
 
@@ -9,12 +11,30 @@ def execute_bundle_from_file(key: str) -> None:
     """
     Loads a bundle from a file and executes it.
 
+    If the bundle declares a sidecar zip of included files, the zip is read from
+    the directory of the bundle file and its contents are extracted into the
+    working directory before the flow runs.
+
     Args:
         key: The key of the bundle to execute.
     """
-    with open(key, "r") as f:
+    bundle_path = Path(key)
+    with open(bundle_path, "r") as f:
         bundle = json.load(f)
 
+    files_key: str | None = bundle.get("files_key")
+    if files_key:
+        sidecar_path = bundle_path.parent / files_key
+        if not sidecar_path.exists():
+            raise RuntimeError(
+                f"Bundle declares included files at {files_key!r}, but no archive"
+                f" was found at {sidecar_path}."
+            )
+        try:
+            ZipExtractor(sidecar_path).extract()
+        except Exception as e:
+            raise RuntimeError(f"Failed to extract included files: {e}") from e
+
     run_coro_as_sync(execute_bundle(bundle))
 
 

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/client/attribution.py

@@ -67,4 +67,10 @@ def get_attribution_headers() -> dict[str, str]:
         if deployment_name := os.environ.get("PREFECT__DEPLOYMENT_NAME"):
             headers["X-Prefect-Deployment-Name"] = deployment_name
 
-    return headers
+    # HTTP header values cannot start or end with spaces or tabs. Normalize only
+    # the attribution values, leaving the actual flow/deployment/worker names intact.
+    return {
+        name: stripped
+        for name, value in headers.items()
+        if (stripped := value.strip(" \t"))
+    }

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/flow_engine.py

@@ -930,9 +930,10 @@ class FlowRunEngine(BaseFlowRunEngine[P, R]):
         run, if appropriate.
 
         If the parent task run is in a final state, we return the existing
-        subflow run to avoid re-execution (unless the parent is being rerun
-        and the subflow did not complete, in which case a fresh run is
-        desired).
+        subflow run unless the parent is being rerun and the subflow either
+        did not complete or has no persisted result. In those cases a fresh
+        run gives the subflow its full retry budget while preserving the
+        previous run's history.
 
         If the parent task run is in a non-final state (e.g. still Running
         after a process restart), we also look for an existing subflow run
@@ -972,8 +973,18 @@ class FlowRunEngine(BaseFlowRunEngine[P, R]):
         )
         if flow_runs:
             loaded_flow_run = flow_runs[0]
-            # When the parent task run is final the subflow has already
-            # finished; cache the result so the engine skips re-execution.
+            if (
+                rerunning
+                and parent_task_run.state.is_completed()
+                and loaded_flow_run.state is not None
+                and loaded_flow_run.state.is_completed()
+                and loaded_flow_run.state.data is None
+            ):
+                # Without a persisted result the child must execute again. A
+                # fresh run preserves its history and restores its retry budget.
+                return None
+
+            # Keep the previous state available when reusing a finished run.
             if parent_task_run.state.is_final():
                 self._return_value = loaded_flow_run.state
             return loaded_flow_run
@@ -1638,9 +1649,10 @@ class AsyncFlowRunEngine(BaseFlowRunEngine[P, R]):
         run, if appropriate.
 
         If the parent task run is in a final state, we return the existing
-        subflow run to avoid re-execution (unless the parent is being rerun
-        and the subflow did not complete, in which case a fresh run is
-        desired).
+        subflow run unless the parent is being rerun and the subflow either
+        did not complete or has no persisted result. In those cases a fresh
+        run gives the subflow its full retry budget while preserving the
+        previous run's history.
 
         If the parent task run is in a non-final state (e.g. still Running
         after a process restart), we also look for an existing subflow run
@@ -1680,8 +1692,18 @@ class AsyncFlowRunEngine(BaseFlowRunEngine[P, R]):
         )
         if flow_runs:
             loaded_flow_run = flow_runs[0]
-            # When the parent task run is final the subflow has already
-            # finished; cache the result so the engine skips re-execution.
+            if (
+                rerunning
+                and parent_task_run.state.is_completed()
+                and loaded_flow_run.state is not None
+                and loaded_flow_run.state.is_completed()
+                and loaded_flow_run.state.data is None
+            ):
+                # Without a persisted result the child must execute again. A
+                # fresh run preserves its history and restores its retry budget.
+                return None
+
+            # Keep the previous state available when reusing a finished run.
             if parent_task_run.state.is_final():
                 self._return_value = loaded_flow_run.state
             return loaded_flow_run

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/results.py

@@ -486,15 +486,21 @@ class ResultStore(BaseModel):
         Returns:
             ResultRecord: The result record.
         """
-        if metadata.storage_block_id is None:
-            storage_block = None
-        else:
-            storage_block = await aresolve_result_storage(metadata.storage_block_id)
-        store = cls(result_storage=storage_block, serializer=metadata.serializer)
         if metadata.storage_key is None:
             raise ValueError(
                 "storage_key is required to hydrate a result record from metadata"
             )
+        if metadata.storage_block_id is not None:
+            storage_block = await aresolve_result_storage(metadata.storage_block_id)
+        elif Path(metadata.storage_key).is_absolute():
+            # Results written to an unsaved local filesystem record an absolute path
+            # as the storage key, which may live outside the default local storage.
+            storage_block = LocalFileSystem(
+                basepath=str(Path(metadata.storage_key).parent)
+            )
+        else:
+            storage_block = None
+        store = cls(result_storage=storage_block, serializer=metadata.serializer)
         result = await store.aread(metadata.storage_key)
         return result
 

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/server/api/collections_data/views/aggregate-worker-metadata.json

@@ -760,6 +760,7 @@
           "auto_remove": "{{ auto_remove }}",
           "volumes": "{{ volumes }}",
           "stream_output": "{{ stream_output }}",
+          "container_wait_timeout": "{{ container_wait_timeout }}",
           "mem_limit": "{{ mem_limit }}",
           "memswap_limit": "{{ memswap_limit }}",
           "privileged": "{{ privileged }}"
@@ -856,6 +857,12 @@
               "default": true,
               "type": "boolean"
             },
+            "container_wait_timeout": {
+              "title": "Container Wait Timeout",
+              "description": "Maximum number of seconds the worker waits for a created container to exit. If the container has not exited within this time, the worker stops watching it; the container itself is not stopped. If not set, the worker waits indefinitely.",
+              "exclusiveMinimum": 0,
+              "type": "integer"
+            },
             "mem_limit": {
               "title": "Memory Limit",
               "description": "Memory limit of created containers. Accepts a value with a unit identifier (e.g. 100000b, 1000k, 128m, 1g.) If a value is given without a unit, bytes are assumed.",

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/settings/models/root.py

@@ -279,6 +279,19 @@ class Settings(PrefectBaseSettings):
         to use default_factory. The remaining items here require access to the full Settings instance
         or have complex interdependencies that will be migrated in future PRs.
         """
+        if "profiles_path" not in self.model_fields_set:
+            self.profiles_path = self.home / "profiles.toml"
+            self.__pydantic_fields_set__.remove("profiles_path")
+        if "local_storage_path" not in self.results.model_fields_set:
+            self.results.local_storage_path = self.home / "storage"
+            self.results.__pydantic_fields_set__.remove("local_storage_path")
+        if "config_path" not in self.logging.model_fields_set:
+            self.logging.config_path = self.home / "logging.yml"
+            self.logging.__pydantic_fields_set__.remove("config_path")
+        if "memo_store_path" not in self.server.model_fields_set:
+            self.server.memo_store_path = self.home / "memo_store.toml"
+            self.server.__pydantic_fields_set__.remove("memo_store_path")
+
         if self.ui_url is None:
             self.ui_url = default_ui_url(self)
             self.__pydantic_fields_set__.remove("ui_url")

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/settings/models/server/docket.py

@@ -22,5 +22,12 @@ class ServerDocketSettings(PrefectBaseSettings):
 
     url: str = Field(
         default="memory://",
-        description="The URL of the Redis server to use for Docket.",
+        description=(
+            "The URL of the Redis server to use for Docket. Supports the "
+            "memory:// (single-server only), redis://, rediss://, "
+            "redis+sentinel:// and rediss+sentinel:// schemes; the Sentinel "
+            "schemes discover the current master through the listed Sentinel "
+            "daemons and follow failover automatically (requires "
+            "pydocket>=0.23.1)."
+        ),
     )

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/task_engine.py

@@ -721,7 +721,7 @@ class SyncTaskRunEngine(BaseTaskRunEngine[P, R]):
                 exc,
                 message="Task run encountered an exception",
                 result_store=get_result_store(),
-                write_result=True,
+                write_result=should_persist_result(),
             )
             self.set_state(state)
             self._raised = exc
@@ -1348,6 +1348,7 @@ class AsyncTaskRunEngine(BaseTaskRunEngine[P, R]):
                 exc,
                 message="Task run encountered an exception",
                 result_store=get_result_store(),
+                write_result=should_persist_result(),
             )
             await self.set_state(state)
             self._raised = exc

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/utilities/math.py

@@ -48,10 +48,15 @@ def clamped_poisson_interval(
 
     The upper bound for this random variate is: average_interval * (1 + clamping_factor).
     A lower bound is picked so that the average interval remains approximately fixed.
+
+    An `average_interval` of zero (or less) yields an interval of `0.0`.
     """
     if clamping_factor <= 0:
         raise ValueError("`clamping_factor` must be >= 0.")
 
+    if average_interval <= 0:
+        return 0.0
+
     upper_clamp_multiple = 1 + clamping_factor
     upper_bound = average_interval * upper_clamp_multiple
     lower_bound = max(0, average_interval * lower_clamp_multiple(upper_clamp_multiple))

{prefect_client-3.8.6.dev4 → prefect_client-3.8.7}/src/prefect/utilities/templating/__init__.py

@@ -83,7 +83,7 @@ def find_placeholders(template: T) -> set[Placeholder]:
         A set of all placeholders in the template
     """
     seed: set[Placeholder] = set()
-    if isinstance(template, (int, float, bool)):
+    if template is None or isinstance(template, (int, float, bool)):
         return seed
     if isinstance(template, str):
         result = PLACEHOLDER_CAPTURE_REGEX.findall(template)

prefect_client-3.8.6.dev4/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.8.6.dev4"
-__build_date__ = "2026-09-11 08:19:45.490504+00:00"
-__git_commit__ = "d82220b5887fe65f6a469f4cb51124a01d02741f"
-__dirty__ = False