prefect 3.6.30.dev4__tar.gz → 3.7.0__tar.gz

{prefect-3.6.30.dev4 → prefect-3.7.0}/PKG-INFO

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

{prefect-3.6.30.dev4 → prefect-3.7.0}/src/prefect/__init__.py

@@ -78,25 +78,24 @@ del _build_info, pathlib
 
 def _initialize_plugins() -> None:
     """
-    Initialize the experimental plugin system if enabled.
+    Initialize the plugin system if enabled.
 
     This runs automatically when Prefect is imported and plugins are enabled
-    via experiments.plugins.enabled setting. Errors are logged but don't prevent
+    via the `plugins.enabled` setting. Errors are logged but don't prevent
     Prefect from loading.
     """
     try:
         # Import here to avoid circular imports and defer cost until needed
         from prefect.settings import get_current_settings
 
-        if not get_current_settings().experiments.plugins.enabled:
+        if not get_current_settings().plugins.enabled:
             return
 
         import anyio
 
-        from prefect._experimental.plugins import run_startup_hooks
-        from prefect._experimental.plugins.spec import HookContext
         from prefect.context import refresh_global_settings_context
         from prefect.logging import get_logger
+        from prefect.plugins import HookContext, run_startup_hooks
         from prefect.settings import get_current_settings
 
         ctx = HookContext(

prefect-3.7.0/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.0"
+__build_date__ = "2026-05-06 15:02:30.389140+00:00"
+__git_commit__ = "85c59e0e48648ba494786fe27a0e1f97256134e6"
+__dirty__ = False

prefect-3.7.0/src/prefect/_experimental/_launchers.py

@@ -0,0 +1,31 @@
+"""
+Compatibility shim for the legacy `prefect._experimental._launchers` path.
+
+The launcher utilities graduated to GA at `prefect._launchers` when the
+infrastructure decorators feature became stable. This module re-exports
+the public symbols from the new location and emits a
+`DeprecationWarning` so consumers know to migrate.
+"""
+
+import warnings
+
+from prefect._launchers import (
+    get_launcher_for_side,
+    normalize_launcher,
+    resolve_bundle_step_with_launcher,
+    validate_bundle_step_launcher,
+)
+
+warnings.warn(
+    "`prefect._experimental._launchers` has moved to `prefect._launchers`. "
+    "The old import path will be removed in a future release.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+__all__ = [
+    "get_launcher_for_side",
+    "normalize_launcher",
+    "resolve_bundle_step_with_launcher",
+    "validate_bundle_step_launcher",
+]

prefect-3.7.0/src/prefect/_experimental/bundles/__init__.py

@@ -0,0 +1,68 @@
+"""
+Compatibility shim for the legacy `prefect._experimental.bundles` path.
+
+The bundle implementation graduated to GA at `prefect.bundles` when the
+infrastructure decorators feature became stable. This package keeps the
+old import path importable (and `python -m`-runnable for the legacy
+`...bundles.execute` entrypoint), but emits a `DeprecationWarning` so
+consumers know to migrate to `prefect.bundles`.
+"""
+
+import warnings
+from typing import Any
+
+from prefect.bundles import (
+    BundleCreationResult,
+    BundleLauncher,
+    BundleLauncherOverride,
+    BundleLauncherSide,
+    SerializedBundle,
+    aupload_bundle_to_storage,
+    convert_step_to_command,
+    create_bundle_for_flow_run,
+    execute_bundle_in_subprocess,
+    extract_flow_from_bundle,
+    upload_bundle_to_storage,
+)
+from prefect.bundles import _pin_prefect_in_bundle_step_requires  # noqa: F401
+
+warnings.warn(
+    "`prefect._experimental.bundles` has moved to `prefect.bundles`. "
+    "The old import path will be removed in a future release.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+__all__ = [
+    "BundleCreationResult",
+    "BundleLauncher",
+    "BundleLauncherOverride",
+    "BundleLauncherSide",
+    "SerializedBundle",
+    "aupload_bundle_to_storage",
+    "convert_step_to_command",
+    "create_bundle_for_flow_run",
+    "execute_bundle_from_file",
+    "execute_bundle_in_subprocess",
+    "extract_flow_from_bundle",
+    "upload_bundle_to_storage",
+]
+
+
+def __getattr__(name: str) -> Any:
+    """Lazy-load `execute_bundle_from_file` from the `.execute` submodule
+    so importing this package does not pre-populate
+    `sys.modules["prefect._experimental.bundles.execute"]`. That would
+    make `python -m prefect._experimental.bundles.execute` emit a
+    `runpy` `RuntimeWarning` and hard-fail under
+    `PYTHONWARNINGS=error`. Accessing the legacy `.execute` submodule
+    by attribute (rather than importing it eagerly) still works because
+    Python binds it on the package after a separate `from . import
+    execute` (the legacy execute shim is reachable via plain
+    `import prefect._experimental.bundles.execute`).
+    """
+    if name == "execute_bundle_from_file":
+        from prefect.bundles.execute import execute_bundle_from_file
+
+        return execute_bundle_from_file
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

prefect-3.7.0/src/prefect/_experimental/bundles/execute.py

@@ -0,0 +1,46 @@
+"""
+Compatibility shim for the legacy `prefect._experimental.bundles.execute`
+entrypoint.
+
+Existing work pool storage configurations may have stored the command
+`python -m prefect._experimental.bundles.execute --key ...` before the
+bundle implementation graduated to GA. This module re-exports the new
+`prefect.bundles.execute` symbols and forwards `python -m` execution to
+the new entrypoint, while emitting a `DeprecationWarning` so users know
+to migrate to `prefect.bundles.execute`.
+"""
+
+import warnings
+from typing import Any
+
+warnings.warn(
+    "`prefect._experimental.bundles.execute` has moved to "
+    "`prefect.bundles.execute`. The old import path will be removed in a "
+    "future release.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+__all__ = ["execute_bundle", "execute_bundle_from_file"]  # noqa: F822
+
+
+def __getattr__(name: str) -> Any:
+    """Lazy-load symbols from `prefect.bundles.execute` so that running
+    `python -m prefect._experimental.bundles.execute` does not put
+    `prefect.bundles.execute` in `sys.modules` before the
+    `runpy.run_module` forward below executes — that would trigger a
+    runpy `RuntimeWarning` (and hard-fail under `PYTHONWARNINGS=error`).
+    """
+    if name in {"execute_bundle", "execute_bundle_from_file"}:
+        from prefect.bundles.execute import execute_bundle, execute_bundle_from_file
+
+        if name == "execute_bundle":
+            return execute_bundle
+        return execute_bundle_from_file
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+if __name__ == "__main__":
+    import runpy
+
+    runpy.run_module("prefect.bundles.execute", run_name="__main__")

prefect-3.7.0/src/prefect/_experimental/plugins/__init__.py

@@ -0,0 +1,16 @@
+"""
+Deprecated. Use `prefect.plugins` instead.
+
+The plugin system has graduated from experimental to general availability.
+Imports from this path continue to work but emit a `DeprecationWarning`.
+"""
+
+from prefect._internal.compatibility.deprecated_paths import deprecated_module_attrs
+
+# Names are lazily resolved by `__getattr__` below; ruff's F822 (undefined
+# name in __all__) doesn't fit this deprecation-shim pattern.
+# fmt: off
+__all__ = ("run_startup_hooks", "HookContext", "SetupResult", "HookSpec", "SetupSummary", "PREFECT_PLUGIN_API_VERSION", "register_hook")  # noqa: F822
+# fmt: on
+
+__getattr__ = deprecated_module_attrs(__name__, "prefect.plugins", __all__)

prefect-3.7.0/src/prefect/_experimental/plugins/apply.py

@@ -0,0 +1,5 @@
+"""Deprecated. The contents of this module were never public API."""
+
+from prefect._internal.compatibility.deprecated_paths import deprecated_module_attrs
+
+__getattr__ = deprecated_module_attrs(__name__, "prefect.plugins", ())

prefect-3.7.0/src/prefect/_experimental/plugins/diagnostics.py

@@ -0,0 +1,7 @@
+"""Deprecated. Use `prefect.plugins` instead."""
+
+from prefect._internal.compatibility.deprecated_paths import deprecated_module_attrs
+
+__all__ = ("SetupSummary",)  # noqa: F822 - lazily resolved by `__getattr__`
+
+__getattr__ = deprecated_module_attrs(__name__, "prefect.plugins", __all__)

prefect-3.7.0/src/prefect/_experimental/plugins/manager.py

@@ -0,0 +1,7 @@
+"""Deprecated. Use `prefect.plugins` instead."""
+
+from prefect._internal.compatibility.deprecated_paths import deprecated_module_attrs
+
+__all__ = ("register_hook",)  # noqa: F822 - lazily resolved by `__getattr__`
+
+__getattr__ = deprecated_module_attrs(__name__, "prefect.plugins", __all__)

prefect-3.7.0/src/prefect/_experimental/plugins/spec.py

@@ -0,0 +1,7 @@
+"""Deprecated. Use `prefect.plugins` instead."""
+
+from prefect._internal.compatibility.deprecated_paths import deprecated_module_attrs
+
+__all__ = ("HookContext", "SetupResult", "HookSpec", "PREFECT_PLUGIN_API_VERSION")  # noqa: F822 - names lazily resolved by `__getattr__`
+
+__getattr__ = deprecated_module_attrs(__name__, "prefect.plugins", __all__)

prefect-3.7.0/src/prefect/_internal/compatibility/deprecated_paths.py

@@ -0,0 +1,60 @@
+"""
+Generic helper for keeping a deprecated module path working as a re-export
+of a new location, emitting a DeprecationWarning per attribute access.
+
+Independent of any specific Prefect version migration. Intended for cases
+where a feature graduates between lifecycle stages (e.g., experimental to
+GA) and we want the old import path to continue working with a clear hand
+off message, but without coupling to the v2->v3 module migration helpers
+in `prefect._internal.compatibility.migration`.
+"""
+
+from __future__ import annotations
+
+import importlib
+import warnings
+from typing import Any, Callable, Iterable
+
+
+def deprecated_module_attrs(
+    old_module: str,
+    new_module: str,
+    names: Iterable[str],
+) -> Callable[[str], Any]:
+    """
+    Build a `__getattr__` for a deprecated module that re-exports public
+    symbols from a new location. Each access emits a DeprecationWarning
+    pointing the user at the new path.
+
+    Symbols not in `names` raise `AttributeError` (rather than being
+    silently re-exported) — this keeps the public surface explicit and
+    avoids leaking implementation details that the new location does not
+    intend to expose.
+
+    Usage at the bottom of the deprecated module:
+
+        from prefect._internal.compatibility.deprecated_paths import (
+            deprecated_module_attrs,
+        )
+
+        __getattr__ = deprecated_module_attrs(
+            __name__,
+            "prefect.plugins",
+            ("register_hook", "HookContext"),
+        )
+    """
+    name_set = frozenset(names)
+
+    def __getattr__(name: str) -> Any:
+        if name in name_set:
+            warnings.warn(
+                f"`{old_module}.{name}` has moved to `{new_module}.{name}`. "
+                f"Update your imports; the old path will be removed in a "
+                f"future release.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            return getattr(importlib.import_module(new_module), name)
+        raise AttributeError(f"module {old_module!r} has no attribute {name!r}")
+
+    return __getattr__

prefect-3.7.0/src/prefect/_internal/plugins/__init__.py

@@ -0,0 +1,7 @@
+"""
+Internal implementation of Prefect's plugin system.
+
+Public API for these modules is re-exported from `prefect.plugins`. Importing
+directly from `prefect._internal.plugins.*` is not part of the supported
+contract and may change without notice.
+"""

{prefect-3.6.30.dev4/src/prefect/_experimental → prefect-3.7.0/src/prefect/_internal}/plugins/apply.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 import logging
 import os
 
-from prefect._experimental.plugins.spec import SetupResult
+from prefect._internal.plugins.spec import SetupResult
 
 REDACT_KEYS = ("SECRET", "TOKEN", "PASSWORD", "KEY")
 

prefect-3.6.30.dev4/src/prefect/plugins.py → prefect-3.7.0/src/prefect/_internal/plugins/collections.py

@@ -1,11 +1,11 @@
 """
-Utilities for loading plugins that extend Prefect's functionality.
+Utilities for loading Prefect collections via setuptools entry points.
 
-Plugins are detected by entry point definitions in package setup files.
+Collections are detected via the `prefect.collections` entry point group;
+each entry point is a module to import when Prefect itself is imported,
+typically to register Blocks or other Prefect-aware classes.
 
-Currently supported entrypoints:
-    - prefect.collections: Identifies this package as a Prefect collection that
-        should be imported when Prefect is imported.
+Public API is re-exported from `prefect.plugins`.
 """
 
 from importlib.metadata import EntryPoints, entry_points

{prefect-3.6.30.dev4/src/prefect/_experimental → prefect-3.7.0/src/prefect/_internal}/plugins/diagnostics.py

@@ -1,5 +1,5 @@
 """
-Diagnostic data structures for plugin system.
+Diagnostic data structures for the plugin system.
 """
 
 from __future__ import annotations

{prefect-3.6.30.dev4/src/prefect/_experimental → prefect-3.7.0/src/prefect/_internal}/plugins/manager.py

@@ -13,12 +13,15 @@ from typing import Any
 import pluggy
 from packaging.specifiers import InvalidSpecifier, SpecifierSet
 
-from prefect._experimental.plugins.spec import PREFECT_PLUGIN_API_VERSION
+from prefect._internal.plugins.spec import PREFECT_PLUGIN_API_VERSION
 
+# Pluggy project name. Kept as "prefect-experimental" for backward compat —
+# plugins decorated with the experimental-era marker continue to register
+# without modification.
 PM_PROJECT_NAME = "prefect-experimental"
 ENTRYPOINTS_GROUP = "prefect.plugins"
 
-register_hook = pluggy.HookimplMarker(PM_PROJECT_NAME)
+register_hook: pluggy.HookimplMarker = pluggy.HookimplMarker(PM_PROJECT_NAME)
 
 
 def build_manager(hookspecs: type) -> pluggy.PluginManager:

{prefect-3.6.30.dev4/src/prefect/_experimental → prefect-3.7.0/src/prefect/_internal}/plugins/spec.py

@@ -1,8 +1,8 @@
 """
-Experimental plugin API specification.
+Plugin API specification.
 
-This module defines the hook specification and data structures for Prefect's
-experimental plugin system.
+Defines the hook specification and data structures for Prefect's plugin
+system. Public symbols are re-exported from `prefect.plugins`.
 """
 
 from __future__ import annotations
@@ -16,6 +16,10 @@ import pluggy
 # Bump this when breaking the hook contract
 PREFECT_PLUGIN_API_VERSION = "0.1"
 
+# Pluggy project name. Matches `HookimplMarker` in manager.py so that
+# specs and impls pair correctly. Kept as "prefect-experimental" for
+# backward compat — plugins decorated with the experimental-era marker
+# (e.g. prefect-aws) continue to register without modification.
 hookspec = pluggy.HookspecMarker("prefect-experimental")
 
 

prefect-3.6.30.dev4/src/prefect/_experimental/plugins/__init__.py → prefect-3.7.0/src/prefect/_internal/plugins/startup.py

@@ -1,44 +1,28 @@
 """
-Experimental plugin system for Prefect.
+Plugin startup hook orchestration.
 
-This module provides a startup hook system that allows third-party packages
-to run initialization code before Prefect CLI commands, workers, or agents
-start their main work.
-
-**Note: This is an experimental API and is subject to change.**
+Reads the `plugins` settings, builds a pluggy manager, runs all registered
+`setup_environment` hooks (with timeout and strict-mode handling), and
+returns diagnostic summaries. Public entry point is re-exported from
+`prefect.plugins`.
 """
 
 from __future__ import annotations
+
 from typing import Any
 
 import anyio
 
-from prefect._experimental.plugins.apply import apply_setup_result, summarize_env
-from prefect._experimental.plugins.diagnostics import SetupSummary
-from prefect._experimental.plugins.manager import (
+from prefect._internal.plugins.apply import apply_setup_result, summarize_env
+from prefect._internal.plugins.diagnostics import SetupSummary
+from prefect._internal.plugins.manager import (
     build_manager,
     call_async_hook,
     load_entry_point_plugins,
-    register_hook,
-)
-from prefect._experimental.plugins.spec import (
-    PREFECT_PLUGIN_API_VERSION,
-    HookContext,
-    HookSpec,
-    SetupResult,
 )
+from prefect._internal.plugins.spec import HookContext, HookSpec, SetupResult
 from prefect.settings import get_current_settings
 
-__all__ = [
-    "run_startup_hooks",
-    "HookContext",
-    "SetupResult",
-    "HookSpec",
-    "SetupSummary",
-    "PREFECT_PLUGIN_API_VERSION",
-    "register_hook",
-]
-
 
 async def run_startup_hooks(ctx: HookContext) -> list[SetupSummary]:
     """
@@ -61,13 +45,13 @@ async def run_startup_hooks(ctx: HookContext) -> list[SetupSummary]:
         SystemExit: In strict mode, if a required plugin fails
     """
     logger = ctx.logger_factory("prefect.plugins")
-    settings = get_current_settings().experiments.plugins
+    settings = get_current_settings().plugins
 
     if not settings.enabled:
-        logger.debug("Experimental plugins not enabled")
+        logger.debug("Plugins not enabled")
         return []
 
-    logger.debug("Initializing experimental plugin system")
+    logger.debug("Initializing plugin system")
     pm = build_manager(HookSpec)
     allow = settings.allow
     deny = settings.deny
@@ -137,3 +121,6 @@ async def run_startup_hooks(ctx: HookContext) -> list[SetupSummary]:
 
     logger.debug("Plugin system initialization complete (%d plugins)", len(summaries))
     return summaries
+
+
+__all__ = ["run_startup_hooks", "HookContext", "HookSpec", "SetupResult"]

{prefect-3.6.30.dev4/src/prefect/_experimental → prefect-3.7.0/src/prefect}/_launchers.py

@@ -4,7 +4,7 @@ from copy import deepcopy
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
-    from prefect._experimental.bundles import (
+    from prefect.bundles import (
         BundleLauncher,
         BundleLauncherOverride,
         BundleLauncherSide,

{prefect-3.6.30.dev4 → prefect-3.7.0}/src/prefect/blocks/core.py

@@ -924,12 +924,27 @@ class Block(BaseModel, ABC):
             raise UnknownBlockType(message)
 
     def _define_metadata_on_nested_blocks(
-        self, block_document_references: dict[str, dict[str, Any]]
+        self,
+        block_document_references: dict[str, dict[str, Any]],
+        _depth: int = 0,
+        _max_depth: int = 50,
+        _visited: set[int] | None = None,
     ):
         """
         Recursively populates metadata fields on nested blocks based on the
-        provided block document references.
+        provided block document references. The depth bound and visited-set
+        keep recursion finite even if the references dict happens to be
+        deeply nested or shares dict identity across levels.
         """
+        if _depth > _max_depth:
+            return
+        if _visited is None:
+            _visited = set()
+        refs_id = id(block_document_references)
+        if refs_id in _visited:
+            return
+        _visited.add(refs_id)
+
         for item in block_document_references.items():
             field_name, block_document_reference = item
             nested_block = getattr(self, field_name)
@@ -938,7 +953,10 @@ class Block(BaseModel, ABC):
                     "block_document", {}
                 )
                 nested_block._define_metadata_on_nested_blocks(
-                    nested_block_document_info.get("block_document_references", {})
+                    nested_block_document_info.get("block_document_references", {}),
+                    _depth=_depth + 1,
+                    _max_depth=_max_depth,
+                    _visited=_visited,
                 )
                 nested_block_document_id = nested_block_document_info.get("id")
                 nested_block._block_document_id = (

{prefect-3.6.30.dev4/src/prefect/_experimental → prefect-3.7.0/src/prefect}/bundles/__init__.py

@@ -39,12 +39,11 @@ from prefect.settings.models.root import Settings
 from prefect.utilities.processutils import sanitize_subprocess_env
 from prefect.utilities.slugify import slugify
 
-from prefect._experimental._launchers import (
+from prefect._launchers import (
     get_launcher_for_side,
     validate_bundle_step_launcher,
 )
 
-from .execute import execute_bundle_from_file
 from ._file_collector import FileCollector
 from ._ignore_filter import IgnoreFilter, check_sensitive_files
 from ._zip_builder import ZipBuilder
@@ -876,3 +875,19 @@ __all__ = [
     "extract_flow_from_bundle",
     "SerializedBundle",
 ]
+
+
+def __getattr__(name: str) -> Any:
+    """Lazy-load `execute_bundle_from_file` from the `.execute` submodule.
+
+    Importing the submodule eagerly at package init pre-populates
+    `sys.modules["prefect.bundles.execute"]`, which makes
+    `python -m prefect.bundles.execute` emit a `runpy` `RuntimeWarning`
+    (and hard-fail under `PYTHONWARNINGS=error`). Defer the import so
+    `python -m` is the first thing to load the submodule.
+    """
+    if name == "execute_bundle_from_file":
+        from .execute import execute_bundle_from_file
+
+        return execute_bundle_from_file
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

{prefect-3.6.30.dev4/src/prefect/_experimental → prefect-3.7.0/src/prefect}/bundles/_file_collector.py

@@ -16,12 +16,12 @@ from pathlib import Path
 import pathspec
 import pathspec.util
 
-from prefect._experimental.bundles._ignore_filter import (
+from ._ignore_filter import (
     IgnoreFilter,
     check_sensitive_files,
     emit_excluded_warning,
 )
-from prefect._experimental.bundles._path_resolver import (
+from ._path_resolver import (
     PathValidationError,
     normalize_path_separator,
     resolve_with_symlink_check,

{prefect-3.6.30.dev4/src/prefect/_experimental → prefect-3.7.0/src/prefect}/bundles/execute.py

@@ -1,10 +1,11 @@
 import json
 import sys
+from typing import Any
 
 from prefect.utilities.asyncutils import run_coro_as_sync
 
 
-def execute_bundle_from_file(key: str):
+def execute_bundle_from_file(key: str) -> None:
     """
     Loads a bundle from a file and executes it.
 
@@ -17,11 +18,11 @@ def execute_bundle_from_file(key: str):
     run_coro_as_sync(execute_bundle(bundle))
 
 
-async def execute_bundle(bundle: dict) -> None:
+async def execute_bundle(bundle: dict[str, Any]) -> None:
     # All these imports must stay deferred to break circular imports:
     # bundles/__init__ imports from .execute, and _starter_bundle imports from bundles/__init__
     # _flow_run_executor → runner/__init__ → runner.py → bundles/__init__
-    from prefect._experimental.bundles import extract_flow_from_bundle
+    from prefect.bundles import extract_flow_from_bundle
     from prefect.client.schemas.objects import FlowRun
     from prefect.flows import Flow
     from prefect.runner._flow_run_executor import FlowRunExecutorContext
@@ -45,8 +46,8 @@ async def execute_bundle(bundle: dict) -> None:
 
 
 if __name__ == "__main__":
-    if len(sys.argv) < 3 and sys.argv[1] != "--key":
+    if len(sys.argv) < 3 or sys.argv[1] != "--key":
         print("Please provide a key representing a path to a bundle")
         sys.exit(1)
-    key = sys.argv[2]
+    key: str = sys.argv[2]
     execute_bundle_from_file(key)

{prefect-3.6.30.dev4 → prefect-3.7.0}/src/prefect/cli/_app.py

@@ -271,6 +271,11 @@ _app.command(
     name="experimental",
     help="Access experimental features (subject to change).",
 )
+_app.command(
+    "prefect.cli.plugins:plugins_app",
+    name="plugins",
+    help="Plugin system diagnostics.",
+)
 _app.command(
     "prefect.cli.automation:automation_app",
     name="automation",

prefect-3.7.0/src/prefect/cli/experimental.py

@@ -0,0 +1,37 @@
+"""
+Experimental command — kept as a deprecation alias for the now-GA plugin
+diagnostics. New users should run `prefect plugins diagnose`.
+"""
+
+import cyclopts
+
+import prefect.cli._app as _cli
+from prefect.cli._utilities import with_cli_exception_handling
+
+experimental_app: cyclopts.App = cyclopts.App(
+    name="experimental",
+    help="Access experimental features (subject to change).",
+    version_flags=[],
+    help_flags=["--help"],
+)
+
+plugins_app: cyclopts.App = cyclopts.App(
+    name="plugins",
+    help="[deprecated] Plugin system diagnostics. Use `prefect plugins diagnose`.",
+    version_flags=[],
+    help_flags=["--help"],
+)
+experimental_app.command(plugins_app)
+
+
+@plugins_app.command(name="diagnose")
+@with_cli_exception_handling
+async def diagnose() -> None:
+    """[deprecated] Diagnose the plugin system."""
+    from prefect.cli.plugins import _diagnose_plugins
+
+    _cli.console.print(
+        "[yellow]This command has moved to 'prefect plugins diagnose'. "
+        "The 'experimental' alias will be removed in a future release.[/yellow]"
+    )
+    await _diagnose_plugins()