All docs
Engine·
method
Engine.show
presents every attached view — the show-side partner of run_all
Python
show(*, mode="auto", title=None, block=True) -> Any
Returns Any — the front-end's window handle, or None in text mode / when no views are attached
Parameters#
| name | type | default | description |
|---|---|---|---|
mode |
str |
"auto" |
"window" opens a front-end window (needs a presenter), "text" prints each view's console rendering, "auto" picks a window when a front-end is loaded else text |
title |
str | None |
None |
the window title hosting the views (defaults to "LSD") |
block |
bool |
True |
whether the window call blocks until closed |
Example#
Python
from lsdtools import Engine, views
engine = Engine()
engine.add(views.chart(kind="histogram", title="Grades"))
engine.add(views.table(title="Assays"))
engine.show() # one window hosting both, or console text when headless
Notes#
show is the exact symmetry partner of run_all: run executes the
entities, show presents the views. It presents every View attached with
add — a single window hosting them all when a front-end is loaded, else each
view's titled text rendering (so the same script runs headless). With no views attached it logs and
returns None.
A single view can also present itself directly through its own View.show();
Engine.show is the whole-project version.
See also#
By LSD Team · Last updated Jul 17, 2026
Ask on Discord
View as Markdown