prefect-client 3.2.5__py3-none-any.whl → 3.2.7__py3-none-any.whl

prefect/_build_info.py

@@ -1,5 +1,5 @@
 # Generated by versioningit
-__version__ = "3.2.5"
-__build_date__ = "2025-02-19 03:24:41.213047+00:00"
-__git_commit__ = "168280f75a7c7cbd871a0cfbbde8a8bfc1834026"
+__version__ = "3.2.7"
+__build_date__ = "2025-02-21 19:38:38.599741+00:00"
+__git_commit__ = "d4d9001e40eb378ec68a97f7e3bab07d89c7557c"
 __dirty__ = False

prefect/_experimental/bundles.py

@@ -0,0 +1,143 @@
+from __future__ import annotations
+
+import asyncio
+import base64
+import gzip
+import multiprocessing
+import multiprocessing.context
+import os
+from typing import Any, TypedDict
+
+import cloudpickle
+
+from prefect.client.schemas.objects import FlowRun
+from prefect.context import SettingsContext, get_settings_context, serialize_context
+from prefect.engine import handle_engine_signals
+from prefect.flow_engine import run_flow
+from prefect.flows import Flow
+from prefect.settings.context import get_current_settings
+from prefect.settings.models.root import Settings
+
+
+class SerializedBundle(TypedDict):
+    """
+    A serialized bundle is a serialized function, context, and flow run that can be
+    easily transported for later execution.
+    """
+
+    function: str
+    context: str
+    flow_run: dict[str, Any]
+
+
+def _serialize_bundle_object(obj: Any) -> str:
+    """
+    Serializes an object to a string.
+    """
+    return base64.b64encode(gzip.compress(cloudpickle.dumps(obj))).decode()
+
+
+def _deserialize_bundle_object(serialized_obj: str) -> Any:
+    """
+    Deserializes an object from a string.
+    """
+    return cloudpickle.loads(gzip.decompress(base64.b64decode(serialized_obj)))
+
+
+def create_bundle_for_flow_run(
+    flow: Flow[Any, Any],
+    flow_run: FlowRun,
+    context: dict[str, Any] | None = None,
+) -> SerializedBundle:
+    """
+    Creates a bundle for a flow run.
+
+    Args:
+        flow: The flow to bundle.
+        flow_run: The flow run to bundle.
+        context: The context to use when running the flow.
+
+    Returns:
+        A serialized bundle.
+    """
+    context = context or serialize_context()
+
+    return {
+        "function": _serialize_bundle_object(flow),
+        "context": _serialize_bundle_object(context),
+        "flow_run": flow_run.model_dump(mode="json"),
+    }
+
+
+def extract_flow_from_bundle(bundle: SerializedBundle) -> Flow[Any, Any]:
+    """
+    Extracts a flow from a bundle.
+    """
+    return _deserialize_bundle_object(bundle["function"])
+
+
+def _extract_and_run_flow(
+    bundle: SerializedBundle, env: dict[str, Any] | None = None
+) -> None:
+    """
+    Extracts a flow from a bundle and runs it.
+
+    Designed to be run in a subprocess.
+
+    Args:
+        bundle: The bundle to extract and run.
+        env: The environment to use when running the flow.
+    """
+
+    os.environ.update(env or {})
+    # TODO: make this a thing we can pass directly to the engine
+    os.environ["PREFECT__ENABLE_CANCELLATION_AND_CRASHED_HOOKS"] = "false"
+    settings_context = get_settings_context()
+
+    flow = _deserialize_bundle_object(bundle["function"])
+    context = _deserialize_bundle_object(bundle["context"])
+    flow_run = FlowRun.model_validate(bundle["flow_run"])
+
+    with SettingsContext(
+        profile=settings_context.profile,
+        settings=Settings(),
+    ):
+        with handle_engine_signals(flow_run.id):
+            maybe_coro = run_flow(
+                flow=flow,
+                flow_run=flow_run,
+                context=context,
+            )
+            if asyncio.iscoroutine(maybe_coro):
+                # This is running in a brand new process, so there won't be an existing
+                # event loop.
+                asyncio.run(maybe_coro)
+
+
+def execute_bundle_in_subprocess(
+    bundle: SerializedBundle,
+) -> multiprocessing.context.SpawnProcess:
+    """
+    Executes a bundle in a subprocess.
+
+    Args:
+        bundle: The bundle to execute.
+
+    Returns:
+        A multiprocessing.context.SpawnProcess.
+    """
+
+    ctx = multiprocessing.get_context("spawn")
+
+    process = ctx.Process(
+        target=_extract_and_run_flow,
+        kwargs={
+            "bundle": bundle,
+            "env": get_current_settings().to_environment_variables(exclude_unset=True)
+            | os.environ,
+        },
+    )
+
+    process.start()
+
+    return process

prefect/client/orchestration/__init__.py

