prefect-client 3.7.9.dev5__tar.gz → 3.7.9.dev7__tar.gz

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.7.9.dev5
+Version: 3.7.9.dev7
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
@@ -22,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: <3.15,>=3.10
 Requires-Dist: amplitude-analytics<2.0.0,>=1.2.1
-Requires-Dist: anyio<5.0.0,>=4.4.0
+Requires-Dist: anyio!=4.14.2,<5.0.0,>=4.4.0
 Requires-Dist: asgi-lifespan<3.0,>=1.0
 Requires-Dist: cachetools<8.0,>=5.3
 Requires-Dist: cloudpickle<4.0,>=2.0
@@ -41,7 +41,7 @@ Requires-Dist: jsonschema<5.0.0,>=4.18.0
 Requires-Dist: opentelemetry-api<2.0.0,>=1.27.0
 Requires-Dist: orjson<4.0,>=3.7
 Requires-Dist: packaging<26.3,>=21.3
-Requires-Dist: pathspec>=0.8.0
+Requires-Dist: pathspec>=0.10.1
 Requires-Dist: pendulum<4,>=3.1.0; python_version < '3.13'
 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

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/pyproject.toml

@@ -26,7 +26,7 @@ classifiers = [
 dependencies = [
     # Client dependencies
     "amplitude-analytics>=1.2.1,<2.0.0",
-    "anyio>=4.4.0,<5.0.0",
+    "anyio>=4.4.0,<5.0.0,!=4.14.2",
     "asgi-lifespan>=1.0,<3.0",
     "cachetools>=5.3,<8.0",
     "cloudpickle>=2.0,<4.0",
@@ -45,7 +45,7 @@ dependencies = [
     "opentelemetry-api>=1.27.0,<2.0.0",
     "orjson>=3.7,<4.0",
     "packaging>=21.3,<26.3",
-    "pathspec>=0.8.0",
+    "pathspec>=0.10.1",
     "pendulum>=3.1.0,<4; python_version<'3.13'",
     "prometheus-client>=0.20.0",
     "pydantic>=2.10.1,<3.0.0,!=2.11.0,!=2.11.1,!=2.11.2,!=2.11.3,!=2.11.4",

prefect_client-3.7.9.dev7/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.9.dev7"
+__build_date__ = "2026-07-23 08:57:53.374271+00:00"
+__git_commit__ = "d13f1a728248b608aaa609e6c27f667f47ea4704"
+__dirty__ = False

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/src/prefect/bundles/_file_collector.py

@@ -232,7 +232,7 @@ class FileCollector:
         inner_pattern = pattern[1:]
 
         # Compile the pattern using gitignore-style matching
-        spec = pathspec.PathSpec.from_lines("gitwildmatch", [inner_pattern])
+        spec = pathspec.GitIgnoreSpec.from_lines([inner_pattern])
 
         # Find files in current collection that match the negation
         excluded: list[Path] = []
@@ -342,7 +342,7 @@ class FileCollector:
             List of collected file paths matching the pattern.
         """
         # Compile the pattern using gitignore-style matching
-        spec = pathspec.PathSpec.from_lines("gitwildmatch", [pattern])
+        spec = pathspec.GitIgnoreSpec.from_lines([pattern])
 
         collected: list[Path] = []
         try:

prefect_client-3.7.9.dev7/src/prefect/logging/filters.py

@@ -0,0 +1,105 @@
+import logging
+from collections.abc import Mapping
+from typing import Any
+
+from prefect.utilities.names import obfuscate
+
+
+class _RedactedString(str):
+    """
+    A `str` subclass that stores a separate `repr` value.
+
+    This allows logging's `%r` and `%a` conversions to use a redacted
+    representation while `%s` and JSON serialization use the redacted
+    `str` value.
+    """
+
+    __slots__ = ("_repr",)
+
+    def __new__(cls, str_value: str, repr_value: str) -> "_RedactedString":
+        instance = super().__new__(cls, str_value)
+        instance._repr = repr_value
+        return instance
+
+    def __repr__(self) -> str:
+        return self._repr
+
+    def __reduce__(self) -> tuple[type, tuple[str, str]]:
+        return (type(self), (str(self), self._repr))
+
+
+def redact_substr(obj: Any, substr: str) -> Any:
+    """
+    Redact a string from a potentially nested object.
+
+    Standard collections (list, tuple, set, dict, and other `Mapping`
+    instances) are traversed recursively and have their string values redacted
+    while preserving shape. Non-container objects are redacted by replacing
+    their `str` and `repr` values with obfuscated versions, avoiding the
+    need to reconstruct arbitrary user objects (e.g. dataclasses with
+    `init=False` fields or Pydantic models).
+
+    Args:
+        obj: The object to redact the string from
+        substr: The string to redact.
+
+    Returns:
+        Any: The object with the API key redacted.
+    """
+    if isinstance(obj, str):
+        return obj.replace(substr, obfuscate(substr))
+
+    if isinstance(obj, (list, tuple, set)):
+        seq = obj
+        items = [redact_substr(item, substr) for item in seq]
+        if all(item is orig for item, orig in zip(items, seq)):
+            return obj
+        # Preserve namedtuple types.
+        if hasattr(type(seq), "_make"):
+            return type(seq)._make(items)
+        return type(seq)(items)
+
+    if isinstance(obj, Mapping):
+        mapping = obj
+        items = [
+            (redact_substr(key, substr), redact_substr(value, substr))
+            for key, value in mapping.items()
+        ]
+        if all(
+            k1 is k2 and v1 is v2 for (k1, v1), (k2, v2) in zip(items, mapping.items())
+        ):
+            return obj
+        # Return a plain dict so that arbitrary Mapping types (e.g. ChainMap)
+        # can still be formatted by logging's `%` operator and serialized as
+        # JSON without reconstructing the original mapping type.
+        return dict(items)
+
+    # For opaque objects, redact their rendered string representations.  This
+    # handles exceptions, dataclasses, Pydantic models, and other lazy logging
+    # arguments whose `__str__` or `__repr__` may contain the secret.
+    str_value = str(obj)
+    repr_value = repr(obj)
+    redacted_str = str_value.replace(substr, obfuscate(substr))
+    redacted_repr = repr_value.replace(substr, obfuscate(substr))
+    if redacted_str is not str_value or redacted_repr is not repr_value:
+        return _RedactedString(redacted_str, redacted_repr)
+
+    return obj
+
+
+class ObfuscateApiKeyFilter(logging.Filter):
+    """
+    A logging filter that obfuscates any string that matches the obfuscate_string function.
+    """
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        # Need to import here to avoid circular imports
+        from prefect.settings import PREFECT_API_KEY
+
+        api_key = PREFECT_API_KEY.value()
+        if api_key:
+            record.msg = redact_substr(record.msg, api_key)
+            if record.args is not None:
+                record.args = redact_substr(record.args, api_key)
+
+        return True

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/src/prefect/runner/_workspace_starter.py

@@ -126,7 +126,7 @@ def _stdlib_prefixes() -> tuple[str, ...]:
 
 @functools.lru_cache(maxsize=1)
 def _site_packages_dirs() -> tuple[str, ...]:
-    """Resolved site-packages directories that should always be kept."""
+    """Resolved site-packages directories that should not be promoted to PYTHONPATH."""
     dirs: set[str] = set()
     paths = sysconfig.get_paths()
     for key in ("purelib", "platlib"):
@@ -147,12 +147,14 @@ def _site_packages_dirs() -> tuple[str, ...]:
     return tuple(sorted(dirs))
 
 
-def _is_stdlib_path(entry: str) -> bool:
-    """True when *entry* is a stdlib, lib-dynload, or stdlib zip path.
+def _is_interpreter_path(entry: str) -> bool:
+    """True when *entry* is managed by the interpreter rather than the workspace.
 
-    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.
+    The interpreter already adds stdlib, lib-dynload, and site-packages directories
+    in the correct order. Adding any of them to PYTHONPATH changes that ordering and
+    can let a site-packages backport shadow a standard-library module. 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
@@ -160,9 +162,11 @@ def _is_stdlib_path(entry: str) -> bool:
     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
+    site_packages_dirs = _site_packages_dirs()
+    if resolved in site_packages_dirs:
+        return True
+    if any(resolved.startswith(sp + os.sep) for sp in site_packages_dirs):
+        return False
 
     for root in _stdlib_prefixes():
         if resolved == root or resolved.startswith(root + os.sep):
@@ -187,7 +191,11 @@ def workspace_environment(workspace: PreparedWorkspace) -> dict[str, str]:
         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):
+        if (
+            entry
+            and entry not in pythonpath_entries
+            and not _is_interpreter_path(entry)
+        ):
             pythonpath_entries.append(entry)
 
     environment["PYTHONPATH"] = os.pathsep.join(pythonpath_entries)

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/src/prefect/server/api/deployments.py

@@ -609,7 +609,7 @@ async def paginate_deployments(
         results=results,
         count=count,
         limit=limit,
-        pages=(count + limit - 1) // limit,
+        pages=(count + limit - 1) // limit if limit > 0 else 0,
         page=page,
     )
 

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/src/prefect/server/api/flow_runs.py

@@ -1044,7 +1044,7 @@ async def paginate_flow_runs(
         results=results,
         count=count,
         limit=limit,
-        pages=(count + limit - 1) // limit,
+        pages=(count + limit - 1) // limit if limit > 0 else 0,
         page=page,
     ).model_dump(mode="json")
 

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/src/prefect/server/api/flows.py

@@ -255,6 +255,6 @@ async def paginate_flows(
         results=results,
         count=count,
         limit=limit,
-        pages=(count + limit - 1) // limit,
+        pages=(count + limit - 1) // limit if limit > 0 else 0,
         page=page,
     )

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/src/prefect/server/api/task_runs.py

@@ -264,7 +264,7 @@ async def paginate_task_runs(
             results=runs,
             count=total_count,
             limit=limit,
-            pages=(total_count + limit - 1) // limit,
+            pages=(total_count + limit - 1) // limit if limit > 0 else 0,
             page=page,
         )
     )

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/src/prefect/settings/sources.py

@@ -1,5 +1,6 @@
 import os
 import sys
+import threading
 import warnings
 from pathlib import Path
 from typing import Any, Dict, List, Mapping, Optional, Sequence, Tuple, Type, get_origin
@@ -26,16 +27,23 @@ from prefect.settings.constants import DEFAULT_PREFECT_HOME, DEFAULT_PROFILES_PA
 from prefect.utilities.collections import get_from_dict
 
 _file_cache: TTLCache[str, dict[str, Any]] = TTLCache(maxsize=100, ttl=60)
+_file_cache_lock = threading.Lock()
 
 
 def _read_toml_file(path: Path) -> dict[str, Any]:
-    """use ttl cache to cache toml files"""
+    """use ttl cache to cache toml files
+
+    `TTLCache` is not thread-safe, so all access is guarded by a lock to avoid
+    corrupting its internal state under concurrent settings loads.
+    """
     modified_time = path.stat().st_mtime
     cache_key = f"toml_file:{path}:{modified_time}"
-    if value := _file_cache.get(cache_key):
-        return value
+    with _file_cache_lock:
+        if value := _file_cache.get(cache_key):
+            return value
     data = tomllib.loads(path.read_text(encoding="utf-8"))  # type: ignore
-    _file_cache[cache_key] = data
+    with _file_cache_lock:
+        _file_cache[cache_key] = data
     return data
 
 

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/src/prefect/task_runners.py

@@ -572,22 +572,31 @@ def _enqueue_process_pool_log(message_queue: Any, log_payload: dict[str, Any]) -
     message_queue.put((_PROCESS_POOL_MESSAGE_TYPE_LOG, log_payload))
 
 
-def _initialize_process_pool_worker(message_queue: Any | None = None) -> None:
+def _initialize_process_pool_worker(
+    message_queue: Any | None = None,
+    initializer: Callable[..., None] | None = None,
+    initargs: tuple[Any, ...] = (),
+) -> None:
     """
     Configure process-pool workers to forward emitted events and API logs back to
     the parent process.
+
+    If a user `initializer` is provided, it runs after Prefect's own setup so that
+    it can rely on event/log forwarding already being in place.
     """
     if message_queue is None:
         EventsWorker.set_client_override(None)
         set_api_log_sink(None)
-        return
+    else:
+        EventsWorker.set_client_override(
+            ProcessPoolForwardingEventsClient,
+            event_queue=message_queue,
+            item_type=_PROCESS_POOL_MESSAGE_TYPE_EVENT,
+        )
+        set_api_log_sink(partial(_enqueue_process_pool_log, message_queue))
 
-    EventsWorker.set_client_override(
-        ProcessPoolForwardingEventsClient,
-        event_queue=message_queue,
-        item_type=_PROCESS_POOL_MESSAGE_TYPE_EVENT,
-    )
-    set_api_log_sink(partial(_enqueue_process_pool_log, message_queue))
+    if initializer is not None:
+        initializer(*initargs)
 
 
 def _run_task_in_subprocess(
@@ -748,6 +757,10 @@ class ProcessPoolTaskRunner(TaskRunner[PrefectConcurrentFuture[Any]]):
     Attributes:
         max_workers: The maximum number of processes to use for executing tasks.
             Defaults to `multiprocessing.cpu_count()` if `PREFECT_TASKS_RUNNER_PROCESS_POOL_MAX_WORKERS` is not set.
+        initializer: An optional picklable callable run once in each worker
+            subprocess before it executes any tasks, mirroring
+            `ProcessPoolExecutor`'s `initializer`.
+        initargs: A tuple of arguments passed to `initializer`.
 
     Examples:
         Use a process pool task runner with a flow:
@@ -803,6 +816,21 @@ class ProcessPoolTaskRunner(TaskRunner[PrefectConcurrentFuture[Any]]):
             ...
         ```
 
+        Run custom setup in each worker subprocess:
+
+        ```python
+        import sys
+        from prefect.task_runners import ProcessPoolTaskRunner
+
+        def add_to_path(*paths):
+            sys.path[:0] = paths
+
+        runner = ProcessPoolTaskRunner(
+            initializer=add_to_path,
+            initargs=("/opt/my_app/libs",),
+        )
+        ```
+
     Note:
         Process pool task runners provide process isolation but have overhead for
         inter-process communication. They are most beneficial for CPU-bound tasks
@@ -823,6 +851,8 @@ class ProcessPoolTaskRunner(TaskRunner[PrefectConcurrentFuture[Any]]):
         subprocess_message_processor_factories: (
             Iterable[_SubprocessMessageProcessorFactory] | None
         ) = None,
+        initializer: Callable[..., None] | None = None,
+        initargs: tuple[Any, ...] = (),
     ):
         super().__init__()
         current_settings = get_current_settings()
@@ -833,6 +863,8 @@ class ProcessPoolTaskRunner(TaskRunner[PrefectConcurrentFuture[Any]]):
             or current_settings.tasks.runner.process_pool_max_workers
             or multiprocessing.cpu_count()
         )
+        self._initializer = initializer
+        self._initargs = tuple(initargs)
         self._cancel_events: dict[uuid.UUID, multiprocessing.Event] = {}
         self._subprocess_message_queue: Any | None = None
         self._message_forwarding_thread: threading.Thread | None = None
@@ -844,6 +876,9 @@ class ProcessPoolTaskRunner(TaskRunner[PrefectConcurrentFuture[Any]]):
 
     def duplicate(self) -> Self:
         duplicate_runner = type(self)(max_workers=self._max_workers)
+        # Set post-construction so subclasses that narrow __init__ still duplicate.
+        duplicate_runner._initializer = getattr(self, "_initializer", None)
+        duplicate_runner._initargs = getattr(self, "_initargs", ())
         duplicate_runner.subprocess_message_processor_factories = (
             self.subprocess_message_processor_factories
         )
@@ -1265,7 +1300,11 @@ class ProcessPoolTaskRunner(TaskRunner[PrefectConcurrentFuture[Any]]):
                 max_workers=self._max_workers,
                 mp_context=mp_context,
                 initializer=_initialize_process_pool_worker,
-                initargs=(self._subprocess_message_queue,),
+                initargs=(
+                    self._subprocess_message_queue,
+                    getattr(self, "_initializer", None),
+                    getattr(self, "_initargs", ()),
+                ),
             )
             # Create a thread pool for resolving futures before submitting to process pool
             self._resolver_executor = ThreadPoolExecutor(max_workers=self._max_workers)

{prefect_client-3.7.9.dev5 → prefect_client-3.7.9.dev7}/src/prefect/utilities/filesystem/__init__.py

@@ -45,7 +45,7 @@ def filter_files(
 
     The specification matches that of [.gitignore files](https://git-scm.com/docs/gitignore).
     """
-    spec = pathspec.PathSpec.from_lines("gitwildmatch", ignore_patterns or [])
+    spec = pathspec.GitIgnoreSpec.from_lines(ignore_patterns or [])
     ignored_files = {p.path for p in spec.match_tree_entries(root)}
     if include_dirs:
         all_files = {p.path for p in pathspec.util.iter_tree_entries(root)}

prefect_client-3.7.9.dev5/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.7.9.dev5"
-__build_date__ = "2026-07-21 08:58:32.807456+00:00"
-__git_commit__ = "e8d311f1f3f3b947f585f520f9dcfd9e96720dce"
-__dirty__ = False

prefect_client-3.7.9.dev5/src/prefect/logging/filters.py

@@ -1,41 +0,0 @@
-import logging
-from typing import Any
-
-from prefect.utilities.collections import visit_collection
-from prefect.utilities.names import obfuscate
-
-
-def redact_substr(obj: Any, substr: str) -> Any:
-    """
-    Redact a string from a potentially nested object.
-
-    Args:
-        obj: The object to redact the string from
-        substr: The string to redact.
-
-    Returns:
-        Any: The object with the API key redacted.
-    """
-
-    def redact_item(item: Any) -> Any:
-        if isinstance(item, str):
-            return item.replace(substr, obfuscate(substr))
-        return item
-
-    redacted_obj = visit_collection(obj, visit_fn=redact_item, return_data=True)
-    return redacted_obj
-
-
-class ObfuscateApiKeyFilter(logging.Filter):
-    """
-    A logging filter that obfuscates any string that matches the obfuscate_string function.
-    """
-
-    def filter(self, record: logging.LogRecord) -> bool:
-        # Need to import here to avoid circular imports
-        from prefect.settings import PREFECT_API_KEY
-
-        if PREFECT_API_KEY:
-            record.msg = redact_substr(record.msg, PREFECT_API_KEY.value())
-
-        return True