package console
Build not yet checked sectionYPositions = computeSectionYPositions($el), 10)"
x-init="setTimeout(() => sectionYPositions = computeSectionYPositions($el), 10)"
>
On This Page
Colours, tables, trees and progress rows for the terminal
Install
dune-project
Dependency
Authors
Maintainers
Sources
console-0.10.1.tbz
sha256=37ad65f6833c65814b0673f009f6b656c5194608ca03519da2e63e1051d54f6e
sha512=7677067f1a3244779cdbc5c90a8b0e1eba30c3fd58281584ea3d4c46c3e219eef0668588ca0e2938799c61a3fa831ce2146eac73717214d7baf96b497bfcd892
doc/CHANGES.html
0.10.1 (18/11/2026)
Fixed
consoleandconsole-eiobuild with OxCaml (#99).- Windows: the tests of
consoleandconsole-eiopass in opam builds, which ran every Eio program on the posix backend that Windows lacks (#101).
0.10.0 (17/11/2026)
Added
New packages and libraries:
console-lwtshows progress rows in a program that runs with Lwt. It runs in real time, even underCONSOLE_CAST(#67).console.driverruns console on any scheduler. A backend gives it a clock, fiber-local values, wake-ups and cancellation (#61, #67).console.cligives a Cmdliner program--themeand--coloroptions (#78, reported by @toastal).
- Themes:
Theme.set_programsets the theme of every formatter that has no theme of its own, including the onesFmt.strcreates (#78, reported by @toastal). - Widgets:
View.wrap ~wordschooses where a line may break (#2).Color.gradientgives the colour at any point of a gradient (#9), andBorder.with_gradientdraws frames in one (#12). - Progress rows:
Task.advancesteps a task without keeping the count (#8), andProgress.Layout.label ~widthfixes the label column (#75). - Printers:
Progress.pp_durationprints a duration as the rows do (#4).Progress.ppandRoom.ppprint a mode or a room in a log (#34, #53). - Terminal:
Console_tty.widthfits output printed outside a run to the terminal (#13, #23, #61).Env.setupandEnv.ensureapply the colour rules without Unix (#11). Console_input.crlfwrites lines for a raw-mode terminal (#3).- Numbers:
Decimal.string_of_floatandDecimal.ppprint a float with a fixed count of decimals, the same on every platform, wherePrintfrounds a tie as the C library does (#88). - Eio:
Console_eio.redrawdraws the display at once (#10), andConsole_eio.domain_mgrkeeps recordings of programs with domains reproducible (#66).
Changed
- Themes:
Console_tty.setup ~themenow sets the program's theme, soView.to_stringand strings built withFmt.struse it too (#78, reported by @toastal).Theme.default's accent is now bright blue (#75). Console_eio.sizeis nowConsole_tty.size: reading a terminal's size needs no scheduler (#61).- Progress rows keep their columns, so steps line up in the scrollback, and look calmer: a finished bar and the lines under a running row are muted, a failed or cancelled bar red or yellow (#65, #75).
- Text: wrapped text no longer breaks after a slash, so paths and URLs stay whole (#2).
Logs.appmessages lose their[source]prefix (#5). Console_inputlimits a line to 4095 bytes, and rings the bell past that. It keeps the newest 500 lines of history (#1).$COLUMNSand$LINESset the output size on a terminal as on a pipe, as POSIX says. Values that are not decimal numbers are ignored (#7, #20, #49).CONSOLE_DETERMINISTIC_CLOCKnow jumps time to the next sleep, asCONSOLE_CASTdoes. Under either variable, using the clock from another domain raisesInvalid_argument(#66).- Ctrl-Z now stops a program under
Console_eio.run(#29). Ctrl-C,Out_of_memoryandStack_overflowraised in a view reach the program at once (#53). - Progress updates cost less, and linking console no longer builds tables at startup (#30, #40, #64).
- The tests need matrix 0.2.0 and k7 0.10.0 (#74, #77, reported by @toastal).
Fixed
- A short byte count in a narrow row, such as
1.3K, now has the same digits on Windows as elsewhere (#88). - The terminal is given back, with its cursor shown, when a view, a hook or the output raises, when a view calls
exit, when a run is cancelled, and when a signal or anexitcannot reach the display (#26, #37, #42, #43, #70). - Domains:
TaskandDisplaywork from any domain, and a run joins the one under way (#57). Logs from workers or systhreads no longer hang or raise, and a new domain keeps the capture and recording (#37, #39, #59, #66). - Windows: a run no longer raises
Invalid_argumentat start, because Windows has no SIGTSTP (#79). A program whose display writes to a pipe that closes now exits as it returns, not with status 2 (#93). - Errors: an exception from
commitorplainno longer escapesTask.run(#26), and a closed output pipe no longer raises (#18). A task ends once when interrupted as it ends (#41). - Cancellation: a cancelled fiber stops in the view instead of at the next redraw (#42). An update cut short no longer erases lines above the display (#27).
- Running
Console_lwt.runandConsole_eio.runat the same time now raisesInvalid_argumentinstead of opening a second display (#82). - Finished tasks no longer go missing from the scrollback after a long failure, and tasks started under a finished one stay within the 1 MiB bound (#82).
- Layout: progress rows short of room keep their columns (#58), and a
Progress.Layout.constorcustompiece stays on one line (#82). - Sizes:
Bar.horizontal ~brackets:truefills a huge width (#60).View.sizedandView.placetreat a negative size as0, andGuide.vdraws a control character as a space (#82). CONSOLE_CASTrecordings are valid asciicast v2 (#50).
0.9.0 (29/10/2026)
Initial release of console and console-eio.
sectionYPositions = computeSectionYPositions($el), 10)"
x-init="setTimeout(() => sectionYPositions = computeSectionYPositions($el), 10)"
>
On This Page