All docs
Engine·
method
Engine.run
runs a target and returns its result
Python
run(target, *, resume=True, from_step=None) -> RunResult
Returns RunResult — for a wired step chain; a PipelineResult for a named entity or Entity
Parameters#
| name | type | default | description |
|---|---|---|---|
target |
str | Entity | Step |
— | an entity name, an Entity, or a wired step / list of steps |
resume |
bool |
True |
reuse cached step outputs whose parameters are unchanged |
from_step |
str | None |
None |
class name of the step to force recomputation from |
Example#
Python
from lsdtools import Engine
Engine().run(top(numbers(count=6), limit=3)).print()
Force a recompute from one step onward:
Python
engine.run("sales", from_step="Normalize") # rerun Normalize and everything after it
Notes#
The return type depends on target. A wired step or list of steps returns a friendly
RunResult whose .output is a Table; an entity name
or Entity returns the low-level PipelineResult. resume=True (the default) reuses cached
outputs; from_step names a step class and reruns it and everything downstream.
See also#
API: run_all · plan · diff · RunResult
Guides: Your first tool
By LSD Team · Last updated Jul 17, 2026
Ask on Discord
View as Markdown