prefect-client 3.7.4.dev1__tar.gz → 3.7.4.dev2__tar.gz

{prefect_client-3.7.4.dev1 → prefect_client-3.7.4.dev2}/PKG-INFO

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

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

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.4.dev2"
+__build_date__ = "2026-06-03 09:44:19.961091+00:00"
+__git_commit__ = "24ebdd47271b0f77b3704903bfadb3374e4a487f"
+__dirty__ = False

{prefect_client-3.7.4.dev1 → prefect_client-3.7.4.dev2}/src/prefect/client/orchestration/_automations/client.py

@@ -10,6 +10,8 @@ from prefect.exceptions import ObjectNotFound
 if TYPE_CHECKING:
     from uuid import UUID
 
+    from prefect.client.schemas.sorting import AutomationSort
+    from prefect.events.filters import AutomationFilter
     from prefect.events.schemas.automations import Automation, AutomationCore
 
 
@@ -37,8 +39,24 @@ class AutomationClient(BaseClient):
         )
         response.raise_for_status()
 
-    def read_automations(self) -> list["Automation"]:
-        response = self.request("POST", "/automations/filter")
+    def read_automations(
+        self,
+        *,
+        automations: "AutomationFilter | None" = None,
+        sort: "AutomationSort | None" = None,
+        limit: int | None = None,
+        offset: int = 0,
+    ) -> list["Automation"]:
+        body: dict[str, object] = {
+            "automations": (
+                automations.model_dump(mode="json") if automations else None
+            ),
+            "sort": sort,
+            "limit": limit,
+            "offset": offset,
+        }
+
+        response = self.request("POST", "/automations/filter", json=body)
         response.raise_for_status()
         from prefect.events.schemas.automations import Automation
 
@@ -196,8 +214,24 @@ class AutomationAsyncClient(BaseAsyncClient):
         )
         response.raise_for_status()
 
-    async def read_automations(self) -> list["Automation"]:
-        response = await self.request("POST", "/automations/filter")
+    async def read_automations(
+        self,
+        *,
+        automations: "AutomationFilter | None" = None,
+        sort: "AutomationSort | None" = None,
+        limit: int | None = None,
+        offset: int = 0,
+    ) -> list["Automation"]:
+        body: dict[str, object] = {
+            "automations": (
+                automations.model_dump(mode="json") if automations else None
+            ),
+            "sort": sort,
+            "limit": limit,
+            "offset": offset,
+        }
+
+        response = await self.request("POST", "/automations/filter", json=body)
         response.raise_for_status()
         from prefect.events.schemas.automations import Automation
 

{prefect_client-3.7.4.dev1 → prefect_client-3.7.4.dev2}/src/prefect/events/filters.py

@@ -32,6 +32,25 @@ class AutomationFilterName(PrefectBaseModel):
     )
 
 
