prefect-client 3.8.2.dev2__tar.gz → 3.8.2.dev4__tar.gz

{prefect_client-3.8.2.dev2 → prefect_client-3.8.2.dev4}/PKG-INFO

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

prefect_client-3.8.2.dev4/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.8.2.dev4"
+__build_date__ = "2026-08-05 08:59:43.703102+00:00"
+__git_commit__ = "f3e3cd5a0175f716c4a73c26dbe390f2d266408c"
+__dirty__ = False

{prefect_client-3.8.2.dev2 → prefect_client-3.8.2.dev4}/src/prefect/_internal/websockets.py

@@ -14,6 +14,8 @@ from urllib.parse import urlparse
 import certifi
 from websockets.asyncio.client import connect
 
+import prefect
+from prefect.client.constants import SERVER_API_VERSION
 from prefect.settings import get_current_settings
 
 
@@ -51,6 +53,13 @@ def websocket_connect(uri: str, **kwargs: Any) -> connect:
     if ssl_context:
         kwargs.setdefault("ssl", ssl_context)
 
+    # Identify ourselves to the server the same way the HTTP client does so that
+    # the client version can be parsed from the handshake
+    kwargs.setdefault(
+        "user_agent_header",
+        f"prefect/{prefect.__version__} (API {SERVER_API_VERSION})",
+    )
+
     # Add custom headers from settings
     custom_headers = get_current_settings().client.custom_headers
     if custom_headers:

{prefect_client-3.8.2.dev2 → prefect_client-3.8.2.dev4}/src/prefect/context.py

@@ -14,6 +14,7 @@ import warnings
 from collections.abc import AsyncGenerator, Generator, Mapping
 from contextlib import ExitStack, asynccontextmanager, contextmanager
 from contextvars import ContextVar, Token
+from pathlib import Path
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -46,11 +47,13 @@ from prefect.results import (
 )
 from prefect.settings import Profile, Settings
 from prefect.settings.legacy import (
+    Setting,
     _get_settings_fields,  # type: ignore[reportPrivateUsage]
 )
 from prefect.states import State
 from prefect.task_runners import TaskRunner
 from prefect.types import DateTime
+from prefect.utilities.collections import visit_collection
 from prefect.utilities.services import start_client_metrics_server
 
 T = TypeVar("T")
@@ -825,6 +828,21 @@ class SettingsContext(ContextModel):
     def __hash__(self: Self) -> int:
         return hash(self.settings)
 
+    def serialize(self, include_secrets: bool = True) -> dict[str, Any]:
+        """Serialize settings without platform-specific path objects."""
+        serialized = super().serialize(include_secrets=include_secrets)
+        return visit_collection(
+            serialized,
+            visit_fn=lambda value: (
+                value.name
+                if isinstance(value, Setting)
+                else str(value)
+                if isinstance(value, Path)
+                else value
+            ),
+            return_data=True,
+        )
+
     @classmethod
     def get(cls) -> Optional["SettingsContext"]:
         # Return the global context instead of `None` if no context exists

{prefect_client-3.8.2.dev2 → prefect_client-3.8.2.dev4}/src/prefect/events/utilities.py

@@ -49,9 +49,13 @@ def emit_event(
         payload: An open-ended set of data describing what happened.
         id: The sender-provided identifier for this event. Defaults to a random
             UUID.
-        follows: The event that preceded this one. If the preceding event
-            happened more than 5 minutes prior to this event the follows
-            relationship will not be set.
+        follows: The event that preceded this one. Setting `follows`
+            establishes that this event is known to have occurred after the
+            given event, which the system can use to disambiguate the
+            ordering of the two events. Only the `id` and `occurred` of the
+            given event are used; it is not emitted again. If the preceding
+            event happened more than 5 minutes prior to this event the
+            follows relationship will not be set.
 
     Returns:
         The event that was emitted if worker is using a client that emit

{prefect_client-3.8.2.dev2 → prefect_client-3.8.2.dev4}/src/prefect/futures.py

@@ -574,6 +574,8 @@ class PrefectFutureList(list[PrefectFuture[R]], Iterator[PrefectFuture[R]]):
         """
         # Build a mapping from each unique future to every index it occupies
         # so that we can handle duplicates and preserve ordering.
+        if timeout is not None and timeout < 0:
+            raise ValueError(f"'timeout' must be a non-negative number, got {timeout}")
         future_to_indices: dict[PrefectFuture[R], list[int]] = {}
         for idx, future in enumerate(self):
             future_to_indices.setdefault(future, []).append(idx)
@@ -629,6 +631,8 @@ def _register_prefect_done_callback(
 def as_completed(
     futures: list[PrefectFuture[R]], timeout: float | None = None
 ) -> Generator[PrefectFuture[R], None]:
+    if timeout is not None and timeout < 0:
+        raise ValueError(f"'timeout' must be a non-negative number, got {timeout}")
     unique_futures: set[PrefectFuture[R]] = set(futures)
     total_futures = len(unique_futures)
     pending = unique_futures
@@ -720,6 +724,8 @@ def wait(
             print(f"Not Done: {len(not_done)}")
         ```
     """
+    if timeout is not None and timeout < 0:
+        raise ValueError(f"'timeout' must be a non-negative number, got {timeout}")
     _futures = set(futures)
     done = {f for f in _futures if f._final_state}
     not_done = _futures - done

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

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.8.2.dev2"
-__build_date__ = "2026-08-03 09:15:43.484194+00:00"
-__git_commit__ = "05c045c68360e723560d61d5231824b55b811db1"
-__dirty__ = False