prefect-client 3.6.27.dev4__tar.gz → 3.6.27.dev5__tar.gz

{prefect_client-3.6.27.dev4 → prefect_client-3.6.27.dev5}/PKG-INFO

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

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

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.6.27.dev5"
+__build_date__ = "2026-04-16 21:12:02.023498+00:00"
+__git_commit__ = "03b8cad670c313d68d0bf8e87b0256e525713aa5"
+__dirty__ = False

{prefect_client-3.6.27.dev4 → prefect_client-3.6.27.dev5}/src/prefect/flow_engine.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import asyncio
+import contextvars
 import datetime
 import logging
 import multiprocessing
@@ -292,7 +293,19 @@ def _send_heartbeats(
                     return
                 time.sleep(1)
 
-    thread = threading.Thread(target=heartbeat_loop, daemon=True)
+    # Copy the current context so the heartbeat thread sees the same
+    # `SettingsContext` (and therefore the same `PREFECT_API_URL`) as the
+    # calling thread. Without this, `threading.Thread` starts with an empty
+    # context and `SettingsContext.get()` falls back to the process-wide
+    # `GLOBAL_SETTINGS_CONTEXT`, which is initialized at import time and can
+    # have a stale `api.url=None`. That caused `EventsWorker.instance()` from
+    # the heartbeat path to spawn an ephemeral `SubprocessASGIServer` during
+    # flow teardown, racing with interpreter shutdown and aborting the
+    # process.
+    heartbeat_ctx = contextvars.copy_context()
+    thread = threading.Thread(
+        target=heartbeat_ctx.run, args=(heartbeat_loop,), daemon=True
+    )
     thread.start()
     engine.logger.debug("Started flow run heartbeat context")
 

{prefect_client-3.6.27.dev4 → prefect_client-3.6.27.dev5}/src/prefect/utilities/AGENTS.md

@@ -70,12 +70,14 @@ Handlers return `Placeholder` subclasses (e.g. `RemoveValue`, `InvalidJSON`, `In
 ## Pitfalls
 
 - `maybe_template(s)` (in `templating.py`) only checks whether a string looks like it contains a Jinja expression — it does not validate that it's well-formed. A string with `{{` but no `}}` returns `True`.
+- **`resolve_block_document_references` raises `ValueError` for malformed block placeholders.** Placeholders must follow the format `prefect.blocks.<block-type-slug>.<block-document-name>` (at least two dot-separated parts after the prefix). A placeholder like `{{ prefect.blocks.only-type }}` (missing the document name) raises `ValueError` before any network call is made.
 - `HydrationContext` workspace variables are loaded once at build time. Stale contexts don't reflect variable updates made after context creation.
 - **Non-UTF-8 subprocess output is silently replaced.** `consume_process_output` and `stream_text` (via `TextReceiveStream(errors="replace")`) replace invalid bytes with the Unicode replacement character `\ufffd` rather than raising. If captured output contains `\ufffd`, the subprocess emitted bytes that were not valid UTF-8.
 - **`parameters_to_args_kwargs` adjusts the positional/keyword split based on the wrapper's signature, not the wrapped function's.** For `@functools.wraps`-decorated callables, it inspects the *wrapper* (via `follow_wrapped=False`) to count how many positional slots are actually available and routes excess parameters to `**kwargs`. This means `args` and `kwargs` from this function are shaped for the *wrapper* call, not the inner function — callers must not assume all POSITIONAL_OR_KEYWORD parameters end up in `args`.
 - **`parameters_to_args_kwargs` skips the positional-to-keyword rewrite entirely when the function signature contains `*args`.** Inserting KEYWORD_ONLY parameters before a VAR_POSITIONAL parameter is invalid in Python, so the original signature is used as-is in that case.
 - **Passing the same key in both an explicit parameter and a `**kwargs` dict raises `TypeError`.** `parameters_to_args_kwargs` detects when a VAR_KEYWORD (`**kwargs`) dict contains a key that also appears as an explicit parameter and raises rather than silently letting the variadic entry win. Exception: POSITIONAL_ONLY parameters are exempt because `fn(1, **{'a': 2})` is legal when `a` is positional-only.
 - **`filter_files` with `include_dirs=True` (the default) always includes all ancestor directories of matched files**, even if those directories weren't directly matched by the ignore patterns. This ensures `shutil.copytree`'s `ignore_func` doesn't skip directories containing files that should be copied. Side effect: callers expecting only pathspec-matched entries will receive additional directory paths. The parent-dir expansion does NOT run when `include_dirs=False`.
+- **`generate_parameter_schema` silently downgrades unsupported parameter types to `Any`.** When a parameter's type raises `ValueError`, `TypeError`, or `PydanticInvalidForJsonSchema` during JSON schema generation (e.g., `Callable`, custom types Pydantic can't serialize), the type is replaced with `Any` in the output schema without warning. If a flow parameter shows up as `Any` in the schema, the declared type is not JSON-schema-compatible.
 - **Never access `EngineContext.run_results` directly via `id(obj)`.** Always call `get_state_for_result(obj)`.
 - **`command_to_string` always uses POSIX quoting (`shlex.join`), even on Windows.** This is intentional for platform-neutral storage — bundle commands are serialized by one platform and may be deserialized by another. `command_from_string` uses a dual-path approach: if the string was POSIX-serialized by Prefect (round-trips cleanly through `shlex.split`/`shlex.join`), it uses POSIX parsing; otherwise it falls back to native Windows command-line parsing (`CommandLineToArgvW`). Do not use `" ".join(command)` or `shlex.split(command)` directly when working with stored Prefect commands — use these helpers instead.
 - **`get_sys_executable()` no longer quotes the Python path on Windows.** It previously returned `'"path/to/python"'` (with embedded quotes) on Windows; now it returns the raw path. Code relying on the old quoted form (e.g., joining into a shell string) will break — use `subprocess.list2cmdline` or `command_to_string` for shell-safe serialization instead.

{prefect_client-3.6.27.dev4 → prefect_client-3.6.27.dev5}/src/prefect/utilities/callables.py

@@ -16,6 +16,7 @@ from typing import Any, Callable, Optional, Union, cast
 import cloudpickle  # type: ignore  # no stubs available
 import pydantic
 from griffe import Docstring, DocstringSectionKind, Parser, parse
+from pydantic.errors import PydanticInvalidForJsonSchema
 from typing_extensions import Literal, TypeVar
 
 from prefect._internal.pydantic.v1_schema import has_v1_type_as_param
@@ -571,7 +572,7 @@ def generate_parameter_schema(
         # type supports schema generation
         try:
             create_schema("CheckParameter", model_fields={name: (type_, field)})
-        except (ValueError, TypeError):
+        except (ValueError, TypeError, PydanticInvalidForJsonSchema):
             # This field's type is not valid for schema creation, update it to `Any`
             type_ = Any
         model_fields[name] = (type_, field)

{prefect_client-3.6.27.dev4 → prefect_client-3.6.27.dev5}/src/prefect/utilities/templating.py

@@ -364,6 +364,11 @@ async def resolve_block_document_references(
             parts = placeholder.name.replace(
                 BLOCK_DOCUMENT_PLACEHOLDER_PREFIX, ""
             ).split(".", 2)
+            if len(parts) < 2:
+                raise ValueError(
+                    f"Invalid block placeholder format: '{placeholder.name}'. "
+                    "Expected format: prefect.blocks.<block-type-slug>.<block-document-name>"
+                )
             block_type_slug, block_document_name, *value_keypath = parts
             block_document = await client.read_block_document_by_name(
                 name=block_document_name, block_type_slug=block_type_slug

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

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.6.27.dev4"
-__build_date__ = "2026-04-16 08:40:58.203919+00:00"
-__git_commit__ = "08aeda82f675d686e68b1f6a53fe10ad5aac48da"
-__dirty__ = False