prefect 3.4.15.dev2__tar.gz → 3.4.15.dev4__tar.gz

{prefect-3.4.15.dev2 → prefect-3.4.15.dev4}/PKG-INFO

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

prefect-3.4.15.dev4/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.4.15.dev4"
+__build_date__ = "2025-08-29 08:09:06.883788+00:00"
+__git_commit__ = "9a19b450d14625cabdd34f3d1c67c904a17af3a9"
+__dirty__ = False

{prefect-3.4.15.dev2 → prefect-3.4.15.dev4}/src/prefect/events/actions.py

@@ -1,4 +1,5 @@
 import abc
+from datetime import timedelta
 from typing import Any, Dict, Optional, Union
 from uuid import UUID
 
@@ -7,6 +8,7 @@ from typing_extensions import Literal, Self, TypeAlias
 
 from prefect._internal.schemas.bases import PrefectBaseModel
 from prefect.client.schemas.objects import StateType
+from prefect.types import NonNegativeTimeDelta
 
 
 class Action(PrefectBaseModel, abc.ABC):
@@ -74,6 +76,13 @@ class RunDeployment(DeploymentAction):
             "to use the deployment's default job variables"
         ),
     )
+    schedule_after: NonNegativeTimeDelta = Field(
+        default_factory=lambda: timedelta(0),
+        description=(
+            "The amount of time to wait before running the deployment. "
+            "Defaults to running the deployment immediately."
+        ),
+    )
 
 
 class PauseDeployment(DeploymentAction):

{prefect-3.4.15.dev2 → prefect-3.4.15.dev4}/src/prefect/events/schemas/automations.py

@@ -5,6 +5,7 @@ import textwrap
 from datetime import timedelta
 from enum import Enum
 from typing import (
+    Annotated,
     Any,
     Dict,
     List,
@@ -17,8 +18,10 @@ from typing import (
 from uuid import UUID
 
 from pydantic import (
+    Discriminator,
     Field,
     PrivateAttr,
+    Tag,
     field_validator,
     model_validator,
 )
@@ -68,6 +71,7 @@ class Trigger(PrefectBaseModel, abc.ABC, extra="ignore"):  # type: ignore[call-a
                 deployment_id=self._deployment_id,
                 parameters=getattr(self, "parameters", None),
                 job_variables=getattr(self, "job_variables", None),
+                schedule_after=getattr(self, "schedule_after", timedelta(0)),
             )
         ]
 
@@ -395,8 +399,33 @@ class SequenceTrigger(CompositeTrigger):
         )
 
 
