All docs
Engine·
method
Engine.plan
previews which steps a run would execute without running them
Python
plan(target=None) -> dict
Returns dict — which steps would run vs. be served from cache (no writes)
Parameters#
| name | type | default | description |
|---|---|---|---|
target |
str | Entity | None |
None |
one entity by name or instance; None plans every entity |
Example#
Python
plan = engine.plan("sales")
would_run = [s["step_class"] for s in plan["steps"] if s["will_run"]]
Notes#
Read-only: it reads the manifest and current parameters and writes nothing. Assumes resume=True
(the default run behaviour) and models a real run exactly — including the cache-broken cascade
(once any step reruns, later steps rerun too) and the frozen short-circuit (a frozen step is served
from cache and resets the cascade).
See also#
By LSD Team · Last updated Jul 17, 2026
Ask on Discord
View as Markdown