make
0.1.5
change auth
A framework for building terminal interfaces.
Create a box in full screen with some text in it, wait for a key, then exit:
use Terminal::UI 'ui';
ui.setup(:1pane);
ui.pane.put("Hello world.");
ui.get-key;
ui.shutdown;
╔══════════════╗
║Hello world. ║
║ ║
╚══════════════╝
Make a screen split with a line in the middle, with scrollable text on the top and bottom, and a selected row in the top box. The arrow keys (or j,k) move the selected line up and down. Tab switches to the other box.
use Terminal::UI 'ui';
ui.setup(:2panes);
ui.panes[0].put("$_") for 1..10;
ui.panes[1].put("$_") for <hello world>;
ui.interact;
ui.shutdown;
╔══════════════╗
║8 ║ <- selected in green, scrollable
║9 ║
║10 ║
╟──────────────╢
║hello ║ <- selected in grey.
║world ║
╚══════════════╝
Like example 2, but also -- pressing Enter in the top box will some text about add the currently selected row to the bottom box:
ui.setup(:2panes);
ui.panes[0].put("$_") for 1..10;
ui.panes[0].on: select => -> :$raw, :$meta {
ui.panes[1].put("you chose $raw!")
}
ui.interact;
ui.shutdown;
╔══════════════╗
║8 ║ <- press Enter, and…
║9 ║
║10 ║
╟──────────────╢
║you chose 8! ║ <- …this appears!
║ ║
╚══════════════╝
Easy to quickly make a console interface with custom behavior, but practical defaults.
Scrolling with some optimization, such as using ANSI scroll region escape sequences.
Thread safe. Concurrency friendly. Unicode compatibile.
Dynamic geometry calculation, for smart handling of window resizing.
See the eg directory.
https://blog.matatu.org/terminal-ui
The best place for documentation is the examples directory.
There is also reference documentation with links to the source code -- see Terminal::UI. Other classes with documentation are:
Probably!
If you find some bugs, or just have something to say, feel free to contact the author.
Brian Duggan (bduggan at matatu.org)