Dashboard demo

A dashboard built with Row, Column, Label, StatusBar, and Panel. Run it in your normal terminal, including Windows Terminal:

python -m bruhanimate.demos.dashboard_demo

from bruhanimate import dashboard_demo

dashboard_demo.run(frames=360, fps=60)

The layout contains a one-row title, a flexible beam-solver panel with an activity log below it, a 24-column statistics sidebar, and a one-row status bar. Snow animates behind the solver at 15 updates/sec; a small plasma preview updates at 30/sec. The public beam fixture advances at two steps/sec, and Player presents at 60 FPS by default. The final board stays visible until quit or the frame limit.

Tab/Shift+Tab moves focus through solver, signal, and log panels. The selected border is bold yellow, and the status bar shows its declared bindings:

• Solver: Space pauses/resumes, n queues one step, +/- changes speed. Arrows, Page Up/Down, Home/End pan the full board through its ScrollView.

• Signal: Space pauses/resumes plasma, r remixes its pattern.

• Log: Arrows, Page Up/Down, Home/End browse activity. Upward scrolling/Home suspends automatic scrolling; End resumes following. The status bar shows log LIVE or log HISTORY.

• Anywhere: q/Q, Escape, or Ctrl+C quits.

Space affects only the selected panel; snow keeps advancing. The statistics sidebar shows both focus and signal pause state. Text callbacks read playback state during updates, not drawing. The solver updates before its statistics labels. All puzzle rules remain in demo code; the fixture is independently created and requires no private puzzle inputs or external tools.

The LogView retains 200 logical lines and wraps at cell boundaries. It records solver step requests/progress/completion, pause/resume, speed changes, and signal remixes. Progress is observed once after each scene update; drawing never appends messages or consumes snapshots. New messages preserve your reading position while browsing; if that line is evicted, the oldest remaining line becomes visible. The views are ordinary owned children in the layout and close even when their slots never become visible.

An 80-column by 24-row terminal displays the full dashboard. Smaller terminals shrink the flexible area first. Live resize is enabled by default: pause with Space while the solver is selected, resize smaller and larger, then select the solver and press n to advance exactly one snapshot. The current board, step count, speed, queued input and iterator remain intact. The solver’s full canvas stays the same size while its viewport changes. LogView rewraps retained text, keeping the top logical line/character where possible or following the tail when enabled. Existing children continue updating while hidden; initially hidden factories wait until first visible allocation. Snow fills the new background area and anchors its floor pile to the new bottom; plasma fills its panel without restarting its phase. A hidden panel is skipped during focus navigation; if the selected panel becomes hidden, focus moves to the next available target. Making it visible again does not steal focus. Cropped snow is discarded, while visible flakes keep their drift and fall delay. Pass run(on_resize="raise") for the compatibility behavior. See Terminal resize. Edit build_scene to change Fixed/Flex sizing, gaps, typed TextStyle settings, or the effects. DashboardControls builds typed bindings; build_scene attaches its targets to panels, and run passes its FocusGroup handler to Player. No action runs from drawing. See Layouts and text widgets, Scrollable views and activity logs, and Keyboard bindings and focus for the public APIs and lifecycle rules.

A layout-driven dashboard with a beam solver, live statistics and animations.

Run python -m bruhanimate.demos.dashboard_demo. Tab/Shift+Tab switches focus. Space pauses the solver or signal; solver n steps and +/- adjusts speed. Arrows/Page Up/Down/Home/End scroll the solver or activity log; End follows new log messages. Signal r remixes plasma. q quits. Snow runs independently. The original public beam fixture needs no external files, services, or tools.

bruhanimate.demos.dashboard_demo.draw_state(state: BeamState, buffer: Buffer) → None

Draw the public fixture in the solver panel’s local coordinates.

class bruhanimate.demos.dashboard_demo.DashboardControls(playback: Playback[BeamState])

Bindings and activity state; build_scene transfers views into its layout.

The solver ScrollView owns playback. Controls borrow the views once the layout owns them, and borrow the signal effect created by its panel factory.

__init__(playback: Playback[BeamState]) → None

toggle_solver() → None

step_solver() → None

faster() → None

slower() → None

toggle_signal() → None

remix_signal() → None

observe(dt: float) → None

Record progress once after each scene update; never consume snapshots.

status() → str

focus_name() → str

bruhanimate.demos.dashboard_demo.build_scene(buffer: Buffer, playback: Playback[BeamState], controls: DashboardControls | None = None) → Scene

Allocate a solver, fixed-width sidebar, header and one-row status bar.

Layouts reflow on resize; initially empty slots defer their factories. The solver panel owns a ScrollView containing playback. Supply the same DashboardControls here and to Player via controls.focus.handle_event. Input polling stays on Player; dynamic labels only read current state.

bruhanimate.demos.dashboard_demo.run(*, frames: int | None = None, fps: float = 60, on_resize: Literal['raise', 'resize'] = 'resize') → int

Play the dashboard and hold the final result until quit or the frame limit.