prefect-client 3.9.1.dev6__tar.gz → 3.9.1.dev8__tar.gz

{prefect_client-3.9.1.dev6 → prefect_client-3.9.1.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: prefect-client
-Version: 3.9.1.dev6
+Version: 3.9.1.dev8
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://www.prefect.io/docs
@@ -163,7 +163,7 @@ describing the functionality you are interested in using and we will do our best
 ## Next steps
 
 There's lots more you can do to orchestrate and observe your workflows with Prefect!
-Start with our [friendly tutorial](https://www.prefect.io/docs/tutorials) or explore the [core concepts of Prefect workflows](https://www.prefect.io/docs/concepts/).
+Start with our [friendly tutorial](https://www.prefect.io/docs/v3/get-started/quickstart) or explore the [core concepts of Prefect workflows](https://www.prefect.io/docs/concepts/).
 
 ## Join the community
 
@@ -173,6 +173,6 @@ All community forums, including code contributions, issue discussions, and Slack
 
 ## Contribute
 
-See our [documentation on contributing to Prefect](https://www.prefect.io/docs/contributing/overview/).
+See our [documentation on contributing to Prefect](https://www.prefect.io/docs/contribute).
 
 Thanks for being part of the mission to build a new kind of workflow system and, of course, **happy engineering!**

{prefect_client-3.9.1.dev6 → prefect_client-3.9.1.dev8}/README.md

@@ -94,7 +94,7 @@ describing the functionality you are interested in using and we will do our best
 ## Next steps
 
 There's lots more you can do to orchestrate and observe your workflows with Prefect!
-Start with our [friendly tutorial](https://www.prefect.io/docs/tutorials) or explore the [core concepts of Prefect workflows](https://www.prefect.io/docs/concepts/).
+Start with our [friendly tutorial](https://www.prefect.io/docs/v3/get-started/quickstart) or explore the [core concepts of Prefect workflows](https://www.prefect.io/docs/concepts/).
 
 ## Join the community
 
@@ -104,6 +104,6 @@ All community forums, including code contributions, issue discussions, and Slack
 
 ## Contribute
 
-See our [documentation on contributing to Prefect](https://www.prefect.io/docs/contributing/overview/).
+See our [documentation on contributing to Prefect](https://www.prefect.io/docs/contribute).
 
 Thanks for being part of the mission to build a new kind of workflow system and, of course, **happy engineering!**

prefect_client-3.9.1.dev8/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.9.1.dev8"
+__build_date__ = "2026-10-30 08:14:22.561666+00:00"
+__git_commit__ = "599697348089e83823cb4ef63ff219c53eefec22"
+__dirty__ = False

{prefect_client-3.9.1.dev6 → prefect_client-3.9.1.dev8}/src/prefect/deployments/runner.py

@@ -1671,14 +1671,14 @@ async def adeploy(
                 " or specify a remote storage location for the flow with `.from_source`."
                 " If you are attempting to deploy a flow to a local process work pool,"
                 " consider using `flow.serve` instead. See the documentation for more"
-                " information: https://www.prefect.io/docs/latest/how-to-guides/deployments/run-flows-in-local-processes"
+                " information: https://www.prefect.io/docs/v3/how-to-guides/deployment_infra/run-flows-in-local-processes"
             )
         elif work_pool.type == "process" and not ignore_warnings:
             console.print(
                 "Looks like you're deploying to a process work pool. If you're creating a"
                 " deployment for local development, calling `.serve` on your flow is a great"
                 " way to get started. See the documentation for more information:"
-                " https://www.prefect.io/docs/latest/how-to-guides/deployments/run-flows-in-local-processes "
+                " https://www.prefect.io/docs/v3/how-to-guides/deployment_infra/run-flows-in-local-processes "
                 " Set `ignore_warnings=True` to suppress this message.",
                 style="yellow",
             )
@@ -1912,14 +1912,14 @@ def deploy(
                 " or specify a remote storage location for the flow with `.from_source`."
                 " If you are attempting to deploy a flow to a local process work pool,"
                 " consider using `flow.serve` instead. See the documentation for more"
-                " information: https://www.prefect.io/docs/latest/how-to-guides/deployments/run-flows-in-local-processes"
+                " information: https://www.prefect.io/docs/v3/how-to-guides/deployment_infra/run-flows-in-local-processes"
             )
         elif work_pool.type == "process" and not ignore_warnings:
             console.print(
                 "Looks like you're deploying to a process work pool. If you're creating a"
                 " deployment for local development, calling `.serve` on your flow is a great"
                 " way to get started. See the documentation for more information:"
-                " https://www.prefect.io/docs/latest/how-to-guides/deployments/run-flows-in-local-processes "
+                " https://www.prefect.io/docs/v3/how-to-guides/deployment_infra/run-flows-in-local-processes "
                 " Set `ignore_warnings=True` to suppress this message.",
                 style="yellow",
             )

{prefect_client-3.9.1.dev6 → prefect_client-3.9.1.dev8}/src/prefect/runner/_flow_run_executor.py

@@ -51,10 +51,16 @@ class ProcessStarter(Protocol):
 
 @dataclass(frozen=True)
 class FlowRunExecutionResult:
-    """Process handle plus the infrastructure status for a completed attempt."""
+    """Process handle plus the infrastructure status for a completed attempt.
+
+    `crash_unreported` is `True` when the process exited non-zero or failed
+    after starting, and the runner could not record a final state for the flow
+    run in its place.
+    """
 
     handle: ProcessHandle
     status_code: int | None
+    crash_unreported: bool = False
 
 
 class FlowRunExecutor:
@@ -124,6 +130,7 @@ class FlowRunExecutor:
         """
         handle: ProcessHandle | None = None
         attempt_conclusion: AttemptConclusion | None = None
+        process_error: Exception | None = None
         try:
             # Step 1a: already-cancelling precheck (runs regardless of propose_submitting)
             if self._flow_run.state and self._flow_run.state.is_cancelling():
@@ -165,16 +172,26 @@ class FlowRunExecutor:
             handle = await self._start_process(task_status)
 
         except Exception as exc:
+            # A failure after the process exited (e.g. its output stream broke)
+            # still leaves an exit to account for. A live process stays
+            # registered so the process manager can still stop it.
+            started_handle = self._process_manager.get(self._flow_run.id)
+            if started_handle is None or started_handle.returncode is None:
+                self._logger.exception(
+                    "Flow run '%s' could not start: %s",
+                    self._flow_run.id,
+                    exc,
+                )
+                await self._state_proposer.propose_crashed(
+                    self._flow_run,
+                    message=f"Flow run could not start: {exc}",
+                )
+                return
             self._logger.exception(
-                "Flow run '%s' could not start: %s",
-                self._flow_run.id,
-                exc,
-            )
-            await self._state_proposer.propose_crashed(
-                self._flow_run,
-                message=f"Flow run could not start: {exc}",
+                "Flow run '%s' process failed: %s", self._flow_run.id, exc
             )
-            return
+            handle = started_handle
+            process_error = exc
         finally:
             # Step 6: snapshot terminal evidence before process cleanup unregisters
             # the attempt control session, then remove the process handle.
@@ -199,14 +216,23 @@ class FlowRunExecutor:
                     info.resolution,
                     extra={"flow_run_id": self._flow_run.id},
                 )
-            crashed_state = await self._state_proposer.propose_crashed(
-                self._flow_run, message=msg
-            )
-            # Step 8: run crashed hooks
-            if crashed_state is not None:
-                await self._hook_runner.run_crashed_hooks(self._flow_run, crashed_state)
+        elif process_error is not None:
+            msg = f"Flow run process failed: {process_error}"
+        else:
+            return FlowRunExecutionResult(handle=handle, status_code=exit_code)
 
-        return FlowRunExecutionResult(handle=handle, status_code=exit_code)
+        crashed_state = await self._state_proposer.propose_crashed(
+            self._flow_run, message=msg
+        )
+        # Step 8: run crashed hooks
+        if crashed_state is not None:
+            await self._hook_runner.run_crashed_hooks(self._flow_run, crashed_state)
+
+        return FlowRunExecutionResult(
+            handle=handle,
+            status_code=exit_code,
+            crash_unreported=crashed_state is None or not crashed_state.is_final(),
+        )
 
     async def _start_process(
         self,

prefect_client-3.9.1.dev6/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.9.1.dev6"
-__build_date__ = "2026-10-28 08:14:48.771478+00:00"
-__git_commit__ = "bdc282844dd7ad54b0734dcc48d0a597881591c0"
-__dirty__ = False