+class AutomationFilterTags(PrefectBaseModel):
+    """Filter by `Automation.tags`."""
+
+    all_: Optional[list[str]] = Field(
+        default=None,
+        examples=[["tag-1", "tag-2"]],
+        description="A list of tags. Automations will be returned only if their tags are a superset of the list",
+    )
+    any_: Optional[list[str]] = Field(
+        default=None,
+        examples=[["tag-1", "tag-2"]],
+        description="A list of tags. Automations will be returned if their tags contain any of the tags in the list",
+    )
+    is_null_: Optional[bool] = Field(
+        default=None,
+        description="If true, only include automations without tags",
+    )
+
+
 class AutomationFilter(PrefectBaseModel):
     name: Optional[AutomationFilterName] = Field(
         default=None, description="Filter criteria for `Automation.name`"
@@ -39,6 +58,9 @@ class AutomationFilter(PrefectBaseModel):
     created: Optional[AutomationFilterCreated] = Field(
         default=None, description="Filter criteria for `Automation.created`"
     )
+    tags: Optional[AutomationFilterTags] = Field(
+        default=None, description="Filter criteria for `Automation.tags`"
+    )
 
 
 class EventDataFilter(PrefectBaseModel, extra="forbid"):  # type: ignore[call-arg]

{prefect_client-3.7.4.dev1 → prefect_client-3.7.4.dev2}/src/prefect/runner/_workspace_starter.py

@@ -1,9 +1,12 @@
 from __future__ import annotations
 
+import functools
 import os
 import shutil
+import site
 import subprocess
 import sys
+import sysconfig
 from contextlib import contextmanager
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, Iterable, Iterator
@@ -109,14 +112,83 @@ def _workspace_sys_path(workspace: PreparedWorkspace) -> list[str]:
     return entries
 
 
+@functools.lru_cache(maxsize=1)
+def _stdlib_prefixes() -> tuple[str, ...]:
+    """Resolved stdlib directory prefixes whose children should not land on PYTHONPATH."""
+    roots: set[str] = set()
+    paths = sysconfig.get_paths()
+    for key in ("stdlib", "platstdlib"):
+        val = paths.get(key)
+        if val:
+            roots.add(str(Path(val).resolve()))
+    return tuple(sorted(roots))
+
+
+@functools.lru_cache(maxsize=1)
+def _site_packages_dirs() -> tuple[str, ...]:
+    """Resolved site-packages directories that should always be kept."""
+    dirs: set[str] = set()
+    paths = sysconfig.get_paths()
+    for key in ("purelib", "platlib"):
+        val = paths.get(key)
+        if val:
+            dirs.add(str(Path(val).resolve()))
+    try:
+        for sp in site.getsitepackages():
+            dirs.add(str(Path(sp).resolve()))
+    except AttributeError:
+        pass
+    try:
+        usp = site.getusersitepackages()
+        if isinstance(usp, str):
+            dirs.add(str(Path(usp).resolve()))
+    except AttributeError:
+        pass
+    return tuple(sorted(dirs))
+
+
+def _is_stdlib_path(entry: str) -> bool:
+    """True when *entry* is a stdlib, lib-dynload, or stdlib zip path.
+
+    Site-packages directories that live under the stdlib tree are kept.
+    Only interpreter stdlib zip archives next to stdlib directories are filtered;
+    user archives like `/app/python_deps.zip` are preserved.
+    """
+    if not entry:
+        return False
+
+    resolved_path = Path(entry).resolve()
+    resolved = str(resolved_path)
+
+    for sp in _site_packages_dirs():
+        if resolved == sp or resolved.startswith(sp + os.sep):
+            return False
+
+    for root in _stdlib_prefixes():
+        if resolved == root or resolved.startswith(root + os.sep):
+            return True
+
+    interpreter_zip_name = f"python{sys.version_info.major}{sys.version_info.minor}.zip"
+    if resolved_path.name == interpreter_zip_name:
+        resolved_parent = str(resolved_path.parent)
+        stdlib_parents = {str(Path(r).parent) for r in _stdlib_prefixes()}
+        if resolved_parent in stdlib_parents:
+            return True
+
+    return False
+
+
 def workspace_environment(workspace: PreparedWorkspace) -> dict[str, str]:
     environment = dict(workspace.environment)
-    pythonpath_entries = _workspace_sys_path(workspace)
+    pythonpath_entries: list[str] = []
+    candidate_entries = _workspace_sys_path(workspace)
     existing_pythonpath = environment.get("PYTHONPATH")
     if existing_pythonpath:
-        for entry in existing_pythonpath.split(os.pathsep):
-            if entry and entry not in pythonpath_entries:
-                pythonpath_entries.append(entry)
+        candidate_entries.extend(existing_pythonpath.split(os.pathsep))
+
+    for entry in candidate_entries:
+        if entry and entry not in pythonpath_entries and not _is_stdlib_path(entry):
+            pythonpath_entries.append(entry)
 
     environment["PYTHONPATH"] = os.pathsep.join(pythonpath_entries)
     return environment

{prefect_client-3.7.4.dev1 → prefect_client-3.7.4.dev2}/src/prefect/settings/AGENTS.md

@@ -118,3 +118,5 @@ from prefect.settings.context import get_current_settings
 settings = get_current_settings()
 value = settings.server.services.my_service.my_setting
 ```
+
+`temporary_settings()` accepts both legacy `Setting` objects and dotted-path string keys (e.g., `"server.api.host"`) or uppercase env var names (e.g., `"PREFECT_SERVER_API_HOST"`). Prefer string keys in new tests to avoid importing legacy `Setting` objects.

{prefect_client-3.7.4.dev1 → prefect_client-3.7.4.dev2}/src/prefect/settings/models/server/worker_channel.py

@@ -20,8 +20,8 @@ class ServerWorkerChannelSettings(PrefectBaseSettings):
         description=(
             "The module to use for storing worker cleanup delivery messages. "
             "The default in-memory backend stores messages, leases, wakeups, "
-            "and dead-letter entries only in the current server process; use a "
-            "Redis-backed storage module for high availability or restart-safe "
+            "and dead-letter entries only in the current server process; use "
+            "an external storage module for high availability or restart-safe "
             "cleanup delivery."
         ),
     )
@@ -47,8 +47,8 @@ class ServerWorkerChannelSettings(PrefectBaseSettings):
         description=(
             "How long completed cleanup idempotency records are retained after "
             "acknowledgement. None keeps them for the lifetime of the current "
-            "server process. The in-memory backend does not survive restart; "
-            "use Redis for high availability or restart-safe cleanup "
+            "server process. The in-memory backend does not survive restart; use "
+            "external storage for high availability or restart-safe cleanup "
             "idempotency."
         ),
     )

{prefect_client-3.7.4.dev1 → prefect_client-3.7.4.dev2}/src/prefect/utilities/pydantic.py

@@ -333,7 +333,8 @@ def parse_obj_as(
     origin: Optional[Any] = get_origin(type_)
     if origin is list and isinstance(data, dict):
         values_dict: dict[Any, Any] = data
-        data = next(iter(values_dict.values()))
+        if values_dict:
+            data = next(iter(values_dict.values()))
 
     parser: Callable[[Any], T] = getattr(adapter, f"validate_{mode}")
 

prefect_client-3.7.4.dev1/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.7.4.dev1"
-__build_date__ = "2026-06-02 09:34:21.527796+00:00"
-__git_commit__ = "c3a0c69aea9a86496ab326717bdab26a0f434fbc"
-__dirty__ = False