prefect-client 3.7.2.dev5__tar.gz → 3.7.3__tar.gz

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.7.2.dev5
+Version: 3.7.3
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
@@ -47,7 +47,7 @@ Requires-Dist: prometheus-client>=0.20.0
 Requires-Dist: pydantic!=2.11.0,!=2.11.1,!=2.11.2,!=2.11.3,!=2.11.4,<3.0.0,>=2.10.1
 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!=2.9.0,<3.0.0,>2.2.1
+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: pytz<2027,>=2021.1
@@ -57,6 +57,7 @@ Requires-Dist: rich<16.0,>=11.0
 Requires-Dist: ruamel-yaml-clib>=0.2.8; platform_python_implementation == 'CPython'
 Requires-Dist: ruamel-yaml>=0.17.0
 Requires-Dist: sniffio<2.0.0,>=1.3.0
+Requires-Dist: starlette>=1.0.1
 Requires-Dist: toml>=0.10.0
 Requires-Dist: typing-extensions<5.0.0,>=4.10.0
 Requires-Dist: uvicorn!=0.29.0,>=0.14.0

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/pyproject.toml

@@ -51,7 +51,7 @@ dependencies = [
     "pydantic>=2.10.1,<3.0.0,!=2.11.0,!=2.11.1,!=2.11.2,!=2.11.3,!=2.11.4",
     "pydantic_core>=2.12.0,<3.0.0",
     "pydantic_extra_types>=2.8.2,<3.0.0",
-    "pydantic_settings>2.2.1,<3.0.0,!=2.9.0",
+    "pydantic_settings>=2.9.1,<3.0.0",
     "python-dateutil>=2.8.2,<3.0.0",
     "python-slugify>=5.0,<9.0",
     "pytz>=2021.1,<2027",
@@ -61,6 +61,7 @@ dependencies = [
     "ruamel.yaml>=0.17.0",
     "ruamel.yaml.clib>=0.2.8; platform_python_implementation == 'CPython'",
     "sniffio>=1.3.0,<2.0.0",
+    "starlette>=1.0.1",
     "toml>=0.10.0",
     "typing_extensions>=4.10.0,<5.0.0",
     "uvicorn>=0.14.0,!=0.29.0",

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/AGENTS.md

@@ -32,6 +32,7 @@ There is no formal public/private boundary beyond the `_` prefix convention. Mod
 - **Nested task submissions on a bounded `ThreadPoolTaskRunner` can deadlock.** When a worker task submits children and blocks on `.result()` while all `max_workers` threads are busy, the pool starves. `_warn_if_nested_submit_would_deadlock` detects this and emits a one-time warning — preserve this detection when changing pool management.
 - **Result storage resolves through three tiers, potentially making an API call.** `get_default_result_storage()` checks: (1) `PREFECT_DEFAULT_RESULT_STORAGE_BLOCK` setting, (2) server-configured default block (API call to the server's Configuration store), (3) local storage path. The API call is silently suppressed on any HTTP error. Engines use `_get_default_persist_result()` — not `should_persist_result()` — at context setup time to auto-enable persistence when a server default block is configured. Do not swap `_get_default_persist_result()` back to `should_persist_result()` in engine initialization paths; `should_persist_result()` does not consult the server default.
 - **`ResultRecordMetadata` tolerates unknown serializer types.** When loading persisted metadata, an unrecognized serializer `type` is converted to an `UnknownSerializer` placeholder rather than raising `ValidationError`. This allows inspecting result metadata when the serializer implementation is unavailable in the current environment. However, known serializer types with invalid fields still raise `ValidationError`. `UnknownSerializer.dumps()` and `UnknownSerializer.loads()` raise `RuntimeError` — the tolerance is for inspection only, not actual serialization/deserialization.
+- **`ResultRecord` must be marked persisted after every storage write.** `ResultStore` calls `mark_persisted()` on every record it writes; `to_state_create` in `states.py` consults `is_persisted` as a fallback when `should_persist_result()` returns `False` (e.g., after run context teardown). Any new sync or async persist path that omits `mark_persisted()` will silently drop state metadata for already-written results.
 - **Flow-run suspension is enforced at orchestration boundaries.** Suspension is delivered via `FlowRunSuspensionRequest` and raised with `raise_if_flow_run_suspension_requested()`. When changing engines, futures, task runners, or generator execution, check before returning control to flow user code or proposing a flow state that could leave `Suspended`; keep sync/async paths aligned and avoid per-boundary API reads.
 
 ## Logging

prefect_client-3.7.3/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.3"
+__build_date__ = "2026-06-01 15:46:19.050569+00:00"
+__git_commit__ = "594f5f358dca889516a176be58d2f359b87802e6"
+__dirty__ = False

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/_internal/result_records.py

@@ -16,6 +16,7 @@ from uuid import UUID
 from pydantic import (
     BaseModel,
     Field,
+    PrivateAttr,
     ValidationError,
     field_validator,
     model_validator,
@@ -105,6 +106,14 @@ class ResultRecord(BaseModel, Generic[R]):
 
     metadata: ResultRecordMetadata
     result: R
+    _persisted: bool = PrivateAttr(default=False)
+
+    @property
+    def is_persisted(self) -> bool:
+        return self._persisted
+
+    def mark_persisted(self) -> None:
+        self._persisted = True
 
     @property
     def expiration(self) -> DateTime | None:

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/client/orchestration/__init__.py

@@ -137,6 +137,7 @@ from prefect.settings import (
 )
 from prefect.types._datetime import now
 
+from prefect._internal.urls import strip_auth_from_url
 from prefect._internal.version_checking import (
     _api_version_check_key,
     _cache_api_version_check,
@@ -1132,7 +1133,9 @@ class PrefectClient(
         except Exception as e:
             if "Unauthorized" in str(e):
                 raise e
-            raise RuntimeError(f"Failed to reach API at {self.api_url}") from e
+            raise RuntimeError(
+                f"Failed to reach API at {strip_auth_from_url(str(self.api_url))}"
+            ) from e
 
         api_version = version.parse(api_version)
         client_version = version.parse(self.client_version())
@@ -1190,7 +1193,9 @@ class PrefectClient(
                 f"{PREFECT_API_DATABASE_CONNECTION_URL.value()}"
             )
         else:
-            self.logger.debug(f"Connecting to API at {self.api_url}")
+            self.logger.debug(
+                f"Connecting to API at {strip_auth_from_url(str(self.api_url))}"
+            )
 
         # Enter the httpx client's context
         await self._exit_stack.enter_async_context(self._client)
@@ -1519,7 +1524,9 @@ class SyncPrefectClient(
         except Exception as e:
             if "Unauthorized" in str(e):
                 raise e
-            raise RuntimeError(f"Failed to reach API at {self.api_url}") from e
+            raise RuntimeError(
+                f"Failed to reach API at {strip_auth_from_url(str(self.api_url))}"
+            ) from e
 
         api_version = version.parse(api_version)
         client_version = version.parse(self.client_version())

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/concurrency/_leases.py

@@ -143,9 +143,14 @@ def _start_lease_renewal_thread(
     stop_event = threading.Event()
     renewal_ctx = contextvars.copy_context()
 
-    def renewal_loop() -> None:
+    def _run_with_failure_handler() -> None:
+        # Runs inside renewal_ctx so the failure handler also sees the
+        # copied flow/task run contextvars; otherwise get_run_logger() in
+        # _handle_lease_renewal_failure can't find the run context and the
+        # message falls back to the plain "prefect.concurrency" logger,
+        # never reaching the run logs API.
         try:
-            renewal_ctx.run(_lease_renewal_loop, lease_id, lease_duration, stop_event)
+            _lease_renewal_loop(lease_id, lease_duration, stop_event)
         except Exception as exc:
             if not stop_event.is_set():
                 _handle_lease_renewal_failure(
@@ -156,6 +161,9 @@ def _start_lease_renewal_thread(
                     cancel_scope,
                 )
 
+    def renewal_loop() -> None:
+        renewal_ctx.run(_run_with_failure_handler)
+
     thread = threading.Thread(
         target=renewal_loop,
         daemon=True,

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/events/clients.py

@@ -31,7 +31,7 @@ from websockets.exceptions import (
 import prefect.types._datetime
 from prefect._internal.version_checking import check_server_version
 from prefect._internal.websockets import websocket_connect
-from prefect.events import Event
+from prefect.events.schemas.events import Event
 from prefect.logging import get_logger
 from prefect.settings import (
     PREFECT_API_KEY,

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/events/subscribers.py

@@ -13,9 +13,9 @@ from typing_extensions import Self
 
 from prefect.client.schemas.filters import LogFilter, LogFilterFlowRunId
 from prefect.client.schemas.objects import TERMINAL_STATES, Log, StateType
-from prefect.events import Event
 from prefect.events.clients import get_events_subscriber
 from prefect.events.filters import EventAnyResourceFilter, EventFilter
+from prefect.events.schemas.events import Event
 from prefect.logging.clients import get_logs_subscriber
 
 if TYPE_CHECKING:

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/logging/handlers.py

@@ -16,7 +16,6 @@ from rich.highlighter import Highlighter, NullHighlighter
 from rich.theme import Theme
 from typing_extensions import Self
 
-import prefect.context
 from prefect._internal.concurrency.api import create_call, from_sync
 from prefect._internal.concurrency.event_loop import get_running_loop
 from prefect._internal.concurrency.services import BatchedQueueService
@@ -161,7 +160,9 @@ class APILogHandler(logging.Handler):
         Send a log to the `APILogWorker`
         """
         try:
-            profile = prefect.context.get_settings_context()
+            from prefect.context import get_settings_context
+
+            profile = get_settings_context()
 
             if not profile.settings.logging.to_api.enabled:
                 return  # Respect the global settings toggle
@@ -214,7 +215,9 @@ class APILogHandler(logging.Handler):
 
         if not flow_run_id:
             try:
-                context = prefect.context.get_run_context()
+                from prefect.context import get_run_context
+
+                context = get_run_context()
             except MissingContextError:
                 raise MissingContextError(
                     f"Logger {record.name!r} attempted to send logs to the API without"

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/results.py

@@ -699,6 +699,8 @@ class ResultStore(BaseModel):
             except Exception:
                 return False
         else:
+            if self.result_storage is None:
+                self.result_storage = await aget_default_result_storage()
             try:
                 content = await call_explicitly_async_block_method(
                     self.result_storage, "read_path", (key,), {}
@@ -742,6 +744,8 @@ class ResultStore(BaseModel):
             except Exception:
                 return False
         else:
+            if self.result_storage is None:
+                self.result_storage = get_default_result_storage(_sync=True)
             try:
                 content = call_explicitly_sync_block_method(
                     self.result_storage, "read_path", (key,), {}
@@ -863,6 +867,7 @@ class ResultStore(BaseModel):
 
         if self.cache_result_in_memory:
             self.cache[resolved_key_path] = result_record
+        result_record.mark_persisted()
         return result_record
 
     def _read(self, key: str, holder: str) -> "ResultRecord[Any]":
@@ -932,6 +937,7 @@ class ResultStore(BaseModel):
 
         if self.cache_result_in_memory:
             self.cache[resolved_key_path] = result_record
+        result_record.mark_persisted()
         return result_record
 
     def read(
@@ -1118,6 +1124,7 @@ class ResultStore(BaseModel):
                 (result_record.metadata.storage_key,),
                 {"content": result_record.serialize()},
             )
+        result_record.mark_persisted()
         if self.cache_result_in_memory:
             self.cache[key] = result_record
 
@@ -1181,6 +1188,7 @@ class ResultStore(BaseModel):
                 (result_record.metadata.storage_key,),
                 {"content": result_record.serialize()},
             )
+        result_record.mark_persisted()
         if self.cache_result_in_memory:
             self.cache[key] = result_record
 

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/runner/AGENTS.md

@@ -138,7 +138,11 @@ These validations exist to prevent git argument injection. Do not bypass them wh
 
 **Env/sys.path isolation:** `_prepared_workspace_context` mutates `os.environ` and `sys.path` in the caller process but does NOT change `os.getcwd()`. The parent working directory is preserved.
 
-**Automatic `uv` command selection:** When no explicit command is passed, `WorkspaceResolvingEngineCommandStarter` auto-selects `uv run --project <project_root> -m prefect.flow_engine` — but only when all three conditions hold: `pyproject.toml` exists at `project_root`, the `project.dependencies` list includes `prefect`, and `uv` is found via the workspace's `PATH` env var (not the system PATH). If any condition fails, the command falls back to `None`. Explicit commands always take precedence.
+**Local path in-place execution:** When no pull steps are configured and the entrypoint file exists at `deployment.path` but not in the workspace root, `prepare_workspace` sets `working_directory` to the local path — not under `workspace_root`. The workspace directory is still created but is not the execution root. This is the "image-baked" pattern: code lives at a fixed local path (e.g., inside a container), not in object storage.
+
+**Pull-step directory fallback:** When pull steps run but none produces a `directory` output or changes CWD, `_ensure_entrypoint_in_workspace` copies storage into the workspace root as a fallback. This handles setup-only pull steps (e.g., `run_shell_script` for environment prep) that do not control the working directory themselves.
+
+**Automatic dependency installation:** By default, `WorkspaceResolvingEngineCommandStarter` does not install dependencies before starting a flow run. When no explicit command is passed and `PREFECT_RUNNER_AUTO_INSTALL_DEPENDENCIES` is true, it auto-selects `uv run --no-default-groups --project <project_root> -m prefect.flow_engine` — but only when all three conditions hold: `pyproject.toml` exists at `project_root`, the `project.dependencies` list includes `prefect`, and `uv` is found via the workspace's `PATH` env var (not the system PATH). If the setting is false or any condition fails, the command falls back to `None`. Explicit commands always take precedence.
 
 ## Reference
 

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/runner/_workspace_resolver.py

@@ -174,6 +174,61 @@ def _workspace_destination_for_deployment_path(
     return (workspace_root / relative_destination).resolve()
 
 
+def _resolve_local_runtime_directory(
+    path: str | None, source_cwd: Path, storage_base_path: Path | None
+) -> Path:
+    resolved_path = _resolve_local_deployment_path(path, source_cwd, storage_base_path)
+    return Path(resolved_path).resolve() if resolved_path is not None else source_cwd
+
+
+def _entrypoint_file_path(entrypoint: str, working_directory: Path) -> Path | None:
+    entrypoint = _resolve_runtime_entrypoint(entrypoint)
+    if ":" not in entrypoint:
+        return None
+
+    path, _object_name = entrypoint.rsplit(":", 1)
+    if not path.endswith(".py"):
+        return None
+
+    entrypoint_path = Path(path).expanduser()
+    if not entrypoint_path.is_absolute():
+        entrypoint_path = working_directory / entrypoint_path
+    return entrypoint_path.resolve()
+
+
+def _has_entrypoint_file(entrypoint: str, working_directory: Path) -> bool:
+    entrypoint_path = _entrypoint_file_path(entrypoint, working_directory)
+    return entrypoint_path is not None and entrypoint_path.is_file()
+
+
+async def _ensure_entrypoint_in_workspace(
+    client: "PrefectClient",
+    deployment: "DeploymentResponse",
+    workspace_root: Path,
+    source_cwd: Path,
+    storage_base_path: Path | None,
+) -> Path:
+    if _has_entrypoint_file(deployment.entrypoint, workspace_root):
+        return workspace_root
+
+    local_runtime_directory = _resolve_local_runtime_directory(
+        deployment.path, source_cwd, storage_base_path
+    )
+    if not deployment.storage_document_id and not _has_entrypoint_file(
+        deployment.entrypoint, local_runtime_directory
+    ):
+        return workspace_root
+
+    await _pull_storage_into_workspace(
+        client,
+        deployment,
+        workspace_root,
+        source_cwd,
+        storage_base_path,
+    )
+    return workspace_root
+
+
 @contextlib.contextmanager
 def _redirect_stdout_to_stderr() -> Any:
     stdout = sys.stdout
@@ -218,9 +273,12 @@ async def _pull_storage_into_workspace(
             else None
         )
     else:
-        from_path = _resolve_local_deployment_path(
+        resolved_local_path = _resolve_local_deployment_path(
             deployment.path, source_cwd, storage_base_path
         )
+        from_path = (
+            resolved_local_path if resolved_local_path is not None else str(source_cwd)
+        )
         storage_block = LocalFileSystem(basepath=from_path)
 
     LOGGER.info("Downloading flow code from storage at %r", from_path)
@@ -253,11 +311,17 @@ async def prepare_workspace(
             source_cwd,
             storage_base_path,
         )
-        os.chdir(working_directory)
-        working_directory = Path.cwd().resolve()
+        local_runtime_directory = _resolve_local_runtime_directory(
+            deployment.path, source_cwd, storage_base_path
+        )
+        if not _has_entrypoint_file(
+            deployment.entrypoint, working_directory
+        ) and _has_entrypoint_file(deployment.entrypoint, local_runtime_directory):
+            working_directory = local_runtime_directory
     else:
+        working_directory = resolved_workspace_root
+        step_selected_working_directory = False
         os.chdir(resolved_workspace_root)
-        working_directory = Path.cwd().resolve()
         LOGGER.info("Running %s deployment pull step(s)", len(deployment.pull_steps))
 
         def _track_step_workspace(
@@ -266,17 +330,19 @@ async def prepare_workspace(
             step_start_cwd: Path | None,
             step_end_cwd: Path | None,
         ) -> None:
-            nonlocal working_directory
+            nonlocal step_selected_working_directory, working_directory
 
             if isinstance(step_output, dict) and step_output.get("directory"):
                 resolved_directory = _resolve_directory_output(
                     step_output, step_end_cwd
                 )
                 if resolved_directory is not None:
+                    step_selected_working_directory = True
                     working_directory = resolved_directory
                 return
 
             if step_end_cwd is not None and step_end_cwd != step_start_cwd:
+                step_selected_working_directory = True
                 working_directory = step_end_cwd
 
         with _observe_step_completion(_track_step_workspace):
@@ -288,6 +354,18 @@ async def prepare_workspace(
                 logger=LOGGER,
             )
 
+        if not step_selected_working_directory:
+            working_directory = await _ensure_entrypoint_in_workspace(
+                client,
+                deployment,
+                resolved_workspace_root,
+                source_cwd,
+                storage_base_path,
+            )
+
+    os.chdir(working_directory)
+    working_directory = Path.cwd().resolve()
+
     project_root = _find_project_root(working_directory, resolved_workspace_root)
     return PreparedWorkspace(
         workspace_root=resolved_workspace_root,

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/runner/_workspace_starter.py

@@ -167,6 +167,9 @@ def _pyproject_declares_prefect_dependency(pyproject: Path) -> bool:
 
 
 def _uv_run_command(workspace: PreparedWorkspace) -> str | None:
+    if not get_current_settings().runner.auto_install_dependencies:
+        return None
+
     project_root = workspace.project_root
     if project_root is None:
         return None
@@ -188,6 +191,7 @@ def _uv_run_command(workspace: PreparedWorkspace) -> str | None:
         [
             uv_executable,
             "run",
+            "--no-default-groups",
             "--project",
             str(project_root),
             "-m",

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/runner/runner.py

@@ -1701,7 +1701,7 @@ class Runner:
             ):
                 return self._deployment_registry.get_flow(flow_run.deployment_id)
             return await load_flow_from_flow_run(
-                self._client, flow_run, storage_base_path=str(self._tmp_dir)
+                flow_run, storage_base_path=str(self._tmp_dir)
             )
 
         self._hook_runner = HookRunner(resolve_flow=_resolve_flow_for_hooks)

prefect_client-3.7.3/src/prefect/server/api/__init__.py

@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from prefect.server.api import (
+        admin,
+        artifacts,
+        automations,
+        block_capabilities,
+        block_documents,
+        block_schemas,
+        block_types,
+        collections,
+        concurrency_limits,
+        concurrency_limits_v2,
+        csrf_token,
+        dependencies,
+        deployments,
+        events,
+        flow_run_states,
+        flow_runs,
+        flows,
+        logs,
+        middleware,
+        root,
+        run_history,
+        saved_searches,
+        server,
+        task_run_states,
+        task_runs,
+        task_workers,
+        templates,
+        ui,
+        variables,
+        work_queues,
+        workers,
+    )
+
+__all__ = [
+    "admin",
+    "artifacts",
+    "automations",
+    "block_capabilities",
+    "block_documents",
+    "block_schemas",
+    "block_types",
+    "collections",
+    "concurrency_limits",
+    "concurrency_limits_v2",
+    "csrf_token",
+    "dependencies",
+    "deployments",
+    "events",
+    "flow_run_states",
+    "flow_runs",
+    "flows",
+    "logs",
+    "middleware",
+    "root",
+    "run_history",
+    "saved_searches",
+    "server",
+    "task_run_states",
+    "task_runs",
+    "task_workers",
+    "templates",
+    "ui",
+    "variables",
+    "work_queues",
+    "workers",
+]
+
+
+def __getattr__(name: str) -> object:
+    module_name = f"{__name__}.{name}"
+    try:
+        module = importlib.import_module(module_name)
+    except ModuleNotFoundError as exc:
+        if exc.name != module_name:
+            raise
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from None
+
+    globals()[name] = module
+    return module

prefect_client-3.7.3/src/prefect/server/api/_ui_static.py

@@ -0,0 +1,85 @@
+"""Private helpers for UI static-file management during server startup."""
+
+from __future__ import annotations
+
+import errno
+import logging
+import pathlib
+import shutil
+from dataclasses import dataclass
+from typing import Literal
+
+UIVersion = Literal["v1", "v2"]
+
+
+@dataclass(frozen=True)
+class UIBundle:
+    version: UIVersion
+    source_static_path: str
+    static_dir: str
+    base_url: str
+    cache_key: str
+    mount_name: str
+
+
+def log_ui_static_copy_error(
+    bundle: UIBundle,
+    exc: OSError,
+    logger: logging.Logger,
+) -> None:
+    """Log an actionable error when copying a UI bundle's static files fails."""
+    if exc.errno == errno.ENOSPC:
+        try:
+            disk_path = pathlib.Path(bundle.static_dir)
+            while not disk_path.exists():
+                disk_path = disk_path.parent
+            usage = shutil.disk_usage(disk_path)
+            available_mb = usage.free / (1024 * 1024)
+        except OSError:
+            available_mb = None
+        try:
+            required_bytes = sum(
+                f.stat().st_size
+                for f in pathlib.Path(bundle.source_static_path).rglob("*")
+                if f.is_file()
+            )
+            required_mb = required_bytes / (1024 * 1024)
+        except OSError:
+            required_mb = None
+
+        space_detail = ""
+        if required_mb is not None and available_mb is not None:
+            space_detail = (
+                f" Required: {required_mb:.1f} MB, available: {available_mb:.1f} MB."
+            )
+        elif available_mb is not None:
+            space_detail = f" Available disk space: {available_mb:.1f} MB."
+
+        logger.error(
+            "Not enough disk space to unpack %s UI static"
+            " files at %s.%s To resolve this, increase the"
+            " size of the volume mounted at that path or set"
+            " PREFECT_UI_STATIC_DIRECTORY to a location with"
+            " sufficient space.",
+            bundle.version.upper(),
+            bundle.static_dir,
+            space_detail,
+        )
+    elif isinstance(exc, PermissionError):
+        logger.error(
+            "Failed to create %s UI static directory at %s:"
+            " %s. That UI will not be available. To resolve"
+            " this, set PREFECT_UI_STATIC_DIRECTORY to a"
+            " writable directory.",
+            bundle.version.upper(),
+            bundle.static_dir,
+            exc,
+        )
+    else:
+        logger.error(
+            "Failed to create %s UI static directory at %s:"
+            " %s. That UI will not be available.",
+            bundle.version.upper(),
+            bundle.static_dir,
+            exc,
+        )

{prefect_client-3.7.2.dev5 → prefect_client-3.7.3}/src/prefect/server/api/server.py

@@ -21,11 +21,10 @@ import subprocess
 import sys
 import time
 from contextlib import AsyncExitStack, asynccontextmanager
-from dataclasses import dataclass
 from datetime import timedelta
 from functools import wraps
 from hashlib import sha256
-from typing import Any, AsyncGenerator, Awaitable, Callable, Literal, Optional
+from typing import Any, AsyncGenerator, Awaitable, Callable, Optional
 
 import anyio
 import asyncpg
@@ -52,6 +51,7 @@ from prefect._internal.compatibility.starlette import status
 from prefect._internal.observability import configure_logfire
 from prefect.client.constants import SERVER_API_VERSION
 from prefect.logging import get_logger
+from prefect.server.api._ui_static import UIBundle, UIVersion, log_ui_static_copy_error
 from prefect.server.api.background_workers import background_worker
 from prefect.server.api.dependencies import EnforceMinimumAPIVersion
 from prefect.server.exceptions import ObjectNotFoundError
@@ -128,7 +128,6 @@ SQLITE_LOCKED_MSG = "database is locked"
 UI_VERSION_COOKIE_NAME = "prefect_ui_version"
 UI_VERSION_PATH_SEGMENT = "v2"
 UI_STATIC_REFERENCE_FILE_NAME = "UI_SERVE_BASE"
-UIVersion = Literal["v1", "v2"]
 
 
 class _SQLiteLockedOperationalErrorFilter(logging.Filter):
@@ -183,16 +182,6 @@ class SPAStaticFiles(StaticFiles):
             return await super().get_response("./index.html", scope)
 
 
-@dataclass(frozen=True)
-class UIBundle:
-    version: UIVersion
-    source_static_path: str
-    static_dir: str
-    base_url: str
-    cache_key: str
-    mount_name: str
-
-
 def _normalize_ui_base_url(base_url: str) -> str:
     if not base_url:
         return "/"
@@ -749,15 +738,8 @@ def create_ui_app(ephemeral: bool) -> FastAPI:
             if not reference_file_matches_cache_key(bundle):
                 try:
                     create_ui_static_subpath(bundle)
-                except PermissionError as exc:
-                    logger.error(
-                        "Failed to create %s UI static directory at %s: %s. "
-                        "That UI will not be available. "
-                        "To resolve this, set PREFECT_UI_STATIC_DIRECTORY to a writable directory.",
-                        bundle.version.upper(),
-                        bundle.static_dir,
-                        exc,
-                    )
+                except OSError as exc:
+                    log_ui_static_copy_error(bundle, exc, logger)
                     continue
 
             mounted_bundles[bundle.version] = bundle