prefect-client 3.7.7.dev2__tar.gz → 3.7.8__tar.gz

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.7.7.dev2
+Version: 3.7.8
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
@@ -29,7 +29,7 @@ Requires-Dist: cloudpickle<4.0,>=2.0
 Requires-Dist: coolname<6.0.0,>=1.0.4
 Requires-Dist: dateparser<2.0.0,>=1.1.1
 Requires-Dist: exceptiongroup>=1.0.0
-Requires-Dist: fastapi<1.0.0,>=0.111.0
+Requires-Dist: fastapi<1.0.0,>=0.139.0
 Requires-Dist: fsspec>=2022.5.0
 Requires-Dist: graphviz>=0.20.1
 Requires-Dist: griffe<3.0.0,>=0.49.0

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/pyproject.toml

@@ -33,7 +33,7 @@ dependencies = [
     "coolname>=1.0.4,<6.0.0",
     "dateparser>=1.1.1,<2.0.0",
     "exceptiongroup>=1.0.0",
-    "fastapi>=0.111.0,<1.0.0",
+    "fastapi>=0.139.0,<1.0.0",
     "fsspec>=2022.5.0",
     "graphviz>=0.20.1",
     "griffe>=0.49.0,<3.0.0",

prefect_client-3.7.8/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.8"
+__build_date__ = "2026-07-09 21:28:27.023860+00:00"
+__git_commit__ = "b75c0606bf7606d9bafcfb89a36ae2e01a03c2d1"
+__dirty__ = False

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/src/prefect/_internal/schemas/validators.py

@@ -321,6 +321,7 @@ def normalize_rrule_string(
     rrule_string: str,
     *,
     now: Optional[datetime.datetime] = None,
+    timezone: Optional[str] = None,
 ) -> str:
     """Inject a `DTSTART` line into an rrule string if it doesn't already have one.
 
@@ -350,8 +351,16 @@ def normalize_rrule_string(
       datetimes, ~3 MB).
 
     Strings that already contain a `DTSTART` are returned unchanged.
+
+    The injected anchor is written as a floating (offset-less) `DTSTART`,
+    which `RRuleSchedule.to_rrule` later relabels with the schedule's
+    timezone. `timezone` is the schedule's IANA timezone (defaulting to
+    UTC); the recent anchor's wall-clock digits are computed in it so the
+    floating anchor lands on the intended local instant rather than being
+    shifted by the timezone's UTC offset (PrefectHQ/prefect#22455).
     """
     import dateutil.rrule
+    import dateutil.tz
 
     # Already anchored — leave it alone.
     if "DTSTART" in rrule_string.upper():
@@ -400,10 +409,22 @@ def normalize_rrule_string(
     unit_seconds = 1 if freq == dateutil.rrule.SECONDLY else 60
     period_seconds = unit_seconds * interval
 
+    # The injected `DTSTART` is serialized as floating (no offset/`Z`) and
+    # `RRuleSchedule.to_rrule` later relabels it with the schedule's timezone
+    # via `.replace(tzinfo=...)`, which keeps the wall-clock digits without
+    # converting the offset. The anchor's wall-clock digits must therefore be
+    # computed in the schedule's own timezone; computing them in UTC shifts
+    # every occurrence forward by the timezone's offset, suppressing runs on
+    # the deploy day (PrefectHQ/prefect#22455).
+    anchor_tz = dateutil.tz.gettz(timezone) if timezone else datetime.timezone.utc
+    if anchor_tz is None:
+        anchor_tz = datetime.timezone.utc
+
     if now is None:
-        now = datetime.datetime.now(datetime.timezone.utc).replace(tzinfo=None)
-    elif now.tzinfo is not None:
-        now = now.astimezone(datetime.timezone.utc).replace(tzinfo=None)
+        now = datetime.datetime.now(datetime.timezone.utc)
+    if now.tzinfo is None:
+        now = now.replace(tzinfo=datetime.timezone.utc)
+    now = now.astimezone(anchor_tz).replace(tzinfo=None)
 
     delta_seconds = (now - DEFAULT_RRULE_ANCHOR).total_seconds()
     if delta_seconds <= 0:
@@ -443,7 +464,9 @@ def normalize_schedule_rrule(schedule: _T) -> _T:
     rrule = getattr(schedule, "rrule", None)
     if not isinstance(rrule, str):
         return schedule
-    normalized = normalize_rrule_string(rrule)
+    normalized = normalize_rrule_string(
+        rrule, timezone=getattr(schedule, "timezone", None)
+    )
     if normalized == rrule:
         return schedule
     return type(schedule)(rrule=normalized, timezone=schedule.timezone)  # type: ignore[call-arg]

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/src/prefect/concurrency/_asyncio.py

@@ -43,6 +43,51 @@ class AcquireConcurrencySlotTimeoutError(TimeoutError):
 logger: logging.Logger = get_logger("concurrency")
 
 
+def _format_http_status_error(exc: httpx.HTTPStatusError) -> str:
+    """Format an HTTP status error from the server into a compact string.
+
+    Handles both Prefect API payloads (`exception_detail`) and raw FastAPI
+    payloads (`detail`), extracting Pydantic-style validation errors and
+    dropping the leading `body` location component.
+    """
+    status_code = exc.response.status_code
+    reason = exc.response.reason_phrase
+    status_text = f"{status_code} {reason}" if reason else str(status_code)
+
+    try:
+        body = exc.response.json()
+    except Exception:
+        body = None
+
+    messages: list[str] = []
+    if isinstance(body, dict):
+        errors = body.get("exception_detail") or body.get("detail")
+        if isinstance(errors, list):
+            for error in errors:
+                if not isinstance(error, dict):
+                    continue
+                msg = error.get("msg")
+                if not isinstance(msg, str):
+                    continue
+                loc = error.get("loc")
+                if isinstance(loc, (list, tuple)) and loc:
+                    if loc[0] == "body":
+                        loc = loc[1:]
+                    field = ".".join(str(part) for part in loc)
+                else:
+                    field = ""
+                if field:
+                    messages.append(f"{field}: {msg}")
+                else:
+                    messages.append(msg)
+        elif isinstance(errors, str):
+            messages.append(errors)
+
+    if messages:
+        return f"{status_text}: {'; '.join(messages)}"
+    return status_text
+
+
 async def aacquire_concurrency_slots(
     names: list[str],
     slots: int,
@@ -59,6 +104,11 @@ async def aacquire_concurrency_slots(
         raise AcquireConcurrencySlotTimeoutError(
             f"Attempt to acquire concurrency slots timed out after {timeout_seconds} second(s)"
         ) from timeout
+    except httpx.HTTPStatusError as exc:
+        raise ConcurrencySlotAcquisitionError(
+            f"Unable to acquire concurrency slots on {names!r}: "
+            f"{_format_http_status_error(exc)}"
+        ) from exc
     except Exception as exc:
         raise ConcurrencySlotAcquisitionError(
             f"Unable to acquire concurrency slots on {names!r}"
@@ -104,6 +154,11 @@ async def aacquire_concurrency_slots_with_lease(
         raise AcquireConcurrencySlotTimeoutError(
             f"Attempt to acquire concurrency slots timed out after {timeout_seconds} second(s)"
         ) from timeout
+    except httpx.HTTPStatusError as exc:
+        raise ConcurrencySlotAcquisitionError(
+            f"Unable to acquire concurrency slots on {names!r}: "
+            f"{_format_http_status_error(exc)}"
+        ) from exc
     except Exception as exc:
         raise ConcurrencySlotAcquisitionError(
             f"Unable to acquire concurrency slots on {names!r}"

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/src/prefect/events/clients.py

@@ -436,8 +436,17 @@ class PrefectEventsClient(EventsClient):
         # Clear the unconfirmed events here, because they are going back through emit
         # and will be added again through the normal checkpointing process
         self._unconfirmed_events = []
-        for event in events_to_resend:
-            await self.emit(event)
+        try:
+            while events_to_resend:
+                event = events_to_resend.pop(0)
+                await self.emit(event)
+        except Exception:
+            # If a resend fails partway through (emit() has its own retry
+            # budget), restore the events that were never attempted so a later
+            # reconnect can retry them. The event whose emit() failed was
+            # already added back to the buffer by emit() itself.
+            self._unconfirmed_events.extend(events_to_resend)
+            raise
         logger.debug("Finished resending unconfirmed events.")
         self._start_checkpoint_task()
 
@@ -452,17 +461,44 @@ class PrefectEventsClient(EventsClient):
 
     async def _checkpoint_loop(self) -> None:
         """Periodically checkpoint unconfirmed events on a time interval,
-        independent of the count-based checkpoint in _checkpoint."""
+        independent of the count-based checkpoint in _checkpoint.
+
+        If the connection has been lost (e.g. a server restart closed it),
+        reconnects and resends the unconfirmed events rather than leaving them
+        stranded until the next emit."""
         while True:
             await asyncio.sleep(self._checkpoint_interval)
-            if self._websocket and self._unconfirmed_events:
-                try:
+            if not self._unconfirmed_events:
+                continue
+            try:
+                if self._websocket:
                     await self._force_checkpoint()
+                    continue
+                # The connection was lost while events were still unconfirmed;
+                # reconnect to resend them rather than waiting for the next emit.
+                await self._reconnect()
+            except ConnectionClosed:
+                # The connection died since the last checkpoint; reconnect and
+                # resend the unconfirmed events. _reconnect() tears down the
+                # dead connection before connecting again.
+                try:
+                    await self._reconnect()
                 except Exception:
                     logger.debug(
-                        "Time-based checkpoint failed, will retry next interval.",
+                        "Reconnecting during time-based checkpoint failed, "
+                        "will retry next interval.",
                         exc_info=True,
                     )
+                    continue
+            except Exception:
+                logger.debug(
+                    "Time-based checkpoint failed, will retry next interval.",
+                    exc_info=True,
+                )
+                continue
+            # A successful _reconnect() resent the unconfirmed events and
+            # started a replacement checkpoint task, so this task is done.
+            return
 
     async def _force_checkpoint(self) -> None:
         """Checkpoint all unconfirmed events unconditionally."""

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/src/prefect/runner/_workspace_resolver.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import argparse
-import builtins
 import contextlib
 import os
 import sys
@@ -20,7 +19,8 @@ from prefect.deployments.steps.core import (
     run_steps,
 )
 from prefect.filesystems import LocalFileSystem
-from prefect.logging.loggers import get_logger
+from prefect.logging.handlers import APILogHandler
+from prefect.logging.loggers import PrefectLogAdapter, flow_run_logger
 from prefect.utilities.filesystem import relative_path_to_current_platform
 from prefect.utilities.processutils import get_sys_executable
 
@@ -29,7 +29,6 @@ if TYPE_CHECKING:
     from prefect.client.schemas.objects import FlowRun
     from prefect.client.schemas.responses import DeploymentResponse
 
-LOGGER = get_logger("prefect.runner.workspace_resolver")
 STORAGE_BASE_PATH_PLACEHOLDER = "$STORAGE_BASE_PATH"
 
 
@@ -67,11 +66,6 @@ def get_workspace_resolver_command(
     ]
 
 
-def _stderr_print(*args: Any, **kwargs: Any) -> None:
-    kwargs.pop("style", None)
-    builtins.print(*args, file=sys.stderr, **kwargs)
-
-
 def _resolve_runtime_entrypoint(entrypoint: str) -> str:
     if ":" not in entrypoint:
         return entrypoint
@@ -211,6 +205,7 @@ async def _ensure_entrypoint_in_workspace(
     workspace_root: Path,
     source_cwd: Path,
     storage_base_path: Path | None,
+    logger: PrefectLogAdapter,
 ) -> Path:
     if _has_entrypoint_file(deployment.entrypoint, workspace_root):
         return workspace_root
@@ -229,6 +224,7 @@ async def _ensure_entrypoint_in_workspace(
         workspace_root,
         source_cwd,
         storage_base_path,
+        logger,
     )
     return workspace_root
 
@@ -259,6 +255,7 @@ async def _pull_storage_into_workspace(
     workspace_root: Path,
     source_cwd: Path,
     storage_base_path: Path | None,
+    logger: PrefectLogAdapter,
 ) -> Path:
     local_path = _workspace_destination_for_deployment_path(
         deployment.path, workspace_root, storage_base_path
@@ -285,7 +282,7 @@ async def _pull_storage_into_workspace(
         )
         storage_block = LocalFileSystem(basepath=from_path)
 
-    LOGGER.info("Downloading flow code from storage at %r", from_path)
+    logger.info("Downloading flow code from storage at %r", from_path)
     await storage_block.get_directory(from_path=from_path, local_path=str(local_path))
     return local_path
 
@@ -301,6 +298,8 @@ async def prepare_workspace(
             f"Deployment {deployment.id} does not have an entrypoint and can not be run."
         )
 
+    run_logger = flow_run_logger(flow_run)
+
     source_cwd = Path.cwd().resolve()
     storage_base_path = _get_configured_storage_base_path()
     resolved_workspace_root = Path(workspace_root).expanduser().resolve()
@@ -314,6 +313,7 @@ async def prepare_workspace(
             resolved_workspace_root,
             source_cwd,
             storage_base_path,
+            run_logger,
         )
         local_runtime_directory = _resolve_local_runtime_directory(
             deployment.path, source_cwd, storage_base_path
@@ -326,7 +326,9 @@ async def prepare_workspace(
         working_directory = resolved_workspace_root
         step_selected_working_directory = False
         os.chdir(resolved_workspace_root)
-        LOGGER.info("Running %s deployment pull step(s)", len(deployment.pull_steps))
+        run_logger.info(
+            "Running %s deployment pull step(s)", len(deployment.pull_steps)
+        )
 
         def _track_step_workspace(
             _step: dict[str, Any],
@@ -359,10 +361,10 @@ async def prepare_workspace(
             with _observe_step_completion(_track_step_workspace):
                 await run_steps(
                     deployment.pull_steps,
-                    print_function=_stderr_print,
+                    print_function=run_logger.warning,
                     deployment=deployment,
                     flow_run=flow_run,
-                    logger=LOGGER,
+                    logger=run_logger,
                 )
         finally:
             _PULL_STEP_SOURCE_CWD.reset(source_cwd_token)
@@ -374,6 +376,7 @@ async def prepare_workspace(
                 resolved_workspace_root,
                 source_cwd,
                 storage_base_path,
+                run_logger,
             )
 
     os.chdir(working_directory)
@@ -436,6 +439,8 @@ async def _main_async(argv: list[str] | None = None) -> int:
         sys.stdout.write(result.model_dump_json())
         sys.stdout.write("\n")
         return 1
+    finally:
+        await APILogHandler.aflush()
 
     result = PreparedWorkspaceResult(status="success", workspace=workspace)
     sys.stdout.write(result.model_dump_json())

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/src/prefect/runner/storage.py

@@ -1,8 +1,11 @@
 from __future__ import annotations
 
+import os
 import re
 import shutil
+import stat
 import subprocess
+import sys
 import warnings
 from copy import deepcopy
 from pathlib import Path
@@ -31,6 +34,41 @@ from prefect.logging.loggers import get_logger
 from prefect.utilities.collections import visit_collection
 
 
+def _clear_read_only_attributes(path: Path) -> None:
+    """
+    Recursively clear the read-only attribute on files within a directory.
+
+    On Windows, git writes pack and loose object files as read-only (mode
+    `0o444`). A subsequent `git pull` that needs to repack or replace those
+    files then fails with `[WinError 5] Access is denied`. Marking the files
+    as writable beforehand lets git manage them. This is a no-op on
+    non-Windows platforms, where read-only object files do not block git.
+    """
+    if sys.platform != "win32":
+        return
+    if not path.exists():
+        return
+    for entry in path.rglob("*"):
+        try:
+            if entry.is_file() and not entry.is_symlink():
+                os.chmod(entry, stat.S_IWRITE | stat.S_IREAD)
+        except OSError:
+            # Best effort: if a single file can't be made writable, let git
+            # surface the underlying error rather than masking it here.
+            continue
+
+
+def _rmtree_including_read_only(path: Path) -> None:
+    """
+    Remove a directory tree, first clearing read-only attributes so that
+    read-only git object files (mode `0o444` on Windows) do not raise
+    `[WinError 5] Access is denied` during deletion. This is a plain
+    `shutil.rmtree` on non-Windows platforms.
+    """
+    _clear_read_only_attributes(path)
+    shutil.rmtree(path)
+
+
 @runtime_checkable
 class RunnerStorage(Protocol):
     """
@@ -393,6 +431,11 @@ class GitRepository:
                     f"does not match the configured repository {configured_repo_url}"
                 )
 
+            # On Windows, git object files are read-only, which prevents git
+            # from repacking or replacing them during a pull. Clear the
+            # read-only attribute first to avoid `[WinError 5] Access is denied`.
+            _clear_read_only_attributes(git_dir)
+
             # Sparsely checkout the repository if directories are specified and the repo is not in sparse-checkout mode already
             if self._directories and not await self.is_sparsely_checked_out():
                 await run_process(
@@ -423,7 +466,7 @@ class GitRepository:
                     self._logger.error(
                         f"Failed to fetch latest changes with exit code {exc}"
                     )
-                    shutil.rmtree(self.destination)
+                    _rmtree_including_read_only(self.destination)
                     await self._clone_repo()
 
                 await run_process(
@@ -449,7 +492,7 @@ class GitRepository:
                     self._logger.error(
                         f"Failed to pull latest changes with exit code {exc}"
                     )
-                    shutil.rmtree(self.destination)
+                    _rmtree_including_read_only(self.destination)
                     await self._clone_repo()
 
         else:

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/src/prefect/server/api/_ui_static.py

@@ -19,7 +19,6 @@ class UIBundle:
     static_dir: str
     base_url: str
     cache_key: str
-    mount_name: str
 
 
 def log_ui_static_copy_error(

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/src/prefect/server/api/server.py

@@ -43,7 +43,6 @@ from fastapi.openapi.utils import get_openapi
 from fastapi.responses import JSONResponse, RedirectResponse
 from fastapi.staticfiles import StaticFiles
 from packaging.version import Version
-from starlette.exceptions import HTTPException
 from typing_extensions import Self
 
 import prefect
@@ -176,21 +175,6 @@ def _install_sqlite_locked_log_filter() -> None:
     _SQLITE_LOCKED_LOG_FILTER = filter_
 
 
-class SPAStaticFiles(StaticFiles):
-    """
-    Implementation of `StaticFiles` for serving single page applications.
-
-    Adds `get_response` handling to ensure that when a resource isn't found the
-    application still returns the index.
-    """
-
-    async def get_response(self, path: str, scope: Any) -> Response:
-        try:
-            return await super().get_response(path, scope)
-        except HTTPException:
-            return await super().get_response("./index.html", scope)
-
-
 def _normalize_ui_base_url(base_url: str) -> str:
     if not base_url:
         return "/"
@@ -616,7 +600,6 @@ def create_ui_app(ephemeral: bool) -> FastAPI:
             static_dir=build_static_dir("v1", str(prefect.__ui_static_subpath__)),
             base_url=v1_base_url,
             cache_key=f"v1:{prefect.__version__}:{v1_base_url}",
-            mount_name="ui_v1",
         ),
         UIBundle(
             version="v2",
@@ -624,7 +607,6 @@ def create_ui_app(ephemeral: bool) -> FastAPI:
             static_dir=build_static_dir("v2", str(prefect.__ui_v2_static_subpath__)),
             base_url=v2_base_url,
             cache_key=f"v2:{prefect.__version__}:{v2_base_url}",
-            mount_name="ui_v2",
         ),
     ]
 
@@ -767,10 +749,10 @@ def create_ui_app(ephemeral: bool) -> FastAPI:
             if bundle is None:
                 continue
 
-            ui_app.mount(
+            ui_app.frontend(
                 bundle.base_url,
-                SPAStaticFiles(directory=bundle.static_dir),
-                name=bundle.mount_name,
+                directory=bundle.static_dir,
+                fallback="index.html",
             )
 
     return ui_app

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/src/prefect/server/api/workers.py

@@ -1148,6 +1148,7 @@ 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,
+                work_pool_updated=ready.payload.initial_snapshot.work_pool.updated,
                 cleanup_queue=(
                     cleanup_queue
                     if CLEANUP_DELIVERY_CAPABILITY

{prefect_client-3.7.7.dev2 → prefect_client-3.7.8}/src/prefect/workers/_worker_channel/_transport.py

@@ -143,7 +143,12 @@ class WorkerChannelTransport:
 
         status_code = self._status_code_from_exception(exc)
         if status_code is not None:
-            if status_code in {401, 403}:
+            if status_code == 401:
+                return WorkerChannelTerminalError(
+                    WorkerChannelCloseReason.AUTHENTICATION_FAILED.value,
+                    "Worker channel setup was rejected by the server",
+                )
+            if status_code == 403:
                 return WorkerChannelTerminalError(
                     WorkerChannelCloseReason.AUTHORIZATION_FAILED.value,
                     "Worker channel setup was rejected by the server",

prefect_client-3.7.7.dev2/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.7.7.dev2"
-__build_date__ = "2026-07-02 09:09:49.619469+00:00"
-__git_commit__ = "ab6a0dc6d01900814612a11dc41d0d80c9549112"
-__dirty__ = False