@@ -81,6 +81,7 @@ from prefect.client.orchestration._blocks_types.client import (
 
 import prefect
 import prefect.exceptions
+from prefect.logging.loggers import get_run_logger
 import prefect.settings
 import prefect.states
 from prefect.client.constants import SERVER_API_VERSION
@@ -1182,8 +1183,17 @@ class PrefectClient(
         if api_version.major != client_version.major:
             raise RuntimeError(
                 f"Found incompatible versions: client: {client_version}, server: {api_version}. "
-                f"Major versions must match."
+                "Major versions must match."
             )
+        if api_version < client_version:
+            warning_message = (
+                "Your Prefect server is running an older version of Prefect than your client which may result in unexpected behavior. "
+                f"Please upgrade your Prefect server from version {api_version} to version {client_version} or higher."
+            )
+            try:
+                get_run_logger().warning(warning_message)
+            except prefect.context.MissingContextError:
+                self.logger.warning(warning_message)
 
     async def __aenter__(self) -> Self:
         """
@@ -1523,8 +1533,17 @@ class SyncPrefectClient(
         if api_version.major != client_version.major:
             raise RuntimeError(
                 f"Found incompatible versions: client: {client_version}, server: {api_version}. "
-                f"Major versions must match."
+                "Major versions must match."
             )
+        if api_version < client_version:
+            warning_message = (
+                "Your Prefect server is running an older version of Prefect than your client which may result in unexpected behavior. "
+                f"Please upgrade your Prefect server from version {api_version} to version {client_version} or higher."
+            )
+            try:
+                get_run_logger().warning(warning_message)
+            except prefect.context.MissingContextError:
+                self.logger.warning(warning_message)
 
     def set_task_run_name(self, task_run_id: UUID, name: str) -> httpx.Response:
         task_run_data = TaskRunUpdate(name=name)

prefect/engine.py

@@ -1,5 +1,8 @@
+from __future__ import annotations
+
 import os
 import sys
+from contextlib import contextmanager
 from typing import TYPE_CHECKING, Any, Callable
 from uuid import UUID
 
@@ -18,13 +21,71 @@ from prefect.utilities.asyncutils import (
 if TYPE_CHECKING:
     import logging
 
-    from prefect.flow_engine import FlowRun
+    from prefect.client.schemas.objects import FlowRun
     from prefect.flows import Flow
     from prefect.logging.loggers import LoggingAdapter
 
 engine_logger: "logging.Logger" = get_logger("engine")
 
 
+@contextmanager
+def handle_engine_signals(flow_run_id: UUID | None = None):
+    """
+    Handle signals from the orchestrator to abort or pause the flow run or otherwise
+    handle unexpected exceptions.
+
+    This context manager will handle exiting the process depending on the signal received.
+
+    Args:
+        flow_run_id: The ID of the flow run to handle signals for.
+
+    Example:
+        ```python
+        from prefect import flow
+        from prefect.engine import handle_engine_signals
+        from prefect.flow_engine import run_flow
+
+        @flow
+        def my_flow():
+            print("Hello, world!")
+
+        with handle_engine_signals():
+            run_flow(my_flow)
+        ```
+    """
+    try:
+        yield
+    except Abort:
+        if flow_run_id:
+            msg = f"Execution of flow run '{flow_run_id}' aborted by orchestrator."
+        else:
+            msg = "Execution aborted by orchestrator."
+        engine_logger.info(msg)
+        exit(0)
+    except Pause:
+        if flow_run_id:
+            msg = f"Execution of flow run '{flow_run_id}' is paused."
+        else:
+            msg = "Execution is paused."
+        engine_logger.info(msg)
+        exit(0)
+    except Exception:
+        if flow_run_id:
+            msg = f"Execution of flow run '{flow_run_id}' exited with unexpected exception"
+        else:
+            msg = "Execution exited with unexpected exception"
+        engine_logger.error(msg, exc_info=True)
+        exit(1)
+    except BaseException:
+        if flow_run_id:
+            msg = f"Execution of flow run '{flow_run_id}' interrupted by base exception"
+        else:
+            msg = "Execution interrupted by base exception"
+        engine_logger.error(msg, exc_info=True)
+        # Let the exit code be determined by the base exception type
+        raise
+
+
 if __name__ == "__main__":
     try:
         flow_run_id: UUID = UUID(
@@ -36,7 +97,7 @@ if __name__ == "__main__":
         )
         exit(1)
 
-    try:
+    with handle_engine_signals(flow_run_id):
         from prefect.flow_engine import (
             flow_run_logger,
             load_flow,
@@ -62,32 +123,5 @@ if __name__ == "__main__":
         else:
             run_flow(flow, flow_run=flow_run, error_logger=run_logger)
 
-    except Abort:
-        engine_logger.info(
-            f"Engine execution of flow run '{flow_run_id}' aborted by orchestrator."
-        )
-        exit(0)
-    except Pause:
-        engine_logger.info(f"Engine execution of flow run '{flow_run_id}' is paused.")
-        exit(0)
-    except Exception:
-        engine_logger.error(
-            (
-                f"Engine execution of flow run '{flow_run_id}' exited with unexpected "
-                "exception"
-            ),
-            exc_info=True,
-        )
-        exit(1)
-    except BaseException:
-        engine_logger.error(
-            (
-                f"Engine execution of flow run '{flow_run_id}' interrupted by base "
-                "exception"
-            ),
-            exc_info=True,
-        )
-        # Let the exit code be determined by the base exception type
-        raise
 
 __getattr__: Callable[[str], Any] = getattr_migration(__name__)

prefect/events/schemas/automations.py

@@ -84,7 +84,7 @@ class Trigger(PrefectBaseModel, abc.ABC, extra="ignore"):  # type: ignore[call-a
                 getattr(self, "name", None)
                 or f"Automation for deployment {self._deployment_id}"
             ),
-            description="",
+            description=getattr(self, "description", ""),
             enabled=getattr(self, "enabled", True),
             trigger=trigger,
             actions=self.actions(),

prefect/flow_engine.py

@@ -47,6 +47,7 @@ from prefect.context import (
     hydrated_context,
     serialize_context,
 )
+from prefect.engine import handle_engine_signals
 from prefect.exceptions import (
     Abort,
     MissingFlowError,
@@ -1592,8 +1593,6 @@ def run_flow_in_subprocess(
         """
         Wrapper function to update environment variables and settings before running the flow.
         """
-        engine_logger = logging.getLogger("prefect.engine")
-
         os.environ.update(env or {})
         settings_context = get_settings_context()
         # Create a new settings context with a new settings object to pick up the updated
@@ -1602,41 +1601,12 @@ def run_flow_in_subprocess(
             profile=settings_context.profile,
             settings=Settings(),
         ):
-            try:
+            with handle_engine_signals(getattr(flow_run, "id", None)):
                 maybe_coro = run_flow(*args, **kwargs)
                 if asyncio.iscoroutine(maybe_coro):
                     # This is running in a brand new process, so there won't be an existing
                     # event loop.
                     asyncio.run(maybe_coro)
-            except Abort:
-                if flow_run:
-                    msg = f"Execution of flow run '{flow_run.id}' aborted by orchestrator."
-                else:
-                    msg = "Execution aborted by orchestrator."
-                engine_logger.info(msg)
-                exit(0)
-            except Pause:
-                if flow_run:
-                    msg = f"Execution of flow run '{flow_run.id}' is paused."
-                else:
-                    msg = "Execution is paused."
-                engine_logger.info(msg)
-                exit(0)
-            except Exception:
-                if flow_run:
-                    msg = f"Execution of flow run '{flow_run.id}' exited with unexpected exception"
-                else:
-                    msg = "Execution exited with unexpected exception"
-                engine_logger.error(msg, exc_info=True)
-                exit(1)
-            except BaseException:
-                if flow_run:
-                    msg = f"Execution of flow run '{flow_run.id}' interrupted by base exception"
-                else:
-                    msg = "Execution interrupted by base exception"
-                engine_logger.error(msg, exc_info=True)
-                # Let the exit code be determined by the base exception type
-                raise
 
     ctx = multiprocessing.get_context("spawn")
 

prefect/flows.py

@@ -2350,9 +2350,15 @@ async def load_flow_from_flow_run(
             f"Running {len(deployment.pull_steps)} deployment pull step(s)"
         )
 
-        from prefect.deployments.steps.core import run_steps
+        from prefect.deployments.steps.core import StepExecutionError, run_steps
+
+        try:
+            output = await run_steps(deployment.pull_steps)
+        except StepExecutionError as e:
+            e = e.__cause__ or e
+            run_logger.error(str(e))
+            raise
 
-        output = await run_steps(deployment.pull_steps)
         if output.get("directory"):
             run_logger.debug(f"Changing working directory to {output['directory']!r}")
             os.chdir(output["directory"])

prefect/logging/configuration.py

@@ -38,7 +38,9 @@ def load_logging_config(path: Path) -> dict[str, Any]:
         warnings.filterwarnings("ignore", category=DeprecationWarning)
         config = yaml.safe_load(
             # Substitute settings into the template in format $SETTING / ${SETTING}
-            template.substitute(current_settings.to_environment_variables())
+            template.substitute(
+                current_settings.to_environment_variables(include_aliases=True)
+            )
         )
 
     # Load overrides from the environment

prefect/runner/runner.py

@@ -64,9 +64,15 @@ from uuid import UUID, uuid4
 
 import anyio
 import anyio.abc
+import anyio.to_thread
 from cachetools import LRUCache
 from typing_extensions import Self
 
+from prefect._experimental.bundles import (
+    SerializedBundle,
+    execute_bundle_in_subprocess,
+    extract_flow_from_bundle,
+)
 from prefect._internal.concurrency.api import (
     create_call,
     from_async,
@@ -135,7 +141,7 @@ __all__ = ["Runner"]
 
 
 class ProcessMapEntry(TypedDict):
-    flow_run: FlowRun
+    flow_run: "FlowRun"
     pid: int
 
 
@@ -221,6 +227,7 @@ class Runner:
         self._scheduled_task_scopes: set[anyio.abc.CancelScope] = set()
         self._deployment_ids: set[UUID] = set()
         self._flow_run_process_map: dict[UUID, ProcessMapEntry] = dict()
+        self._flow_run_bundle_map: dict[UUID, SerializedBundle] = dict()
 
         self._tmp_dir: Path = (
             Path(tempfile.gettempdir()) / "runner_storage" / str(uuid4())
@@ -508,7 +515,7 @@ class Runner:
         return asyncio.run_coroutine_threadsafe(func(*args, **kwargs), self._loop)
 
     async def cancel_all(self) -> None:
-        runs_to_cancel: list[FlowRun] = []
+        runs_to_cancel: list["FlowRun"] = []
 
         # done to avoid dictionary size changing during iteration
         for info in self._flow_run_process_map.values():
@@ -602,7 +609,120 @@ class Runner:
                             )
                         )
 
-    def _get_flow_run_logger(self, flow_run: "FlowRun | FlowRun") -> PrefectLogAdapter:
+    async def execute_bundle(self, bundle: SerializedBundle) -> None:
+        """
+        Executes a bundle in a subprocess.
+        """
+        from prefect.client.schemas.objects import FlowRun
+
+        self.pause_on_shutdown = False
+        context = self if not self.started else asyncnullcontext()
+
+        flow_run = FlowRun.model_validate(bundle["flow_run"])
+
+        async with context:
+            if not self._acquire_limit_slot(flow_run.id):
+                return
+
+            process = execute_bundle_in_subprocess(bundle)
+
+            if process.pid is None:
+                # This shouldn't happen because `execute_bundle_in_subprocess` starts the process
+                # but we'll handle it gracefully anyway
+                msg = "Failed to start process for flow execution. No PID returned."
+                await self._propose_crashed_state(flow_run, msg)
+                raise RuntimeError(msg)
+
+            self._flow_run_process_map[flow_run.id] = ProcessMapEntry(
+                pid=process.pid, flow_run=flow_run
+            )
+            self._flow_run_bundle_map[flow_run.id] = bundle
+
+            tasks: list[asyncio.Task[None]] = []
+            tasks.append(
+                asyncio.create_task(
+                    critical_service_loop(
+                        workload=self._check_for_cancelled_flow_runs,
+                        interval=self.query_seconds,
+                        jitter_range=0.3,
+                    )
+                )
+            )
+            if self.heartbeat_seconds is not None:
+                tasks.append(
+                    asyncio.create_task(
+                        critical_service_loop(
+                            workload=self._emit_flow_run_heartbeats,
+                            interval=self.heartbeat_seconds,
+                            jitter_range=0.1,
+                        )
+                    )
+                )
+
+            await anyio.to_thread.run_sync(process.join)
+
+            for task in tasks:
+                task.cancel()
+
+            await asyncio.gather(*tasks, return_exceptions=True)
+
+            self._flow_run_process_map.pop(flow_run.id)
+
+            flow_run_logger = self._get_flow_run_logger(flow_run)
+            if process.exitcode is None:
+                raise RuntimeError("Process has no exit code")
+
+            if process.exitcode:
+                help_message = None
+                level = logging.ERROR
+                if process.exitcode == -9:
+                    level = logging.INFO
+                    help_message = (
+                        "This indicates that the process exited due to a SIGKILL signal. "
+                        "Typically, this is either caused by manual cancellation or "
+                        "high memory usage causing the operating system to "
+                        "terminate the process."
+                    )
+                if process.exitcode == -15:
+                    level = logging.INFO
+                    help_message = (
+                        "This indicates that the process exited due to a SIGTERM signal. "
+                        "Typically, this is caused by manual cancellation."
+                    )
+                elif process.exitcode == 247:
+                    help_message = (
+                        "This indicates that the process was terminated due to high "
+                        "memory usage."
+                    )
+                elif (
+                    sys.platform == "win32"
+                    and process.returncode == STATUS_CONTROL_C_EXIT
+                ):
+                    level = logging.INFO
+                    help_message = (
+                        "Process was terminated due to a Ctrl+C or Ctrl+Break signal. "
+                        "Typically, this is caused by manual cancellation."
+                    )
+
+                flow_run_logger.log(
+                    level,
+                    f"Process for flow run {flow_run.name!r} exited with status code:"
+                    f" {process.exitcode}"
+                    + (f"; {help_message}" if help_message else ""),
+                )
+                terminal_state = await self._propose_crashed_state(
+                    flow_run, help_message or "Process exited with non-zero exit code"
+                )
+                if terminal_state:
+                    await self._run_on_crashed_hooks(
+                        flow_run=flow_run, state=terminal_state
+                    )
+            else:
+                flow_run_logger.info(
+                    f"Process for flow run {flow_run.name!r} exited cleanly."
+                )
+
+    def _get_flow_run_logger(self, flow_run: "FlowRun") -> PrefectLogAdapter:
         return flow_run_logger(flow_run=flow_run).getChild(
             "runner",
             extra={
@@ -1308,8 +1428,11 @@ class Runner:
                 exc_info=True,
             )
 
-    async def _propose_crashed_state(self, flow_run: "FlowRun", message: str) -> None:
+    async def _propose_crashed_state(
+        self, flow_run: "FlowRun", message: str
+    ) -> State[Any] | None:
         run_logger = self._get_flow_run_logger(flow_run)
+        state = None
         try:
             state = await propose_state(
                 self._client,
@@ -1326,6 +1449,7 @@ class Runner:
                 run_logger.info(
                     f"Reported flow run '{flow_run.id}' as crashed: {message}"
                 )
+        return state
 
     async def _mark_flow_run_as_cancelled(
         self, flow_run: "FlowRun", state_updates: Optional[dict[str, Any]] = None
@@ -1391,9 +1515,14 @@ class Runner:
         """
         if state.is_cancelling():
             try:
-                flow = await load_flow_from_flow_run(
-                    flow_run, storage_base_path=str(self._tmp_dir)
-                )
+                if flow_run.id in self._flow_run_bundle_map:
+                    flow = extract_flow_from_bundle(
+                        self._flow_run_bundle_map[flow_run.id]
+                    )
+                else:
+                    flow = await load_flow_from_flow_run(
+                        flow_run, storage_base_path=str(self._tmp_dir)
+                    )
                 hooks = flow.on_cancellation_hooks or []
 
                 await _run_hooks(hooks, flow_run, flow, state)
@@ -1412,9 +1541,12 @@ class Runner:
         Run the hooks for a flow.
         """
         if state.is_crashed():
-            flow = await load_flow_from_flow_run(
-                flow_run, storage_base_path=str(self._tmp_dir)
-            )
+            if flow_run.id in self._flow_run_bundle_map:
+                flow = extract_flow_from_bundle(self._flow_run_bundle_map[flow_run.id])
+            else:
+                flow = await load_flow_from_flow_run(
+                    flow_run, storage_base_path=str(self._tmp_dir)
+                )
             hooks = flow.on_crashed_hooks or []
 
             await _run_hooks(hooks, flow_run, flow, state)

prefect/server/api/server.py

@@ -55,6 +55,7 @@ from prefect.settings import (
     PREFECT_DEBUG_MODE,
     PREFECT_MEMO_STORE_PATH,
     PREFECT_MEMOIZE_BLOCK_AUTO_REGISTRATION,
+    PREFECT_SERVER_API_BASE_PATH,
     PREFECT_SERVER_EPHEMERAL_STARTUP_TIMEOUT_SECONDS,
     PREFECT_UI_SERVE_BASE,
     get_current_settings,
@@ -356,7 +357,10 @@ def create_api_app(
             header_token = request.headers.get("Authorization")
 
             # used for probes in k8s and such
-            if request.url.path in ["/api/health", "/api/ready"]:
+            if (
+                request.url.path.endswith(("health", "ready"))
+                and request.method.upper() == "GET"
+            ):
                 return await call_next(request)
             try:
                 if header_token is None:
@@ -691,7 +695,10 @@ def create_app(
         name="static",
     )
     app.api_app = api_app
-    app.mount("/api", app=api_app, name="api")
+    if PREFECT_SERVER_API_BASE_PATH:
+        app.mount(PREFECT_SERVER_API_BASE_PATH.value(), app=api_app, name="api")
+    else:
+        app.mount("/api", app=api_app, name="api")
     app.mount("/", app=ui_app, name="ui")
 
     def openapi():

prefect/settings/base.py

@@ -92,6 +92,7 @@ class PrefectBaseSettings(BaseSettings):
         self,
         exclude_unset: bool = False,
         include_secrets: bool = True,
+        include_aliases: bool = False,
     ) -> Dict[str, str]:
         """Convert the settings object to a dictionary of environment variables."""
         env: Dict[str, Any] = self.model_dump(
@@ -105,12 +106,26 @@ class PrefectBaseSettings(BaseSettings):
                 child_env = child_settings.to_environment_variables(
                     exclude_unset=exclude_unset,
                     include_secrets=include_secrets,
+                    include_aliases=include_aliases,
                 )
                 env_variables.update(child_env)
             elif (value := env.get(key)) is not None:
-                env_variables[f"{self.model_config.get('env_prefix')}{key.upper()}"] = (
-                    _to_environment_variable_value(value)
-                )
+                validation_alias = self.model_fields[key].validation_alias
+                if include_aliases and validation_alias is not None:
+                    if isinstance(validation_alias, AliasChoices):
+                        for alias in validation_alias.choices:
+                            if isinstance(alias, str):
+                                env_variables[alias.upper()] = (
+                                    _to_environment_variable_value(value)
+                                )
+                    elif isinstance(validation_alias, str):
+                        env_variables[validation_alias.upper()] = (
+                            _to_environment_variable_value(value)
+                        )
+                else:
+                    env_variables[
+                        f"{self.model_config.get('env_prefix')}{key.upper()}"
+                    ] = _to_environment_variable_value(value)
         return env_variables
 
     @model_serializer(

prefect/settings/models/root.py

@@ -381,7 +381,11 @@ def _warn_on_misconfigured_api_url(settings: "Settings"):
                 warnings_list.append(warning)
 
         parsed_url = urlparse(api_url)
-        if parsed_url.path and not parsed_url.path.startswith("/api"):
+        if (
+            parsed_url.path
+            and "api.prefect.cloud" in api_url
+            and not parsed_url.path.startswith("/api")
+        ):
             warnings_list.append(
                 "`PREFECT_API_URL` should have `/api` after the base URL."
             )

prefect/settings/models/server/api.py

@@ -18,7 +18,7 @@ class ServerAPISettings(PrefectBaseSettings):
 
     auth_string: Optional[SecretStr] = Field(
         default=None,
-        description="A string to use for basic authentication with the API; typically in the form 'user:password' but can be any string.",
+        description="A string to use for basic authentication with the API in the form 'user:password'.",
     )
 
     host: str = Field(
@@ -31,6 +31,12 @@ class ServerAPISettings(PrefectBaseSettings):
         description="The API's port address (defaults to `4200`).",
     )
 
+    base_path: Optional[str] = Field(
+        default=None,
+        description="The base URL path to serve the API under.",
+        examples=["/v2/api"],
+    )
+
     default_limit: int = Field(
         default=200,
         description="The default limit applied to queries that can return multiple objects, such as `POST /flow_runs/filter`.",

prefect/settings/models/server/database.py

@@ -30,6 +30,20 @@ class SQLAlchemyConnectArgsSettings(PrefectBaseSettings):
         description="Controls the application_name field for connections opened from the connection pool when using a PostgreSQL database with the Prefect backend.",
     )
 
+    statement_cache_size: Optional[int] = Field(
+        default=None,
+        description="Controls statement cache size for PostgreSQL connections. Setting this to 0 is required when using PgBouncer in transaction mode. Defaults to None.",
+    )
+
+    prepared_statement_cache_size: Optional[int] = Field(
+        default=None,
+        description=(
+            "Controls the size of the statement cache for PostgreSQL connections. "
+            "When set to 0, statement caching is disabled. Defaults to None to use "
+            "SQLAlchemy's default behavior."
+        ),
+    )
+
 
 class SQLAlchemySettings(PrefectBaseSettings):
     """

{prefect_client-3.2.5.dist-info → prefect_client-3.2.7.dist-info}/METADATA

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

{prefect_client-3.2.5.dist-info → prefect_client-3.2.7.dist-info}/RECORD

@@ -1,19 +1,19 @@
 prefect/.prefectignore,sha256=awSprvKT0vI8a64mEOLrMxhxqcO-b0ERQeYpA2rNKVQ,390
 prefect/__init__.py,sha256=iCdcC5ZmeewikCdnPEP6YBAjPNV5dvfxpYCTpw30Hkw,3685
 prefect/__main__.py,sha256=WFjw3kaYJY6pOTA7WDOgqjsz8zUEUZHCcj3P5wyVa-g,66
-prefect/_build_info.py,sha256=1vJdZsjkUYeGYwN7FaPcsa6XC6UFI8VkJdUSN-inOt8,180
+prefect/_build_info.py,sha256=v72RCwnunuXLYjqd62c-v91feDIddMeaSrKisnM3Nqc,180
 prefect/_result_records.py,sha256=S6QmsODkehGVSzbMm6ig022PYbI6gNKz671p_8kBYx4,7789
 prefect/agent.py,sha256=dPvG1jDGD5HSH7aM2utwtk6RaJ9qg13XjkA0lAIgQmY,287
 prefect/artifacts.py,sha256=dMBUOAWnUamzjb5HSqwB5-GR2Qb-Gxee26XG5NDCUuw,22720
 prefect/automations.py,sha256=ZzPxn2tINdlXTQo805V4rIlbXuNWxd7cdb3gTJxZIeY,12567
 prefect/cache_policies.py,sha256=cF_6eqg34x7XgaCIw6S8Vr-Eq0wIr4Y6t3FOuXaPBrY,11912
 prefect/context.py,sha256=iJe4pkFqX6lz8ax1Mde_YqVmBVWmzeBe0ca2_nT6KPQ,23673
-prefect/engine.py,sha256=4ZGTKFZA_t7K0XUSJqbJ6Ec20SFVFHasBTM--47fTyA,2610
+prefect/engine.py,sha256=uB5JN4l045i5JTlRQNT1x7MwlSiGQ5Bop2Q6jHHOgxY,3699
 prefect/exceptions.py,sha256=-nih8qqdxRm6CX-4yrqwePVh8Mcpvla_V6N_KbdJsIU,11593
 prefect/filesystems.py,sha256=v5YqGB4uXf9Ew2VuB9VCSkawvYMMVvEtZf7w1VmAmr8,18036
-prefect/flow_engine.py,sha256=mW95w_fBpEPejYFXuMyjfnhm7J1jMSv_VtAYGD0VlCo,60226
+prefect/flow_engine.py,sha256=gR44YU7aCAbHEqoMDdxL1SDrtS5Xx1Kzg3M7FWjHcvY,58967
 prefect/flow_runs.py,sha256=MzjfRFgQwOqUSC3Iuu6E0hWkWdn089Urk6BY3qjEwEE,16113
-prefect/flows.py,sha256=cp9TF3pSg73jhkL3SkzaUGbdU9hbsieKz95Wgfk-VA4,108408
+prefect/flows.py,sha256=fE94Xxe2BsVwXoNLkrf57gN4rF-EfK5j1HQrwtXJMKo,108574
 prefect/futures.py,sha256=NYWGeC8uRGe1WWB1MxkUshdvAdYibhc32HdFjffdiW0,17217
 prefect/main.py,sha256=hFeTTrr01qWKcRwZVEHVipyHEybS0VLTscFV6zG6GtY,2306
 prefect/plugins.py,sha256=FPRLR2mWVBMuOnlzeiTD9krlHONZH2rtYLD753JQDNQ,2516
@@ -30,6 +30,7 @@ prefect/tasks.py,sha256=g__kIAXvbvdY7NtK7R-KbJg7qUP31xjf5uK80zRS3Ds,74049
 prefect/transactions.py,sha256=kOXwghBW3jM71gg49MkjJPTnImEzXWeTCUE_zpq2MlI,16068
 prefect/variables.py,sha256=dCK3vX7TbkqXZhnNT_v7rcGh3ISRqoR6pJVLpoll3Js,8342
 prefect/_experimental/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+prefect/_experimental/bundles.py,sha256=7oumoEW7L6ZnRQJhO6ii3BsXIfPkE9Ic3yzX56vauR4,3821
 prefect/_experimental/lineage.py,sha256=8LssReoq7eLtQScUCu-7FCtrWoRZstXKRdpO0PxgbKg,9958
 prefect/_experimental/sla/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 prefect/_experimental/sla/client.py,sha256=XTkYHFZiBy_O7RgUyGEdl9MxaHP-6fEAKBk3ksNQobU,3611
@@ -82,7 +83,7 @@ prefect/client/collections.py,sha256=t9XkVU_onQMZ871L21F1oZnAiPSQeeVfd_MuDEBS3iM
 prefect/client/constants.py,sha256=Z_GG8KF70vbbXxpJuqW5pLnwzujTVeHbcYYRikNmGH0,29
 prefect/client/subscriptions.py,sha256=TZ7Omv8yeQQIkE6EmWYM78e8p7UdvdTDzcQe91dCU4U,3838
 prefect/client/utilities.py,sha256=UEJD6nwYg2mD8-GSmru-E2ofXaBlmSFZ2-8T_5rIK6c,3472
-prefect/client/orchestration/__init__.py,sha256=uKWE1XNiwrOswgZ1JptffksRlji9PDrLcy8T9ZfNw1g,59596
+prefect/client/orchestration/__init__.py,sha256=tP1zxHgrZaICchYM3mcK4zTUpCCihd-0v5V0lTmGivY,60699
 prefect/client/orchestration/base.py,sha256=HM6ryHBZSzuHoCFQM9u5qR5k1dN9Bbr_ah6z1UPNbZQ,1542
 prefect/client/orchestration/routes.py,sha256=JFG1OWUBfrxPKW8Q7XWItlhOrSZ67IOySSoFZ6mxzm0,4364
 prefect/client/orchestration/_artifacts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -154,7 +155,7 @@ prefect/events/worker.py,sha256=HjbibR0_J1W1nnNMZDFTXAbB0cl_cFGaFI87DvNGcnI,4557
 prefect/events/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 prefect/events/cli/automations.py,sha256=uCX3NnypoI25TmyAoyL6qYhanWjZbJ2watwv1nfQMxs,11513
 prefect/events/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-prefect/events/schemas/automations.py,sha256=KE6tIQul--KdJhixMYSCBCpoPIEGPgkGraeLAl3kCS0,14538
+prefect/events/schemas/automations.py,sha256=5uYx18sVf8Mqx-KtfcSGli8x4GkNPUHC8LZZfsDzeBo,14568
 prefect/events/schemas/deployment_triggers.py,sha256=OX9g9eHe0nqJ3PtVEzqs9Ub2LaOHMA4afLZSvSukKGU,3191
 prefect/events/schemas/events.py,sha256=CLh8nHl8zfy0RKvjVzK3qBg_Oe8opu2qyXpMYXqCnHM,9176
 prefect/events/schemas/labelling.py,sha256=bU-XYaHXhI2MEBIHngth96R9D02m8HHb85KNcHZ_1Gc,3073
@@ -174,7 +175,7 @@ prefect/locking/filesystem.py,sha256=O67Miiz466fQUu3UmHer9dkWpVL1f8GEX8Lv2lDj0Y8
 prefect/locking/memory.py,sha256=mFUgV750ywEL7aVQuxFjg9gxbjVU4esBQn7bGQYzeMY,7548
 prefect/locking/protocol.py,sha256=RsfvlaHTTEJ0YvYWSqFGoZuT2w4FPPxyQlHqjoyNGuE,4240
 prefect/logging/__init__.py,sha256=zx9f5_dWrR4DbcTOFBpNGOPoCZ1QcPFudr7zxb2XRpA,148
-prefect/logging/configuration.py,sha256=QIvmktuAZPteVnh8nd9jUb7vwGGkcUbBLyiti6XmbYM,3242
+prefect/logging/configuration.py,sha256=XyHlC31XT00v3hsDg1KKKmKweb8E5fszVKE7BRQ-ebM,3292
 prefect/logging/filters.py,sha256=NnRYubh9dMmWcCAjuW32cIVQ37rLxdn8ci26wTtQMyU,1136
 prefect/logging/formatters.py,sha256=BkPykVyOFKdnhDj_1vhhOoWiHiiBeRnWXPcaRIWK3aI,4125
 prefect/logging/handlers.py,sha256=pIeS6gvuVnuh3lZ-kIC4ijRMSbVPkHo-rYeLMj5P8NA,12240
@@ -182,7 +183,7 @@ prefect/logging/highlighters.py,sha256=BCf_LNhFInIfGPqwuu8YVrGa4wVxNc4YXo2pYgftp
 prefect/logging/loggers.py,sha256=xkmHXsiuoPZZXcrrEgMA-ZQu0E-gW3tNVd4BIxWjnpM,12704
 prefect/logging/logging.yml,sha256=tT7gTyC4NmngFSqFkCdHaw7R0GPNPDDsTCGZQByiJAQ,3169
 prefect/runner/__init__.py,sha256=7U-vAOXFkzMfRz1q8Uv6Otsvc0OrPYLLP44srwkJ_8s,89
-prefect/runner/runner.py,sha256=bR3lR2hEKSHtd4V0gbEM7WDz6rx_trmWuovXy6Ifomc,55656
+prefect/runner/runner.py,sha256=s40phNASP-dj-sDStQTucwaum3Khn4BmxJQzrnZXh1I,60966
 prefect/runner/server.py,sha256=WDDjCbnd2F_3LZBpVX2Y398xpmHvxjyBLKVHWkh5QxI,11240
 prefect/runner/storage.py,sha256=Uxx_7SPm-F0LR1LUq64cT-xHL2ofd37hHqLHtRYjGW0,27527
 prefect/runner/submit.py,sha256=3Ey6H4XrhYhCII4AobpvzZf21vAunWlMu40zAjMC0gc,8353
@@ -216,7 +217,7 @@ prefect/server/api/middleware.py,sha256=WkyuyeJIfo9Q0GAIVU5gO6yIGNVwoHwuBah5AB5o
 prefect/server/api/root.py,sha256=CeumFYIM_BDvPicJH9ry5PO_02PZTLeMqbLMGGTh90o,942
 prefect/server/api/run_history.py,sha256=FHepAgo1AYFeuh7rrAVzo_o3hu8Uc8-4DeH5aD5VGgw,5995
 prefect/server/api/saved_searches.py,sha256=UjoqLLe245QVIs6q5Vk4vdODCOoYzciEEjhi7B8sYCE,3233
-prefect/server/api/server.py,sha256=mAAZ_l0tfcpdnNDvP7-uP8w3f5HkjitpKZlyFBhLrYA,31835
+prefect/server/api/server.py,sha256=W85DhOyIyq5_Cf5ep-YrNd8vF2IB-JzKzqMppIox9Fs,32082
 prefect/server/api/task_run_states.py,sha256=qlMUR4cH943EVgAkHHwTyHznb613VNa4WErEHdwcU60,1568
 prefect/server/api/task_runs.py,sha256=_rZXe2ZJDnOr3kf2MfBPMUI3N_6lbcVkJxvl-A1IKDQ,12160
 prefect/server/api/task_workers.py,sha256=TLvw0DckIqAeIaS3jky9zEF3nT2FII2F7oEE5Kf_13U,950
@@ -233,7 +234,7 @@ prefect/server/api/ui/flows.py,sha256=-g1xKHGBwh59CiILvrK3qlSE9g4boupCh4fl8UvF-i
 prefect/server/api/ui/schemas.py,sha256=moKeBqG9qdCo6yHoxeDnmvHrGoLCerHc4GMEQwzqleU,2050
 prefect/server/api/ui/task_runs.py,sha256=9zKN96k9GD5uUzKWNq_l-JA8ui4OqRhjyN7B3V8IHXs,6667
 prefect/settings/__init__.py,sha256=3jDLzExmq9HsRWo1kTSE16BO_3B3JlVsk5pR0s4PWEQ,2136
-prefect/settings/base.py,sha256=IWCFoDLKecoSlEtscwVlBwbC6KgzBHHwYODhLlOdWX8,8821
+prefect/settings/base.py,sha256=e5huXB_cWgw_N6QWuRNSWMjW6B-g261RbiQ-6RoWFVE,9667
 prefect/settings/constants.py,sha256=5NjVLG1Km9J9I-a6wrq-qmi_dTkPdwEk3IrY9bSxWvw,281
 prefect/settings/context.py,sha256=yKxnaDJHX8e2jmAVtw1RF9o7X4V3AOcz61sVeQyPX2c,2195
 prefect/settings/legacy.py,sha256=KG00GwaURl1zbwfCKAjwNRdJjB2UdTyo80gYF7U60jk,5693
@@ -251,14 +252,14 @@ prefect/settings/models/flows.py,sha256=kQ_sCA7TUqaEs9wWuGHkGQOuAIEZ5elD4UzeKRe0
 prefect/settings/models/internal.py,sha256=KUb16dg3lH5gwlnUnVJub6JHFXHRyZf1voINBvC_Ysc,718
 prefect/settings/models/logging.py,sha256=Sj9GDNr5QMFaP6CN0WJyfpwhpOk4p1yhv45dyQMRzHM,4729
 prefect/settings/models/results.py,sha256=VWFplQSSJyc0LXnziw1H5b3N_PDS32QBe_q2MWwYni0,1484
-prefect/settings/models/root.py,sha256=iExDLqNnaxNYhdWdRWNHUsMX9O_fMXczrGsNInEpmYY,16466
+prefect/settings/models/root.py,sha256=b9ZamM-BcD75Xsk0pZej3o2ix2kHkTP14hhITveFcTo,16549
 prefect/settings/models/runner.py,sha256=rD8OmNLwILmqnGe9YkM1dWKsulx3clYm4LI5N9vD5yM,1991
 prefect/settings/models/tasks.py,sha256=3XSMhOsBFoSOL3e-CL36uOuL-zsl9c3buvTNyGubLWg,3482
 prefect/settings/models/testing.py,sha256=j9YH_WkB14iEzOjUtTmvY978qRSbgCypFSEi_cOs8no,1820
 prefect/settings/models/worker.py,sha256=zeDU71aR4CEvEOKyH-1jgEyol8XYe29PExjIC6a8Wv0,1378
 prefect/settings/models/server/__init__.py,sha256=KJmffmlHb8GYnClaeYcerae-IaeNsNMucKKRRS_zG9Q,33
-prefect/settings/models/server/api.py,sha256=jNmPqEg96h6Q8VFVZfLcAFLWRzzTqtCm2n8CvoA2QxY,5073
-prefect/settings/models/server/database.py,sha256=dJplrENm6f7Wo1XJ7GVKo5hK58vZrEfYXSJ19NCEUfc,10573
+prefect/settings/models/server/api.py,sha256=fhj9pt6RGtUHkyriaTPto4NnOwJD4XWLdIyxuiJ2Dzk,5202
+prefect/settings/models/server/database.py,sha256=Ilw452gS4L1L4tk53JP-G080JblPVdWzdSVxhfuXcXQ,11156
 prefect/settings/models/server/deployments.py,sha256=LjWQr2U1mjItYhuuLqMT_QQ7P4KHqC-tKFfA-rEKefs,898
 prefect/settings/models/server/ephemeral.py,sha256=rh8Py5Nxh-gq9KgfB7CDnIgT_nuOuv59OrLGuhMIGmk,1043
 prefect/settings/models/server/events.py,sha256=s766htbPv2yx7w-09i8BrtAZ_js--AtHYtvXeK7puIk,5578
@@ -316,7 +317,7 @@ prefect/workers/cloud.py,sha256=dPvG1jDGD5HSH7aM2utwtk6RaJ9qg13XjkA0lAIgQmY,287
 prefect/workers/process.py,sha256=6VWon_LK7fQNLlQTjTBFeU4KFUa4faqP4EUuTvrbtbg,20176
 prefect/workers/server.py,sha256=SEuyScZ5nGm2OotdtbHjpvqJlTRVWCh29ND7FeL_fZA,1974
 prefect/workers/utilities.py,sha256=VfPfAlGtTuDj0-Kb8WlMgAuOfgXCdrGAnKMapPSBrwc,2483
-prefect_client-3.2.5.dist-info/METADATA,sha256=OBGigaKyErFGzBn7ZR8OnRnXfrMqrgK8gmbi24WZkxI,7192
-prefect_client-3.2.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-prefect_client-3.2.5.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
-prefect_client-3.2.5.dist-info/RECORD,,
+prefect_client-3.2.7.dist-info/METADATA,sha256=ivVP_miQGh7GYKttza4VAFCOVhdJEK2vd2UQDXE-Kco,7192
+prefect_client-3.2.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+prefect_client-3.2.7.dist-info/licenses/LICENSE,sha256=MCxsn8osAkzfxKC4CC_dLcUkU8DZLkyihZ8mGs3Ah3Q,11357
+prefect_client-3.2.7.dist-info/RECORD,,