prefect-client 3.8.9.dev7__tar.gz → 3.9.1__tar.gz

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.5
 Name: prefect-client
-Version: 3.8.9.dev7
+Version: 3.9.1
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
-Project-URL: Documentation, https://docs.prefect.io
+Project-URL: Documentation, https://www.prefect.io/docs
 Project-URL: Source, https://github.com/PrefectHQ/prefect
 Project-URL: Tracker, https://github.com/PrefectHQ/prefect/issues
 Author-email: "Prefect Technologies, Inc." <help@prefect.io>
@@ -18,17 +18,19 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Libraries
-Requires-Python: <3.15,>=3.11
+Requires-Python: <3.16,>=3.11
 Requires-Dist: amplitude-analytics<2.0.0,>=1.2.1
 Requires-Dist: anyio<5.0.0,>=4.4.0
 Requires-Dist: asgi-lifespan<3.0,>=1.0
 Requires-Dist: cachetools<8.0,>=5.3
+Requires-Dist: certifi>=2026.10.19
 Requires-Dist: cloudpickle<4.0,>=2.0
 Requires-Dist: coolname<6.0.0,>=1.0.4
 Requires-Dist: dateparser<2.0.0,>=1.1.1
 Requires-Dist: exceptiongroup>=1.0.0
-Requires-Dist: fastapi<1.0.0,>=0.139.0
+Requires-Dist: fastapi<0.151,>=0.139.0
 Requires-Dist: fsspec>=2022.5.0
 Requires-Dist: graphviz>=0.20.1
 Requires-Dist: griffe<3.0.0,>=0.49.0
@@ -48,22 +50,21 @@ Requires-Dist: pydantic-core<3.0.0,>=2.12.0
 Requires-Dist: pydantic-extra-types<3.0.0,>=2.8.2
 Requires-Dist: pydantic-settings<3.0.0,>=2.9.1
 Requires-Dist: python-dateutil<3.0.0,>=2.8.2
-Requires-Dist: python-slugify<9.1,>=9
+Requires-Dist: python-slugify<9.2,>=9
 Requires-Dist: pytz<2027,>=2021.1
 Requires-Dist: pyyaml<7.0.0,>=5.4.1
 Requires-Dist: rfc3339-validator<0.2.0,>=0.1.4
 Requires-Dist: rich<16.0,>=11.0
-Requires-Dist: ruamel-yaml-clib>=0.2.8; platform_python_implementation == 'CPython'
-Requires-Dist: ruamel-yaml>=0.17.0
+Requires-Dist: ruamel-yaml!=0.19.0,>=0.17.0
 Requires-Dist: sniffio<2.0.0,>=1.3.0
 Requires-Dist: starlette>=1.0.1
 Requires-Dist: toml>=0.10.0
 Requires-Dist: typing-extensions<5.0.0,>=4.10.0
 Requires-Dist: uvicorn!=0.29.0,>=0.14.0
 Requires-Dist: websockets<17.0,>=15.0.1
-Requires-Dist: whenever<0.11.0,>=0.7.3; python_version >= '3.13'
+Requires-Dist: whenever<0.12.0,>=0.10.5; python_version >= '3.13'
 Provides-Extra: notifications
-Requires-Dist: apprise<2.0.0,>=1.13.0; extra == 'notifications'
+Requires-Dist: apprise<2.1.0,>=1.13.0; extra == 'notifications'
 Description-Content-Type: text/markdown
 
 <p align="center"><img src="https://github.com/PrefectHQ/prefect/assets/3407835/c654cbc6-63e8-4ada-a92a-efd2f8f24b85" width=1000></p>
@@ -162,7 +163,7 @@ describing the functionality you are interested in using and we will do our best
 ## Next steps
 
 There's lots more you can do to orchestrate and observe your workflows with Prefect!
