prefect 3.6.25.dev5__tar.gz → 3.6.25.dev6__tar.gz

{prefect-3.6.25.dev5 → prefect-3.6.25.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect
-Version: 3.6.25.dev5
+Version: 3.6.25.dev6
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io

prefect-3.6.25.dev6/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.6.25.dev6"
+__build_date__ = "2026-04-02 08:28:49.421125+00:00"
+__git_commit__ = "86c2ab9feb32c75def7a4e01f8b2fac8afea12a9"
+__dirty__ = False

{prefect-3.6.25.dev5 → prefect-3.6.25.dev6}/src/prefect/_internal/installation.py

@@ -2,6 +2,9 @@ import importlib
 import subprocess
 import sys
 
+from packaging.version import Version
+
+import prefect
 import prefect.utilities.processutils
 
 
@@ -11,7 +14,9 @@ def install_packages(
     """
     Install packages using uv if available, otherwise use pip.
     """
-    base_command = ["pip", "install", *packages]
+    version = Version(prefect.__version__)
+    constraint_args = [f"prefect=={prefect.__version__}"] if not version.local else []
+    base_command = ["pip", "install", *constraint_args, *packages]
     if upgrade:
         base_command.append("--upgrade")
     if stream_output:
@@ -44,7 +49,9 @@ async def ainstall_packages(
     """
     Install packages using uv if available, otherwise use pip.
     """
-    base_command = ["pip", "install", *packages]
+    version = Version(prefect.__version__)
+    constraint_args = [f"prefect=={prefect.__version__}"] if not version.local else []
+    base_command = ["pip", "install", *constraint_args, *packages]
     if upgrade:
         base_command.append("--upgrade")
     try:

{prefect-3.6.25.dev5 → prefect-3.6.25.dev6}/src/prefect/context.py

@@ -37,6 +37,7 @@ from prefect.client.schemas import FlowRun, TaskRun
 from prefect.client.schemas.objects import RunType
 from prefect.events.worker import EventsWorker
 from prefect.exceptions import MissingContextError
+from prefect.logging.configuration import ensure_logging_setup
 from prefect.results import (
     ResultStore,
     get_default_persist_setting,
@@ -163,6 +164,8 @@ def hydrated_context(
 
     with ExitStack() as stack:
         if serialized_context:
+            ensure_logging_setup()
+
             # Set up settings context
             if settings_context := serialized_context.get("settings_context"):
                 stack.enter_context(SettingsContext(**settings_context))

{prefect-3.6.25.dev5 → prefect-3.6.25.dev6}/src/prefect/deployments/AGENTS.md

@@ -36,5 +36,5 @@ For module path entrypoints, the storage destination is temporarily prepended to
 - **Flow source outside cwd**: `RunnerDeployment.from_flow()` computes the entrypoint path with `Path.relative_to(cwd)`. When the flow file is outside the working directory (e.g., on a different drive on Windows, or an absolute path not under cwd), `relative_to()` raises `ValueError` — the code falls back to `os.path.relpath()`, which may produce paths containing `..` components. Infrastructure that expects clean relative paths (no `..`) must handle this case.
 - **Windows shell mode**: `run_shell_script` always uses `asyncio.create_subprocess_shell` on Windows (`sys.platform == "win32"`), regardless of the `shell` parameter. This ensures cmd.exe built-ins (`echo`, `dir`, `set`, etc.) work. On non-Windows, `shell=False` (default) uses `create_subprocess_exec` with `shlex.split`.
 - **Step ID namespace**: `id` and `requires` are reserved keywords — do not use them as step output keys.
-- **Step import side effects**: steps are imported dynamically; packages listed in `requires` are installed into the current environment at execution time.
+- **Step import side effects**: steps are imported dynamically; packages listed in `requires` are installed into the current environment at execution time. The current prefect version is automatically pinned as a constraint during installation to prevent the running prefect from being overwritten or downgraded. This pin is skipped for local/dev builds (i.e., when `packaging.version.Version(prefect.__version__).local` is truthy).
 - **String `image` argument suppresses build/push output.** When `deploy()` / `adeploy()` receives `image` as a plain string, it constructs `DockerImage(stream_progress_to=None)`, silencing all build and push progress. `DockerImage` itself defaults to `sys.stdout`, so users who pass a string get no output. To see build/push progress, pass a `DockerImage` object explicitly: `DockerImage("registry/image:tag", stream_progress_to=sys.stdout)`.

{prefect-3.6.25.dev5 → prefect-3.6.25.dev6}/src/prefect/logging/AGENTS.md

@@ -19,6 +19,7 @@ Public API (exported from `__init__.py`):
 Internal factories (not exported, but used by engines/workers):
 - `flow_run_logger()` / `task_run_logger()` — direct logger factories with run metadata
 - `get_worker_logger()` — adds `backend_id` if available (Cloud only)
+- `ensure_logging_setup()` — idempotent guard: calls `setup_logging()` only if `PROCESS_LOGGING_CONFIG` is not yet set. Use this (not `setup_logging()` directly) in remote execution environments (Dask/Ray workers, `hydrated_context`) where the normal SDK import path may not have triggered logging configuration.
 
 **APILogHandler drops logs without a `flow_run_id`.** Logs emitted outside a run context raise `MissingContextError`, which is caught and converted to a warning or silently dropped depending on `PREFECT_LOGGING_TO_API_WHEN_MISSING_FLOW`.
 

{prefect-3.6.25.dev5 → prefect-3.6.25.dev6}/src/prefect/logging/configuration.py

@@ -65,6 +65,19 @@ def load_logging_config(path: Path) -> dict[str, Any]:
     return flatdict_to_dict(flat_config)
 
 
+def ensure_logging_setup() -> None:
+    """
+    Ensure Prefect logging is configured in this process, calling
+    `setup_logging` only if it has not already been called.
+
+    Use this in remote execution environments (e.g. Dask/Ray workers) where
+    the normal SDK entry point (`import prefect`) may not have triggered
+    logging configuration.
+    """
+    if not PROCESS_LOGGING_CONFIG:
+        setup_logging()
+
+
 def setup_logging(incremental: bool | None = None) -> dict[str, Any]:
     """
     Sets up logging.

prefect-3.6.25.dev5/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.6.25.dev5"
-__build_date__ = "2026-04-01 08:35:18.994448+00:00"
-__git_commit__ = "69775fbacada216f639d444d25535de62ff8f651"
-__dirty__ = False