streaming

Documentation

Overview

Command streaming is a runnable harness for tuikit.StreamingMarkdown: an endless generated markdown document, streamed a character at a time, so the boundary handling can be watched rather than inferred from tests.

Watch for a partial code fence arriving already highlighted, the boundary advancing steadily rather than stalling, and no corrupted output at high rates. -raw restores the verbatim tail this shipped with first.

go run ./examples/streaming -seed=7 -cps=80 -block=3 -debug
go run ./examples/streaming -seed=7 -cps=400 -block=12   # long fences

-reveal swaps the raw tail for the display clock prototyped in docs/notes/streaming-reveal.md: settled blocks are played out a word at a time and nothing unfinished is ever drawn. Run the same seed both ways to compare them — the trade is reflow, which goes to zero, against a freeze inside a long fence, which the status bar reports.

-hold scales the reserve the display keeps unplayed to ride out that freeze. It sizes itself from the observed gap between blocks, so the flag is here to take the before/after in one binary rather than to be tuned: -hold=0 restores the eager clock that freezes for eleven seconds.

go run ./examples/streaming -seed=7 -cps=80 -reveal -debug
go run ./examples/streaming -seed=7 -cps=200 -block=12 -reveal -debug
go run ./examples/streaming -seed=7 -cps=200 -block=12 -reveal -hold=0   # the freeze