prefect 3.4.20.dev2__tar.gz → 3.4.21.dev2__tar.gz

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/PKG-INFO

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

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/pyproject.toml

@@ -159,7 +159,7 @@ dev = [
     "watchfiles>=1.0.4",
     "respx>=0.22.0",
     "codespell==2.4.1",
-    "ruff==0.13.1",
+    "ruff==0.13.2",
     "mypy==1.15.0",
     "types-cachetools>=5.3.1",
     "types-PyYAML>=6.0.12",

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

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.4.21.dev2"
+__build_date__ = "2025-09-28 08:07:53.032272+00:00"
+__git_commit__ = "f0458f3dc011f58af557b8ddeea7152c79152deb"
+__dirty__ = False

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/cli/deploy/_config.py

@@ -17,6 +17,50 @@ from prefect.utilities.annotations import NotSet
 from ._models import PrefectYamlModel
 
 
+def _format_validation_error(exc: ValidationError, raw_data: dict[str, Any]) -> str:
+    """Format Pydantic validation errors into user-friendly messages."""
+    errors: dict[str, set[str]] = {}
+
+    for error in exc.errors():
+        loc = error.get("loc", ())
+
+        # Get deployment context
+        if len(loc) >= 2 and loc[0] == "deployments" and isinstance(loc[1], int):
+            idx = loc[1]
+            deployments = raw_data.get("deployments", [])
+            name = (
+                deployments[idx].get("name", f"#{idx}")
+                if idx < len(deployments)
+                else f"#{idx}"
+            )
+
+            # Get field path (only include string field names, not indices or type names)
+            field_parts = []
+            for part in loc[2:]:
+                if isinstance(part, str) and not part.startswith("function-"):
+                    # Assume lowercase names are field names, not type names
+                    if part[0].islower():
+                        field_parts.append(part)
+
+            if field_parts:
+                field = field_parts[0]  # Just use the top-level field
+                if name not in errors:
+                    errors[name] = set()
+                errors[name].add(field)
+
+    if not errors:
+        return "Validation error in config file"
+
+    lines = ["Invalid fields in deployments:\n"]
+    for name, fields in sorted(errors.items()):
+        lines.append(f"  • {name}: {', '.join(sorted(fields))}")
+    lines.append(
+        "\nFor valid deployment fields and examples, go to: https://docs.prefect.io/v3/concepts/deployments#deployment-schema"
+    )
+
+    return "\n".join(lines)
+
+
 def _merge_with_default_deploy_config(deploy_config: dict[str, Any]) -> dict[str, Any]:
     deploy_config = deepcopy(deploy_config)
     DEFAULT_DEPLOY_CONFIG: dict[str, Any] = {
@@ -78,12 +122,11 @@ def _load_deploy_configs_and_actions(
     try:
         model = PrefectYamlModel.model_validate(raw)
     except ValidationError as exc:
-        # Match prior behavior: warn and continue with empty configuration
+        # Format and display validation errors
+        error_message = _format_validation_error(exc, raw)
+        app.console.print(error_message, style="yellow")
         app.console.print(
-            (
-                "The specified config file contains invalid fields. "
-                "Validation error: " + str(exc.errors()[0].get("msg", exc))
-            ),
+            "\nSkipping deployment configuration due to validation errors.",
             style="yellow",
         )
         model = PrefectYamlModel()

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/cli/deploy/_models.py

@@ -107,7 +107,7 @@ class RawScheduleConfig(BaseModel):
     Exactly one of cron, interval, or rrule must be provided.
     """
 
-    model_config = ConfigDict(extra="ignore")
+    model_config = ConfigDict(extra="forbid")
 
     # One-of schedule selectors
     cron: Optional[str] = None
@@ -117,7 +117,7 @@ class RawScheduleConfig(BaseModel):
     # Common extras
     timezone: Optional[str] = None
     anchor_date: Optional[str] = None
-    active: Optional[bool] = None
+    active: Optional[Union[bool, str]] = None  # Allow string for template values
     parameters: Dict[str, Any] = Field(default_factory=dict)
     slug: Optional[str] = None
 
@@ -132,5 +132,5 @@ class RawScheduleConfig(BaseModel):
 
 
 ScheduleItem = Union[
-    RawScheduleConfig, DeploymentScheduleCreate, SCHEDULE_TYPES, Dict[str, Any]
+    RawScheduleConfig, DeploymentScheduleCreate, SCHEDULE_TYPES, Dict[None, None]
 ]

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/results.py

@@ -564,17 +564,13 @@ class ResultStore(BaseModel):
             A result record.
         """
 
-        from prefect._experimental.lineage import emit_result_read_event
-
         if self.lock_manager is not None and not self.is_lock_holder(key, holder):
             await self.await_for_lock(key)
 
         resolved_key_path = self._resolved_key_path(key)
 
         if resolved_key_path in self.cache:
-            cached_result: ResultRecord[Any] = self.cache[resolved_key_path]
-            await emit_result_read_event(self, resolved_key_path, cached=True)
-            return cached_result
+            return self.cache[resolved_key_path]
 
         if self.result_storage is None:
             self.result_storage = await aget_default_result_storage()
@@ -601,7 +597,6 @@ class ResultStore(BaseModel):
                     result=result_content, metadata=metadata_content
                 )
             )
-            await emit_result_read_event(self, resolved_key_path)
         else:
             content = await call_explicitly_async_block_method(
                 self.result_storage,
@@ -612,7 +607,6 @@ class ResultStore(BaseModel):
             result_record: ResultRecord[Any] = ResultRecord.deserialize(
                 content, backup_serializer=self.serializer
             )
-            await emit_result_read_event(self, resolved_key_path)
 
         if self.cache_result_in_memory:
             self.cache[resolved_key_path] = result_record
@@ -757,8 +751,6 @@ class ResultStore(BaseModel):
             "Storage key is required on result record"
         )
 
-        from prefect._experimental.lineage import emit_result_write_event
-
         key = result_record.metadata.storage_key
         if result_record.metadata.storage_block_id is None:
             basepath = (
@@ -797,7 +789,6 @@ class ResultStore(BaseModel):
                 (base_key,),
                 {"content": result_record.serialize_metadata()},
             )
-            await emit_result_write_event(self, result_record.metadata.storage_key)
         # Otherwise, write the result metadata and result together
         else:
             await call_explicitly_async_block_method(
@@ -806,7 +797,6 @@ class ResultStore(BaseModel):
                 (result_record.metadata.storage_key,),
                 {"content": result_record.serialize()},
             )
-            await emit_result_write_event(self, result_record.metadata.storage_key)
         if self.cache_result_in_memory:
             self.cache[key] = result_record
 

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/artifacts.py

@@ -29,7 +29,7 @@ async def create_artifact(
     """
     Create an artifact.
 
-    For more information, see https://docs.prefect.io/v3/develop/artifacts.
+    For more information, see https://docs.prefect.io/v3/concepts/artifacts.
     """
     artifact = core.Artifact(**artifact.model_dump())
 

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/automations.py

@@ -43,7 +43,7 @@ async def create_automation(
     """
     Create an automation.
 
-    For more information, see https://docs.prefect.io/v3/automate.
+    For more information, see https://docs.prefect.io/v3/concepts/automations.
     """
     # reset any client-provided IDs on the provided triggers
     automation.trigger.reset_ids()

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/block_capabilities.py

@@ -22,7 +22,7 @@ async def read_available_block_capabilities(
     """
     Get available block capabilities.
 
-    For more information, see https://docs.prefect.io/v3/develop/blocks.
+    For more information, see https://docs.prefect.io/v3/concepts/blocks.
     """
     async with db.session_context() as session:
         return await models.block_schemas.read_available_block_capabilities(

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/block_documents.py

@@ -25,7 +25,7 @@ async def create_block_document(
     """
     Create a new block document.
 
-    For more information, see https://docs.prefect.io/v3/develop/blocks.
+    For more information, see https://docs.prefect.io/v3/concepts/blocks.
     """
     async with db.session_context(begin_transaction=True) as session:
         if block_document.name is not None:

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/block_schemas.py

@@ -33,7 +33,7 @@ async def create_block_schema(
     """
     Create a block schema.
 
-    For more information, see https://docs.prefect.io/v3/develop/blocks.
+    For more information, see https://docs.prefect.io/v3/concepts/blocks.
     """
     from prefect.blocks.core import Block
 

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/block_types.py

@@ -21,7 +21,7 @@ async def create_block_type(
     """
     Create a new block type.
 
-    For more information, see https://docs.prefect.io/v3/develop/blocks.
+    For more information, see https://docs.prefect.io/v3/concepts/blocks.
     """
     # API-created blocks cannot start with the word "Prefect"
     # as it is reserved for system use

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/concurrency_limits.py

@@ -48,7 +48,7 @@ async def create_concurrency_limit(
     """
     Create a task run concurrency limit.
 
-    For more information, see https://docs.prefect.io/v3/develop/task-run-limits.
+    For more information, see https://docs.prefect.io/v3/concepts/tag-based-concurrency-limits.
     """
     # Always create V2 limits (no V1 record)
     v2_name = f"tag:{concurrency_limit.tag}"

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/concurrency_limits_v2.py

@@ -32,7 +32,7 @@ async def create_concurrency_limit_v2(
     """
     Create a task run concurrency limit.
 
-    For more information, see https://docs.prefect.io/v3/develop/global-concurrency-limits.
+    For more information, see https://docs.prefect.io/v3/how-to-guides/workflows/global-concurrency-limits.
     """
     async with db.session_context(begin_transaction=True) as session:
         model = await models.concurrency_limits_v2.create_concurrency_limit(

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/deployments.py

@@ -70,7 +70,7 @@ async def create_deployment(
     If the deployment has an active schedule, flow runs will be scheduled.
     When upserting, any scheduled runs from the existing deployment will be deleted.
 
-    For more information, see https://docs.prefect.io/v3/deploy.
+    For more information, see https://docs.prefect.io/v3/concepts/deployments.
     """
 
     data = deployment.model_dump(exclude_unset=True)

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/flow_run_states.py

@@ -27,7 +27,7 @@ async def read_flow_run_state(
     """
     Get a flow run state by id.
 
-    For more information, see https://docs.prefect.io/v3/develop/write-flows#final-state-determination.
+    For more information, see https://docs.prefect.io/v3/concepts/flows#final-state-determination.
     """
     async with db.session_context() as session:
         flow_run_state = await models.flow_run_states.read_flow_run_state(

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/flow_runs.py

@@ -78,7 +78,7 @@ async def create_flow_run(
 
     If no state is provided, the flow run will be created in a PENDING state.
 
-    For more information, see https://docs.prefect.io/v3/develop/write-flows.
+    For more information, see https://docs.prefect.io/v3/concepts/flows.
     """
     # hydrate the input model into a full flow run / state model
     flow_run_object = schemas.core.FlowRun(

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/flows.py

@@ -28,7 +28,7 @@ async def create_flow(
     """Gracefully creates a new flow from the provided schema. If a flow with the
     same name already exists, the existing flow is returned.
 
-    For more information, see https://docs.prefect.io/v3/develop/write-flows.
+    For more information, see https://docs.prefect.io/v3/concepts/flows.
     """
     # hydrate the input model into a full flow model
     flow = schemas.core.Flow(**flow.model_dump())

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/logs.py

@@ -30,7 +30,7 @@ async def create_logs(
     """
     Create new logs from the provided schema.
 
-    For more information, see https://docs.prefect.io/v3/develop/logging.
+    For more information, see https://docs.prefect.io/v3/how-to-guides/workflows/add-logging.
     """
     for batch in models.logs.split_logs_into_batches(logs):
         async with db.session_context(begin_transaction=True) as session:

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/task_run_states.py

@@ -27,7 +27,7 @@ async def read_task_run_state(
     """
     Get a task run state by id.
 
-    For more information, see https://docs.prefect.io/v3/develop/write-tasks.
+    For more information, see https://docs.prefect.io/v3/concepts/tasks.
     """
     async with db.session_context() as session:
         task_run_state = await models.task_run_states.read_task_run_state(

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/task_runs.py

@@ -63,7 +63,7 @@ async def create_task_run(
 
     If no state is provided, the task run will be created in a PENDING state.
 
-    For more information, see https://docs.prefect.io/v3/develop/write-tasks.
+    For more information, see https://docs.prefect.io/v3/concepts/tasks.
     """
     # hydrate the input model into a full task run / state model
     task_run_dict = task_run.model_dump()

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/task_workers.py

@@ -23,7 +23,7 @@ async def read_task_workers(
     """
     Read active task workers. Optionally filter by task keys.
 
-    For more information, see https://docs.prefect.io/v3/concepts/flows-and-tasks#background-tasks.
+    For more information, see https://docs.prefect.io/v3/how-to-guides/workflows/run-background-tasks.
     """
 
     if task_worker_filter and task_worker_filter.task_keys:

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/variables.py

@@ -60,7 +60,7 @@ async def create_variable(
     """
     Create a variable.
 
-    For more information, see https://docs.prefect.io/v3/develop/variables.
+    For more information, see https://docs.prefect.io/v3/concepts/variables.
     """
     async with db.session_context(begin_transaction=True) as session:
         try:

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/work_queues.py

@@ -46,7 +46,7 @@ async def create_work_queue(
     If a work queue with the same name already exists, an error
     will be raised.
 
-    For more information, see https://docs.prefect.io/v3/deploy/infrastructure-concepts/work-pools#work-queues.
+    For more information, see https://docs.prefect.io/v3/concepts/work-pools#work-queues.
     """
 
     try:

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/server/api/workers.py

@@ -167,7 +167,7 @@ async def create_work_pool(
     Creates a new work pool. If a work pool with the same
     name already exists, an error will be raised.
 
-    For more information, see https://docs.prefect.io/v3/deploy/infrastructure-concepts/work-pools.
+    For more information, see https://docs.prefect.io/v3/concepts/work-pools.
     """
     if work_pool.name.lower().startswith("prefect"):
         raise HTTPException(
@@ -449,7 +449,7 @@ async def create_work_queue(
     Creates a new work pool queue. If a work pool queue with the same
     name already exists, an error will be raised.
 
-    For more information, see https://docs.prefect.io/v3/deploy/infrastructure-concepts/work-pools#work-queues.
+    For more information, see https://docs.prefect.io/v3/concepts/work-pools#work-queues.
     """
 
     try:

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/settings/base.py

@@ -89,6 +89,39 @@ class PrefectBaseSettings(BaseSettings):
             ProfileSettingsTomlLoader(settings_cls),
         )
 
+    @staticmethod
+    def _settings_warn_unused_config_keys(
+        sources: tuple[object, ...],
+        model_config: SettingsConfigDict,
+    ) -> None:
+        """
+        Override PrefectBaseSettings._settings_warn_unused_config_keys to ensure
+        Prefect’s TOML sources satisfy pydantic-settings 2.11’s unused-config check
+        without renaming public config keys. This method suppresses warnings when
+        Prefect sources are configured.
+
+        In the future pydantic-settings's init might stop invoking this method, so we
+        should remove this method.
+        """
+        warn_method = getattr(BaseSettings, "_settings_warn_unused_config_keys", None)
+        if warn_method is None:
+            return
+
+        adjusted_config = dict(model_config)
+
+        if any(
+            isinstance(source, PrefectTomlConfigSettingsSource) for source in sources
+        ):
+            adjusted_config["toml_file"] = None
+
+        if any(
+            isinstance(source, PyprojectTomlConfigSettingsSource) for source in sources
+        ):
+            adjusted_config["pyproject_toml_table_header"] = None
+            adjusted_config["pyproject_toml_depth"] = None
+
+        warn_method(sources, adjusted_config)
+
     def to_environment_variables(
         self,
         exclude_unset: bool = False,

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/settings/models/experiments.py

@@ -22,8 +22,3 @@ class ExperimentsSettings(PrefectBaseSettings):
             AliasPath("warn"), "prefect_experiments_warn", "prefect_experimental_warn"
         ),
     )
-
-    lineage_events_enabled: bool = Field(
-        default=False,
-        description="If `True`, enables emitting lineage events. Set to `False` to disable lineage event emission.",
-    )

{prefect-3.4.20.dev2 → prefect-3.4.21.dev2}/src/prefect/testing/fixtures.py

@@ -30,7 +30,6 @@ from prefect.server.api.server import SubprocessASGIServer
 from prefect.server.events.pipeline import EventsPipeline
 from prefect.settings import (
     PREFECT_API_URL,
-    PREFECT_EXPERIMENTS_LINEAGE_EVENTS_ENABLED,
     PREFECT_SERVER_ALLOW_EPHEMERAL_MODE,
     PREFECT_SERVER_CSRF_PROTECTION_ENABLED,
     get_current_settings,
@@ -475,10 +474,3 @@ def reset_worker_events(
     yield
     assert isinstance(asserting_events_worker._client, AssertingEventsClient)
     asserting_events_worker._client.events = []
-
-
-@pytest.fixture
-def enable_lineage_events() -> Generator[None, None, None]:
-    """A fixture that ensures lineage events are enabled."""
-    with temporary_settings(updates={PREFECT_EXPERIMENTS_LINEAGE_EVENTS_ENABLED: True}):
-        yield

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

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.4.20.dev2"
-__build_date__ = "2025-09-25 08:09:36.522054+00:00"
-__git_commit__ = "11a83d5bc22024732ffc982a591f0ab14aec92e6"
-__dirty__ = False