-TriggerTypes: TypeAlias = Union[
-    EventTrigger, MetricTrigger, CompoundTrigger, SequenceTrigger
+def trigger_discriminator(value: Any) -> str:
+    """Discriminator for triggers that defaults to 'event' if no type is specified."""
+    if isinstance(value, dict):
+        # Check for explicit type first
+        if "type" in value:
+            return value["type"]
+        # Check for compound/sequence specific fields
+        if "triggers" in value and "require" in value:
+            return "compound"
+        if "triggers" in value and "require" not in value:
+            return "sequence"
+        # Check for metric-specific posture
+        if value.get("posture") == "Metric":
+            return "metric"
+        # Default to event
+        return "event"
+    return getattr(value, "type", "event")
+
+
+TriggerTypes: TypeAlias = Annotated[
+    Union[
+        Annotated[EventTrigger, Tag("event")],
+        Annotated[MetricTrigger, Tag("metric")],
+        Annotated[CompoundTrigger, Tag("compound")],
+        Annotated[SequenceTrigger, Tag("sequence")],
+    ],
+    Discriminator(trigger_discriminator),
 ]
 """The union of all concrete trigger types that a user may actually create"""
 

{prefect-3.4.15.dev2 → prefect-3.4.15.dev4}/src/prefect/events/schemas/deployment_triggers.py

@@ -10,7 +10,9 @@ create them from YAML.
 """
 
 import abc
+from datetime import timedelta
 from typing import (
+    Annotated,
     Any,
     ClassVar,
     Dict,
@@ -19,10 +21,11 @@ from typing import (
     Union,
 )
 
-from pydantic import Field
+from pydantic import Discriminator, Field, Tag
 from typing_extensions import TypeAlias
 
 from prefect._internal.schemas.bases import PrefectBaseModel
+from prefect.types import NonNegativeTimeDelta
 
 from .automations import (
     CompoundTrigger,
@@ -68,6 +71,13 @@ class BaseDeploymentTrigger(PrefectBaseModel, abc.ABC, extra="ignore"):  # type:
             "deployment's default job variables"
         ),
     )
+    schedule_after: NonNegativeTimeDelta = Field(
+        default_factory=lambda: timedelta(0),
+        description=(
+            "The amount of time to wait before running the deployment. "
+            "Defaults to running the deployment immediately."
+        ),
+    )
 
 
 class DeploymentEventTrigger(BaseDeploymentTrigger, EventTrigger):
@@ -101,10 +111,33 @@ class DeploymentSequenceTrigger(BaseDeploymentTrigger, SequenceTrigger):
     trigger_type: ClassVar[Type[TriggerTypes]] = SequenceTrigger
 
 
+def deployment_trigger_discriminator(value: Any) -> str:
+    """Custom discriminator for deployment triggers that defaults to 'event' if no type is specified."""
+    if isinstance(value, dict):
+        # Check for explicit type first
+        if "type" in value:
+            return value["type"]
+        # Infer from posture for backward compatibility
+        posture = value.get("posture")
+        if posture == "Metric":
+            return "metric"
+        # Check for compound/sequence specific fields
+        if "triggers" in value and "require" in value:
+            return "compound"
+        if "triggers" in value and "require" not in value:
+            return "sequence"
+        # Default to event
+        return "event"
+    return getattr(value, "type", "event")
+
+
 # Concrete deployment trigger types
-DeploymentTriggerTypes: TypeAlias = Union[
-    DeploymentEventTrigger,
-    DeploymentMetricTrigger,
-    DeploymentCompoundTrigger,
-    DeploymentSequenceTrigger,
+DeploymentTriggerTypes: TypeAlias = Annotated[
+    Union[
+        Annotated[DeploymentEventTrigger, Tag("event")],
+        Annotated[DeploymentMetricTrigger, Tag("metric")],
+        Annotated[DeploymentCompoundTrigger, Tag("compound")],
+        Annotated[DeploymentSequenceTrigger, Tag("sequence")],
+    ],
+    Discriminator(deployment_trigger_discriminator),
 ]

{prefect-3.4.15.dev2 → prefect-3.4.15.dev4}/src/prefect/flow_engine.py

@@ -631,8 +631,7 @@ class FlowRunEngine(BaseFlowRunEngine[P, R]):
             if lease_id := self.state.state_details.deployment_concurrency_lease_id:
                 stack.enter_context(
                     maintain_concurrency_lease(
-                        lease_id,
-                        300,
+                        lease_id, 300, raise_on_lease_renewal_failure=True
                     )
                 )
 
@@ -1202,8 +1201,7 @@ class AsyncFlowRunEngine(BaseFlowRunEngine[P, R]):
             if lease_id := self.state.state_details.deployment_concurrency_lease_id:
                 await stack.enter_async_context(
                     amaintain_concurrency_lease(
-                        lease_id,
-                        300,
+                        lease_id, 300, raise_on_lease_renewal_failure=True
                     )
                 )
 

{prefect-3.4.15.dev2 → prefect-3.4.15.dev4}/src/prefect/server/events/actions.py

@@ -10,6 +10,7 @@ import asyncio
 import copy
 from base64 import b64encode
 from contextlib import asynccontextmanager
+from datetime import datetime, timedelta, timezone
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -81,7 +82,7 @@ from prefect.server.utilities.user_templates import (
     render_user_template,
     validate_user_template,
 )
-from prefect.types import DateTime, StrictVariableValue
+from prefect.types import DateTime, NonNegativeTimeDelta, StrictVariableValue
 from prefect.types._datetime import now, parse_datetime
 from prefect.utilities.schema_tools.hydration import (
     HydrationContext,
@@ -736,6 +737,13 @@ class RunDeployment(JinjaTemplateAction, DeploymentCommandAction):
             "to use the deployment's default job variables"
         ),
     )
+    schedule_after: NonNegativeTimeDelta = Field(
+        default_factory=lambda: timedelta(0),
+        description=(
+            "The amount of time to wait before running the deployment. "
+            "Defaults to running the deployment immediately."
+        ),
+    )
 
     _action_description: ClassVar[str] = "Running deployment"
 
@@ -745,7 +753,9 @@ class RunDeployment(JinjaTemplateAction, DeploymentCommandAction):
         deployment_id: UUID,
         triggered_action: "TriggeredAction",
     ) -> Response:
-        state = Scheduled()
+        # Calculate when to schedule the deployment
+        scheduled_time = datetime.now(timezone.utc) + self.schedule_after
+        state = Scheduled(scheduled_time=scheduled_time)
 
         try:
             flow_run_create = DeploymentFlowRunCreate(  # type: ignore

{prefect-3.4.15.dev2 → prefect-3.4.15.dev4}/src/prefect/server/events/filters.py

@@ -359,6 +359,11 @@ class EventResourceFilter(EventDataFilter):
 
             if labels:
                 for _, (label, values) in enumerate(labels.items()):
+                    # Empty label value arrays should match nothing
+                    if not values:
+                        label_filters.append(sa.false())
+                        continue
+
                     label_ops = LabelOperations(values)
 
                     label_column = db.EventResource.resource[label].astext
@@ -451,6 +456,11 @@ class EventRelatedFilter(EventDataFilter):
 
             if labels:
                 for _, (label, values) in enumerate(labels.items()):
+                    # Empty label value arrays should match nothing
+                    if not values:
+                        label_filters.append(sa.false())
+                        continue
+
                     label_ops = LabelOperations(values)
 
                     label_column = db.EventResource.resource[label].astext
@@ -563,6 +573,11 @@ class EventAnyResourceFilter(EventDataFilter):
 
             if labels:
                 for _, (label, values) in enumerate(labels.items()):
+                    # Empty label value arrays should match nothing
+                    if not values:
+                        label_filters.append(sa.false())
+                        continue
+
                     label_ops = LabelOperations(values)
 
                     label_column = db.EventResource.resource[label].astext

{prefect-3.4.15.dev2 → prefect-3.4.15.dev4}/src/prefect/types/__init__.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from datetime import timedelta
 from functools import partial
 from typing import Annotated, Any, Optional, TypeVar, Union
 from typing_extensions import Literal
@@ -18,6 +19,7 @@ from .names import (
     ValidAssetKey,
 )
 from pydantic import (
+    AfterValidator,
     BeforeValidator,
     Field,
     StrictBool,
@@ -36,6 +38,18 @@ NonNegativeInteger = Annotated[int, Field(ge=0)]
 PositiveInteger = Annotated[int, Field(gt=0)]
 NonNegativeFloat = Annotated[float, Field(ge=0.0)]
 
+
+def _validate_non_negative_timedelta(v: timedelta) -> timedelta:
+    """Validate that a timedelta is non-negative."""
+    if v.total_seconds() < 0:
+        raise ValueError("schedule_after must be non-negative")
+    return v
+
+
+NonNegativeTimeDelta = Annotated[
+    timedelta, AfterValidator(_validate_non_negative_timedelta)
+]
+
 TimeZone = Annotated[
     str,
     Field(
@@ -214,6 +228,7 @@ __all__ = [
     "PositiveInteger",
     "ListOfNonEmptyStrings",
     "NonNegativeFloat",
+    "NonNegativeTimeDelta",
     "Name",
     "NameOrEmpty",
     "NonEmptyishName",

prefect-3.4.15.dev2/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.4.15.dev2"
-__build_date__ = "2025-08-27 08:09:10.566129+00:00"
-__git_commit__ = "4a2335d9b05bb76459ecb36ba33ba605f1047e88"
-__dirty__ = False