-Start with our [friendly tutorial](https://docs.prefect.io/tutorials) or explore the [core concepts of Prefect workflows](https://docs.prefect.io/concepts/).
+Start with our [friendly tutorial](https://www.prefect.io/docs/v3/get-started/quickstart) or explore the [core concepts of Prefect workflows](https://www.prefect.io/docs/concepts/).
 
 ## Join the community
 
@@ -172,6 +173,6 @@ All community forums, including code contributions, issue discussions, and Slack
 
 ## Contribute
 
-See our [documentation on contributing to Prefect](https://docs.prefect.io/contributing/overview/).
+See our [documentation on contributing to Prefect](https://www.prefect.io/docs/contribute).
 
 Thanks for being part of the mission to build a new kind of workflow system and, of course, **happy engineering!**

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/README.md

@@ -94,7 +94,7 @@ describing the functionality you are interested in using and we will do our best
 ## Next steps
 
 There's lots more you can do to orchestrate and observe your workflows with Prefect!
-Start with our [friendly tutorial](https://docs.prefect.io/tutorials) or explore the [core concepts of Prefect workflows](https://docs.prefect.io/concepts/).
+Start with our [friendly tutorial](https://www.prefect.io/docs/v3/get-started/quickstart) or explore the [core concepts of Prefect workflows](https://www.prefect.io/docs/concepts/).
 
 ## Join the community
 
@@ -104,6 +104,6 @@ All community forums, including code contributions, issue discussions, and Slack
 
 ## Contribute
 
-See our [documentation on contributing to Prefect](https://docs.prefect.io/contributing/overview/).
+See our [documentation on contributing to Prefect](https://www.prefect.io/docs/contribute).
 
 Thanks for being part of the mission to build a new kind of workflow system and, of course, **happy engineering!**

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/pyproject.toml

@@ -7,7 +7,7 @@ name = "prefect-client"
 dynamic = ["version"]
 description = "Workflow orchestration and management."
 readme = "README.md"
-requires-python = ">=3.11,<3.15"
+requires-python = ">=3.11,<3.16"
 license = { text = "Apache-2.0" }
 authors = [{ name = "Prefect Technologies, Inc.", email = "help@prefect.io" }]
 classifiers = [
@@ -20,6 +20,7 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Topic :: Software Development :: Libraries",
 ]
 dependencies = [
@@ -28,11 +29,13 @@ dependencies = [
     "anyio>=4.4.0,<5.0.0",
     "asgi-lifespan>=1.0,<3.0",
     "cachetools>=5.3,<8.0",
+    "certifi>=2026.10.19",
     "cloudpickle>=2.0,<4.0",
     "coolname>=1.0.4,<6.0.0",
     "dateparser>=1.1.1,<2.0.0",
     "exceptiongroup>=1.0.0",
-    "fastapi>=0.139.0,<1.0.0",
+    # 0.151 rejects an explicit null for a body param with a default, and released clients send null
+    "fastapi>=0.139.0,<0.151",
     "fsspec>=2022.5.0",
     "graphviz>=0.20.1",
     "griffe>=0.49.0,<3.0.0",
@@ -52,28 +55,27 @@ dependencies = [
     "pydantic_extra_types>=2.8.2,<3.0.0",
     "pydantic_settings>=2.9.1,<3.0.0",
     "python-dateutil>=2.8.2,<3.0.0",
-    "python-slugify>=9,<9.1",
+    "python-slugify>=9,<9.2",
     "pytz>=2021.1,<2027",
     "pyyaml>=5.4.1,<7.0.0",
     "rfc3339-validator>=0.1.4,<0.2.0",
     "rich>=11.0,<16.0",
-    "ruamel.yaml>=0.17.0",
-    "ruamel.yaml.clib>=0.2.8; platform_python_implementation == 'CPython'",
+    "ruamel.yaml>=0.17.0,!=0.19.0",
     "sniffio>=1.3.0,<2.0.0",
     "starlette>=1.0.1",
     "toml>=0.10.0",
     "typing_extensions>=4.10.0,<5.0.0",
     "uvicorn>=0.14.0,!=0.29.0",
     "websockets>=15.0.1,<17.0",
-    "whenever>=0.7.3,<0.11.0; python_version>='3.13'",
+    "whenever>=0.10.5,<0.12.0; python_version>='3.13'",
 ]
 [project.urls]
 Changelog = "https://github.com/PrefectHQ/prefect/releases"
-Documentation = "https://docs.prefect.io"
+Documentation = "https://www.prefect.io/docs"
 Source = "https://github.com/PrefectHQ/prefect"
 Tracker = "https://github.com/PrefectHQ/prefect/issues"
 [project.optional-dependencies]
-notifications = ["apprise>=1.13.0, <2.0.0"]
+notifications = ["apprise>=1.13.0, <2.1.0"]
 
 
 [tool.hatch.version]

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/AGENTS.md

@@ -6,6 +6,10 @@ The foundation for building and executing workflows with Python. This covers the
 
 There is no formal public/private boundary beyond the `_` prefix convention. Modules and functions prefixed with `_` are internal. Everything else is considered public and requires backward compatibility.
 
+## Runtime Parameter Defaults
+
+Runtime flow/task parameter values must come from `utilities.callables.get_call_parameters` or `get_parameter_defaults`: raw signature defaults can be `pydantic.Field(...)` objects. These helpers unwrap `FieldInfo` defaults; schema generation intentionally retains `FieldInfo` to preserve metadata.
+
 ## Entry Points
 
 - `flows.py` / `tasks.py` — `@flow` and `@task` decorator definitions. The primary user-facing API.
@@ -25,7 +29,8 @@ There is no formal public/private boundary beyond the `_` prefix convention. Mod
 - **Sync and async must stay in sync.** Both `flow_engine.py` and `task_engine.py` have sync and async paths. Any behavior change must be applied to both.
 - **Event and log WebSocket subscribers are parallel implementations.** `events/clients.py::PrefectEventSubscriber` and `logging/clients.py::PrefectLogsSubscriber` duplicate the same reconnect/backoff/dedup logic, including the `reconnect_on_clean_close` option (used by `events/subscribers.py::FlowRunSubscriber` so a clean disconnect doesn't hide a terminal event). Mirror any reconnection-behavior change across both.
 - **Flow run observers own their stream recovery.** `_internal/observers.py` observers create subscribers with `reconnection_attempts=0` and delegate polling fallback, reconnect backoff, and setup deadlines to `_internal/_observation_delivery.py::ObservationDelivery`. Subscribers close any socket left by a failed or cancelled `__aenter__`, since callers never exit a context that failed to enter.
-- **Use `whenever` compat helpers for all datetime conversions on Python 3.13+.** `types/_datetime.py` provides `now()`, `_whenever_to_stdlib()`, `_whenever_zdt_from_py()`, and `_whenever_pdt_from_py()` to abstract over API differences between whenever 0.7.x–0.9.x and ≥ 0.10.0. The `_WHENEVER_NEW_API` flag (True when whenever ≥ 0.10.0) guards version-specific code. Never call `DateTime.now()` or `pendulum.now()` directly — use `now()` from `types/_datetime.py` instead. Avoid no-argument `datetime.datetime.now()` because it returns a tz-naive datetime that raises `TypeError` when compared to the tz-aware datetimes produced by `now()`. Explicitly timezone-aware stdlib calls such as `datetime.now(ZoneInfo("UTC"))` are allowed when needed to preserve timezone information. Never call `ZonedDateTime.from_py_datetime()`, `PlainDateTime.from_py_datetime()`, or `.py_datetime()` directly — use the helpers instead. Violations will silently break on whichever whenever version the helpers weren't written for.
+- **Use `whenever` compat helpers for all datetime conversions on Python 3.13+.** `prefect-client` depends on `whenever` only on Python 3.13+, so modules it ships must keep `whenever` imports behind `sys.version_info >= (3, 13)`; only server code that the client build strips may import it unconditionally (see `client/AGENTS.md`). `types/_datetime.py` provides `now()`, `_whenever_to_stdlib()`, `_whenever_zdt_from_py()`, and `_whenever_pdt_from_py()` to abstract over API differences across supported whenever releases. Version-specific code is guarded by feature-detection flags (`_WHENEVER_NEW_API` for ≥ 0.10.0, `_SYSTEM_TZ` for ≥ 0.11), not version checks. Never call `DateTime.now()` or `pendulum.now()` directly — use `now()` from `types/_datetime.py` instead. Avoid no-argument `datetime.datetime.now()` because it returns a tz-naive datetime that raises `TypeError` when compared to the tz-aware datetimes produced by `now()`. Explicitly timezone-aware stdlib calls such as `datetime.now(ZoneInfo("UTC"))` are allowed when needed to preserve timezone information. Never call `ZonedDateTime.from_py_datetime()`, `PlainDateTime.from_py_datetime()`, or `.py_datetime()` directly — use the helpers instead. Likewise avoid `.assume_system_tz()`/`.to_system_tz()` (deprecated in 0.11; the warning fails tests under `filterwarnings = error`) — use `in_local_tz()` — and direct `DateTimeDelta` imports (removed in 0.11) — use the `Interval` alias. Violations will silently break on whichever whenever version the helpers weren't written for.
+- **Call Pendulum-only members via `types/_datetime.py::_pendulum_call` on Python 3.11/3.12.** Prefect's `DateTime`/`Date`/`Duration` wrap Pendulum-only members (and some shared stdlib methods like `replace`) with user-facing deprecation warnings; `_pendulum_call` bypasses them so users only see warnings for their own calls. `pyproject.toml` ignores these warnings in pytest, so direct calls from Prefect code pass tests silently unless covered by the guards in `tests/test_datetime.py`.
 - **Flow and task engines advance state differently.** The flow engine makes blocking API calls to the server to propose and advance states. The task engine emits `prefect.task_run.*` events (delivered via WebSockets) but advances state locally through `set_state` calls with polling/backoff — do not assume the two engines work the same way.
 - **Flow state transitions go through the server.** The flow engine proposes states to the server, which accepts or rejects them via orchestration rules. The task engine, by contrast, manages state transitions locally via `set_state` and emits `prefect.task_run.*` events — it does not propose states to the server.
 - **`ProcessPoolTaskRunner` requires picklable data across subprocess boundaries.** `PrefectFuture` objects are not picklable and cannot be passed to worker subprocesses. Any `wait_for` futures must be waited on in the parent process and converted to `State` objects before submission. The subprocess task engine handles `State` objects via `resolve_to_final_result`, which raises `UpstreamTaskError` for non-completed upstreams.
@@ -69,3 +74,7 @@ Use `get_logger()` from `prefect.logging` instead of raw `logging.getLogger()`
 - `docker/` → `DockerImage` class for building and pushing Docker images during deployment
 - `telemetry/` → OS-level resource metric collection and run telemetry
 - `testing/` → Test utilities shipped with the SDK: `prefect_test_harness`, assertion helpers, and reusable fixtures (see testing/AGENTS.md)
+
+## Multi-pass Templating
+
+When applying `utilities.templating.apply_values` in stages, use `remove_notset=False` on passes that must preserve placeholders for later values. The default drops unresolved whole-value dict entries and list items and blanks unresolved inline placeholders. This matters when deployment preparation applies environment values before build/push outputs exist; only remove unresolved values when the caller has reached its final resolution pass.

prefect_client-3.9.1/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.9.1"
+__build_date__ = "2026-10-30 15:51:33.909810+00:00"
+__git_commit__ = "bd4807c3f402e0390e945527178e746a4ca3a6d7"
+__dirty__ = False

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/_internal/analytics/notice.py

@@ -14,7 +14,7 @@ from prefect.settings import get_current_settings
 NOTICE_TEXT = """
 Prefect collects anonymous usage data to improve the product.
 To opt out: set PREFECT_SERVER_ANALYTICS_ENABLED=false on the server, or DO_NOT_TRACK=1 in the client.
-Learn more: https://docs.prefect.io/concepts/telemetry
+Learn more: https://www.prefect.io/docs/concepts/telemetry
 """
 
 

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/_internal/compatibility/deprecated.py

@@ -21,7 +21,7 @@ from typing import TYPE_CHECKING, Any, Callable, Optional, Union
 from pydantic import BaseModel
 from typing_extensions import ParamSpec, TypeAlias, TypeVar
 
-from prefect.types._datetime import now
+from prefect.types._datetime import _pendulum_call, now
 from prefect.utilities.callables import get_call_parameters
 from prefect.utilities.importtools import (
     AliasedModuleDefinition,
@@ -96,14 +96,16 @@ def generate_deprecation_message(
                 if hasattr(PlainDateTime, "to_stdlib")
                 else PlainDateTime.from_py_datetime
             )
-            _dt = _pdt_from_dt(start_date).add(months=6)
+            # PlainDateTime requires a naive datetime; the warning only renders
+            # month and year, so any tzinfo on start_date is dropped.
+            _dt = _pdt_from_dt(start_date.replace(tzinfo=None)).add(months=6)
             end_date = (
                 _dt.to_stdlib() if hasattr(_dt, "to_stdlib") else _dt.py_datetime()
             )
         else:
             import pendulum
 
-            end_date = pendulum.instance(start_date).add(months=6)
+            end_date = _pendulum_call(pendulum.instance(start_date), "add", months=6)
 
     if when:
         when = " when " + when

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/_internal/compatibility/migration.py

@@ -59,7 +59,7 @@ MOVED_IN_V3 = {
     "prefect.client:get_client": "prefect.client.orchestration:get_client",
 }
 
-upgrade_guide_msg = "Refer to the upgrade guide for more information: https://docs.prefect.io/v3/how-to-guides/migrate/upgrade-agents-to-workers."
+upgrade_guide_msg = "Refer to the upgrade guide for more information: https://www.prefect.io/docs/v3/how-to-guides/migrate/upgrade-agents-to-workers."
 
 REMOVED_IN_V3 = {
     "prefect.client.schemas.objects:MinimalDeploymentSchedule": "Use `prefect.client.schemas.actions.DeploymentScheduleCreate` instead.",

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/_internal/concurrency/services.py

@@ -27,6 +27,11 @@ R = TypeVar("R", infer_variance=True)
 # Track all active services for fork handling
 _active_services: weakref.WeakSet[_QueueServiceBase[Any]] = weakref.WeakSet()
 
+# Services take items that are already queued without leaving the event loop.
+# Other services share the global loop, so a service working through a backlog
+# yields to them after this many items in a row.
+_READY_ITEMS_PER_YIELD = 256
+
 
 def _reset_services_after_fork():
     """
@@ -73,6 +78,7 @@ class _QueueServiceBase(abc.ABC, Generic[T]):
         self._started: bool = False
         self._key = hash((self.__class__, *args))
         self._lock = threading.Lock()
+        self._ready_items_since_yield = 0
         self._queue_get_thread = WorkerThread(
             # TODO: This thread should not need to be a daemon but when it is not, it
             #       can prevent the interpreter from exiting.
@@ -184,14 +190,37 @@ class _QueueServiceBase(abc.ABC, Generic[T]):
             assert self._done_event is not None
             self._done_event.set()
 
+    async def _get_item(self, timeout: Optional[float] = None) -> Optional[T]:
+        """
+        Take the next item from the queue.
+
+        An item that is already queued is taken on the event loop. Only an empty
+        queue waits on the queue thread, which raises `queue.Empty` if `timeout`
+        passes first.
+        """
+        if self._ready_items_since_yield >= _READY_ITEMS_PER_YIELD:
+            self._ready_items_since_yield = 0
+            await asyncio.sleep(0)
+
+        try:
+            item = self._queue.get_nowait()
+        except queue.Empty:
+            pass
+        else:
+            self._ready_items_since_yield += 1
+            return item
+
+        self._ready_items_since_yield = 0
+        return await self._queue_get_thread.submit(
+            create_call(self._queue.get, timeout=timeout)
+        ).aresult()
+
     async def _main_loop(self) -> None:
         last_log_time = 0
         log_interval = 4  # log every 4 seconds
 
         while True:
-            item: Optional[T] = await self._queue_get_thread.submit(
-                create_call(self._queue.get)
-            ).aresult()
+            item: Optional[T] = await self._get_item()
 
             if self._stopped:
                 current_time = asyncio.get_event_loop().time()
@@ -242,8 +271,9 @@ class _QueueServiceBase(abc.ABC, Generic[T]):
 
         self._stop(at_exit=at_exit)
 
-        assert self._done_event is not None
-        if self._done_event.is_set():
+        # `_done_event` is unset if the service never started in this process, e.g.
+        # in a child process after `reset_for_fork`
+        if self._done_event is None or self._done_event.is_set():
             future: concurrent.futures.Future[bool] = concurrent.futures.Future()
             future.set_result(False)
             return future
@@ -500,9 +530,7 @@ class BatchedQueueService(QueueService[T]):
             deadline = get_deadline(self.min_interval)
             while batch_size < self.max_batch_size:
                 try:
-                    item = await self._queue_get_thread.submit(
-                        create_call(self._queue.get, timeout=get_timeout(deadline))
-                    ).aresult()
+                    item = await self._get_item(timeout=get_timeout(deadline))
 
                     if item is None:
                         done = True

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/_internal/result_records.py

@@ -37,6 +37,7 @@ if TYPE_CHECKING:
 ResultSerializer = Union[Serializer, str]
 LITERAL_TYPES: set[type] = {type(None), bool, UUID}
 R = TypeVar("R")
+_LEGACY_RESULT_BLOB_KEYS = {"serializer", "data", "prefect_version", "expiration"}
 
 
 class ResultRecordMetadata(BaseModel):
@@ -173,16 +174,19 @@ class ResultRecord(BaseModel, Generic[R]):
         if isinstance(value, dict):
             if TYPE_CHECKING:  # TODO: # isintance doesn't accept generic parameters
                 value = cast(dict[str, Any], value)
-            if "data" in value:
+            # Only coerce the exact legacy `PersistedResultBlob` shape so that raw
+            # JSON results that happen to contain a `data` key aren't misread
+            if (
+                {"data", "serializer"} <= value.keys() <= _LEGACY_RESULT_BLOB_KEYS
+                and isinstance(value["data"], str)
+                and isinstance(value["serializer"], dict)
+            ):
                 value["result"] = value.pop("data")
-            if "metadata" not in value:
-                value["metadata"] = {}
-            if "expiration" in value:
-                value["metadata"]["expiration"] = value.pop("expiration")
-            if "serializer" in value:
-                value["metadata"]["serializer"] = value.pop("serializer")
-            if "prefect_version" in value:
-                value["metadata"]["prefect_version"] = value.pop("prefect_version")
+                value["metadata"] = {"serializer": value.pop("serializer")}
+                if "expiration" in value:
+                    value["metadata"]["expiration"] = value.pop("expiration")
+                if "prefect_version" in value:
+                    value["metadata"]["prefect_version"] = value.pop("prefect_version")
         return value
 
     def serialize_metadata(self) -> bytes:

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/artifacts.py

@@ -34,7 +34,7 @@ logger: "logging.Logger" = get_logger("artifacts")
 class Artifact(ArtifactRequest):
     """
     An artifact is a piece of data that is created by a flow or task run.
-    https://docs.prefect.io/latest/develop/artifacts
+    https://www.prefect.io/docs/latest/develop/artifacts
 
     Arguments:
         type: A string identifying the type of artifact.

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/blocks/notifications.py

@@ -47,7 +47,7 @@ class AbstractAppriseNotificationBlock(NotificationBlock, ABC):
         )
 
         self._apprise_client = Apprise(asset=prefect_app_data)
-        self._apprise_client.add(servers=url.get_secret_value())  # pyright: ignore[reportUnknownMemberType]
+        self._apprise_client.add(url.get_secret_value())  # pyright: ignore[reportUnknownMemberType]
 
     def block_initialization(self) -> None:
         self._start_apprise_client(getattr(self, "url"))
@@ -104,7 +104,7 @@ class AppriseNotificationBlock(AbstractAppriseNotificationBlock, ABC):
     """
 
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
     url: SecretStr = Field(
         default=...,
@@ -173,7 +173,7 @@ class SlackWebhook(AppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/slack.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     url: SecretStr = Field(
@@ -270,7 +270,7 @@ class MicrosoftTeamsWebhook(AppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/microsoft-teams.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     url: SecretStr = Field(
@@ -332,7 +332,7 @@ class PagerDutyWebHook(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/pagerduty.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     # PagerDuty requires a valid severity level from its PAGERDUTY_SEVERITY_MAP
@@ -488,7 +488,7 @@ class TwilioSMS(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/twilio.png"
     )  # noqa
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     account_sid: str = Field(
@@ -563,7 +563,7 @@ class OpsgenieWebhook(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/opsgenie.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     apikey: SecretStr = Field(
@@ -688,7 +688,7 @@ class MattermostWebhook(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/mattermost.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     hostname: str = Field(
@@ -790,7 +790,7 @@ class DiscordWebhook(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/discord.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     webhook_id: SecretStr = Field(
@@ -895,7 +895,7 @@ class CustomWebhookNotificationBlock(NotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/webhook.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     name: str = Field(title="Name", description="Name of the webhook.")
@@ -1065,7 +1065,7 @@ class SendgridEmail(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/email.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     api_key: SecretStr = Field(
@@ -1115,9 +1115,7 @@ class SendgridEmail(AbstractAppriseNotificationBlock):
         """Update apprise client with current to_emails before sending."""
         if hasattr(self, "_apprise_client") and self._apprise_client:
             self._apprise_client.clear()
-            self._apprise_client.add(
-                servers=self._build_sendgrid_url().get_secret_value()
-            )
+            self._apprise_client.add(self._build_sendgrid_url().get_secret_value())
 
     async def anotify(
         self,

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/blocks/system.py

@@ -47,7 +47,7 @@ class Secret(Block, Generic[T]):
     _logo_url = HttpUrl(
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/secret.png"
     )
-    _documentation_url = HttpUrl("https://docs.prefect.io/latest/develop/blocks")
+    _documentation_url = HttpUrl("https://www.prefect.io/docs/latest/develop/blocks")
     _description = "A block that represents a secret value. The value stored in this block will be obfuscated when this block is viewed or edited in the UI."
 
     value: Union[SecretStr, PydanticSecret[T]] = Field(

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/blocks/webhook.py

@@ -33,7 +33,7 @@ class Webhook(Block):
     _block_type_name = "Webhook"
     _logo_url = "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/webhook.png"  # type: ignore
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/webhook-triggers"
+        "https://www.prefect.io/docs/latest/automate/events/webhook-triggers"
     )
 
     method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] = Field(

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/cache_policies.py

@@ -4,6 +4,7 @@ from copy import deepcopy
 from dataclasses import dataclass, field, replace
 from logging import Logger
 from pathlib import Path
+from types import CodeType
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -45,9 +46,10 @@ def _register_stable_transforms() -> None:
     if sys.modules.get("pandas") is not None:
         import pandas as pd  # pyright: ignore
 
-        STABLE_TRANSFORMS[pd.DataFrame] = lambda df: [  # pyright: ignore
-            df[col] for col in sorted(df.columns)
-        ]
+        STABLE_TRANSFORMS[pd.DataFrame] = lambda df: (  # pyright: ignore
+            list(df.columns),
+            [df.iloc[:, i] for i in range(len(df.columns))],
+        )
 
 
 @dataclass
@@ -282,6 +284,19 @@ class _None(CachePolicy):
         return other
 
 
+def _normalize_code_location(code: CodeType) -> CodeType:
+    """Remove compilation locations, including those in nested code constants."""
+    return code.replace(
+        co_filename="",
+        co_firstlineno=1,
+        co_linetable=b"",
+        co_consts=tuple(
+            _normalize_code_location(const) if isinstance(const, CodeType) else const
+            for const in code.co_consts
+        ),
+    )
+
+
 @dataclass
 class TaskSource(CachePolicy):
     """
@@ -312,7 +327,10 @@ class TaskSource(CachePolicy):
             lines = inspect.getsource(task_ctx.task.fn.__class__)
         except OSError as exc:
             if "source code" in str(exc):
-                lines = task_ctx.task.fn.__code__.co_code
+                return hash_objects(
+                    _normalize_code_location(task_ctx.task.fn.__code__),
+                    raise_on_failure=True,
+                )
             else:
                 raise
 

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/client/__init__.py

@@ -1,5 +1,5 @@
 """
-Asynchronous client implementation for communicating with the [Prefect REST API](https://docs.prefect.io/v3/api-ref/rest-api/).
+Asynchronous client implementation for communicating with the [Prefect REST API](https://www.prefect.io/docs/v3/api-ref/rest-api/).
 
 Explore the client by communicating with an in-memory webserver - no setup required:
 

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/client/orchestration/__init__.py

@@ -296,7 +296,7 @@ class PrefectClient(
     EventAsyncClient,
 ):
     """
-    An asynchronous client for interacting with the [Prefect REST API](https://docs.prefect.io/v3/api-ref/rest-api/).
+    An asynchronous client for interacting with the [Prefect REST API](https://www.prefect.io/docs/v3/api-ref/rest-api/).
 
     Args:
         api: the REST API URL or FastAPI application to connect to
@@ -1243,7 +1243,7 @@ class SyncPrefectClient(
     EventClient,
 ):
     """
-    A synchronous client for interacting with the [Prefect REST API](https://docs.prefect.io/v3/api-ref/rest-api/).
+    A synchronous client for interacting with the [Prefect REST API](https://www.prefect.io/docs/v3/api-ref/rest-api/).
 
     Args:
         api: the REST API URL or FastAPI application to connect to

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/client/orchestration/_work_pools/client.py

@@ -525,6 +525,8 @@ class WorkPoolAsyncClient(BaseAsyncClient):
                 json=work_pool.model_dump(mode="json", exclude_unset=True),
             )
         except HTTPStatusError as e:
+            if e.response.status_code == 403 and "plan does not support" in str(e):
+                raise ObjectUnsupported(http_exc=e) from e
             if e.response.status_code == 409:
                 if overwrite:
                     existing_work_pool = await self.read_work_pool(

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/client/schemas/sorting.py

@@ -25,6 +25,8 @@ class TaskRunSort(AutoEnum):
     NAME_DESC = AutoEnum.auto()
     NEXT_SCHEDULED_START_TIME_ASC = AutoEnum.auto()
     END_TIME_DESC = AutoEnum.auto()
+    DURATION_DESC = AutoEnum.auto()
+    DURATION_ASC = AutoEnum.auto()
 
 
 class AutomationSort(AutoEnum):

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/context.py

@@ -3,7 +3,7 @@ Async and thread safe models for passing runtime context data.
 
 These contexts should never be directly mutated by the user.
 
-For more user-accessible information about the current run, see [`prefect.runtime`](https://docs.prefect.io/v3/api-ref/python/prefect-runtime-flow_run).
+For more user-accessible information about the current run, see [`prefect.runtime`](https://www.prefect.io/docs/v3/api-ref/python/prefect-runtime-flow_run).
 """
 
 import asyncio

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1}/src/prefect/deployments/base.py

@@ -2,7 +2,7 @@
 Core primitives for managing Prefect deployments via `prefect deploy`, providing a minimally opinionated
 build system for managing flows and deployments.
 
-To get started, follow along with [the deployments tutorial](https://docs.prefect.io/v3/how-to-guides/deployments/create-deployments).
+To get started, follow along with [the deployments tutorial](https://www.prefect.io/docs/v3/how-to-guides/deployments/create-deployments).
 """
 
 from __future__ import annotations