Retracted: v1.0.0 is a 2019 cosmos/gaia build from before this repository was World Engine. The proxy still lists
it, so @latest resolved to it. v1.0.1 only publishes this retraction.
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func BuildProgress ¶
BuildProgress adapts docker.Client.BuildCardinalImages' progress callback. imageNames pre-seeds every row as Pending ("queued") before its first Progress event, so not-yet-started builds show immediately instead of popping in late.
func ClusterLogRow ¶
ClusterLogRow returns an OnK3DLog-compatible func(string) that live-updates one row's detail with each k3d log line. Each call site owns its own Session, so — unlike the bare-spinner approach it replaces — no global routing between concurrent sessions is needed.
func PullProgress ¶
PullProgress adapts docker.Client.PullImages' progress into row updates: a real percent bar while pulling (Current is already 0-100), swapping to a done/failed icon row once the pull finishes.
Types ¶
type Dashboard ¶
type Dashboard struct {
// contains filtered or unexported fields
}
Dashboard is one continuous bubbletea program spanning every section a command opens (e.g. "Image Pull", "Build", "Cluster", "Shards" for `world start`), rendered through a single Model so there's no hand-off gap where one box's border could visually merge with the next.
func Start ¶
Start opens a dashboard scoped to ctx: Ctrl+C cancels the shared context, so a cancellation is visible to every later section too, not just the active one. Callers should `defer dash.Complete()` immediately.
func (*Dashboard) Complete ¶
func (d *Dashboard) Complete()
Complete stops the dashboard's program, leaving every section's final frame — rows and all — in the terminal scrollback. Idempotent: callers `defer dash.Complete()` and may also call it early to release the terminal before writing to it directly, so the deferred second call must be a no-op.
func (*Dashboard) Info ¶
Info adds a titled section showing body as static, finished content — no spinner, rows, or icon. For content that isn't a pass/fail task (e.g. endpoint URLs), since Run's summary always carries a ✓/✗ icon that reads oddly there.
func (*Dashboard) Run ¶
func (d *Dashboard) Run( title string, fn func(ctx context.Context, sess Session) error, summarize func(err error, elapsed time.Duration) (summary string, failed bool), ) error
Run opens a new titled section, runs fn with a Session scoped to it, then appends summarize's result below its rows (which stay visible, not replaced). Mirrors spinner.Run's shape: fn gets the dashboard's shared, Ctrl+C-cancelable context, and a resulting context.Canceled becomes a silent error instead of a printed stack trace.
type Model ¶
type Model struct {
// contains filtered or unexported fields
}
Model is the bubbletea model backing a Dashboard — one continuous program spanning every section opened during a command's run, rendered as a single box (style.MultiSectionBox). Routing every section through one Model instead of one tea.Program per section avoids the hand-off gap where a second program's first frame could land on the first program's last row.
type Row ¶
Row is one line within a section, keyed externally by an id (see rowMsg / progressMsg). Progress is non-nil only for a percent-bar row (set by UpsertProgress); a later plain UpsertRow call for the same id replaces the Row wholesale, implicitly clearing it back to an icon-rendered row.
type RowState ¶
type RowState int
RowState is the lifecycle state of a single row within a phasebox.
const ( // Pending marks a row that hasn't started yet (e.g. a build queued // behind another). Pending RowState = iota // Active marks a row currently in progress; it renders with the box's // shared animated spinner frame. Active // Done marks a row that finished successfully. Done // Failed marks a row that errored. Failed )
type Session ¶
type Session interface {
// UpsertRow renders id's row as an icon (per state) + label + detail.
UpsertRow(id, label, detail string, state RowState)
// UpsertProgress renders id's row as label + a percent-complete bar
// (e.g. "golang:1.26.2 ████████░░░░░░░░ 42%") instead of an icon, for
// determinate operations like image pulls. Always implicitly Active;
// follow with UpsertRow(..., Done/Failed) to swap back to an icon row.
UpsertProgress(id, label string, percent int)
}
Session is the live handle into a running phasebox, scoped to the lifetime of one Run call. UpsertRow/UpsertProgress insert a row on first use (by id) and update it on every subsequent call; rows render in first-insertion order.
type StepTracker ¶
type StepTracker struct {
// contains filtered or unexported fields
}
StepTracker turns a sequence of named steps (e.g. cluster.StartOpts.OnStep) into a live checklist of Session rows: each Next call marks the previous step Done and starts the next Active, showing which phase a multi-phase operation is in instead of one static spinner.
func NewStepTracker ¶
func NewStepTracker(sess Session) *StepTracker
NewStepTracker returns a tracker that pushes rows into sess.
func (*StepTracker) Detail ¶
func (t *StepTracker) Detail(detail string)
Detail updates the current step's trailing detail text (e.g. a log line) without changing its state. No-op before the first Next call.
func (*StepTracker) Done ¶
func (t *StepTracker) Done()
Done marks the current (final) step Done. Call once the whole sequence finishes successfully. No-op before the first Next call.
func (*StepTracker) Failed ¶
func (t *StepTracker) Failed(detail string)
Failed marks the current step Failed with detail (typically the error). No-op before the first Next call.
func (*StepTracker) Next ¶
func (t *StepTracker) Next(label string)
Next marks the current step (if any) Done and starts a new Active row for label.
Source Files