Fetching contributors…
Cannot retrieve contributors at this time
357 lines (277 sloc) 9.98 KB
use v6;
unit class Terminal::Print;
=begin pod
=title Terminal::Print
=head1 Synopsis
L<Terminal::Print> implements an abstraction layer for printing characters to
terminal screens with full Unicode support and -- crucially -- the ability to
print from concurrent threads. The idea is to provide all the necessary
mechanical details while leaving the actual so called 'TUI' abstractions to
higher level libraries.
Obvious applications include snake clones, rogue engines and golfed art works :)
Oh, and Serious Monitoring Apps, of course.
=head1 Usage
L<Terminal::Print> creates you an object for you when you import it, stored in
C<$Terminal::Print::T>. It also creates a constant C<T> for you in the C<OUR::>
Thus common usage would look like this:
=for code
T.print-string(20, 20,;
=head1 Miscellany
=head2 Where are we at now?
All the features you can observe while running C<perl6 t/basics.t> work using
the new react/supply based L<Terminal::Print::Grid>. If you run that test file,
you will notice that C<Terminal::Print> is needing a better test harness.
Part of that is getting a C<STDERR> or some such pipe going, and printing state/
That will make debugging a lot easier.
Testing a thing that is primarily designed to print to a screen seems a bit
difficult anyway. I almost think we should make it interactive. 'Did you see a
screen of hearts?'
So: async (as mentioned above), testing, and debugging are current pain points.
Contributions welcome.
=head2 Why not just use L<NativeCall> and C<ncurses>?
I tried that first and it wasn't any fun. C<ncurses> unicode support is
admirable considering the age and complexity of the library, but it
still feels bolted on.
C<ncurses> is not re-entrant, either, which would nix one of the main benefits
we might be able to get from using Perl 6 -- easy async abstractions.
=end pod
use Terminal::Print::Grid;
use Terminal::Print::Widget;
has Terminal::Print::Grid $.current-grid handles 'indices';
has Terminal::Print::Grid @.grids;
has %!grid-name-map;
has %!root-widget-map{Terminal::Print::Grid};
has $.columns;
has $.rows;
use Terminal::Print::Commands;
subset Valid::X of Int is export where * < %T::attributes<columns>;
subset Valid::Y of Int is export where * < %T::attributes<rows>;
subset Valid::Char of Str is export where *.chars == 1;
has Terminal::Print::CursorProfile $.cursor-profile;
has $.move-cursor;
method new( :$cursor-profile = 'ansi' ) {
my $columns = Terminal::Print::Commands::columns;
my $rows = Terminal::Print::Commands::rows;
my $move-cursor = move-cursor-template($cursor-profile);
my $current-grid = $columns, $rows, :$move-cursor );
self.bless( :$columns, :$rows, :$current-grid,
:$cursor-profile, :$move-cursor );
submethod BUILD( :$!current-grid, :$!columns, :$!rows, :$!cursor-profile, :$!move-cursor ) {
push @!grids, $!current-grid;
# set up a tap on SIGINT so that we can cleanly shutdown, restoring the previous screen and cursor
signal(SIGINT).tap: {
die "Encountered a SIGINT. Cleaning up the screen and exiting...";
method root-widget() {
my $grid = self.current-grid;
%!root-widget-map{$grid} ||=$grid);
method add-grid( $name?, :$new-grid = $!columns, $!rows, :$!move-cursor ) ) {
push @!grids, $new-grid;
if $name {
%!grid-name-map{$name} = +@!grids-1;
multi method switch-grid( Int $index, :$blit ) {
die "Grid index $index does not exist" unless @!grids[$index]:exists;
self.blit($index) if $blit;
$!current-grid = @!grids[$index];
multi method switch-grid( Str $name, :$blit ) {
die "No grid has been named $name" unless my $index = %!grid-name-map{$name};
self.blit($index) if $blit;
$!current-grid = @!grids[$index];
method blit( $grid-identifier = 0 ) {
# 'clear' will also work through the FALLBACK
method clear-screen {
print-command <clear>;
method initialize-screen {
print-command <save-screen>;
print-command <hide-cursor>;
print-command <clear>;
method shutdown-screen {
print-command <clear>;
print-command <restore-screen>;
print-command <show-cursor>;
method print-command( $command ) {
print-command($command, $!cursor-profile);
# AT-POS hands back a Terminal::Print::Column
# $b[$x]
# Because we have AT-POS on the column object as well,
# we get
# $b[$x][$y]
method AT-POS( $column-idx ) {
$!current-grid.grid[ $column-idx ];
# AT-KEY returns the Terminal::Print::Grid.grid of whichever the key specifies
# $b<specific-grid>[$x][$y]
method AT-KEY( $grid-identifier ) {
self.grid( $grid-identifier );
multi method CALL-ME($x, $y) {
$!current-grid.print-cell($x, $y);
multi method CALL-ME($x, $y, %c) {
$!current-grid.print-cell($x, $y, %c);
multi method CALL-ME($x, $y, $c) {
$!current-grid.print-string($x, $y, $c);
multi method FALLBACK( Str $command-name where { %T::human-command-names{$_} } ) {
print-command( $command-name );
# multi method sugar:
# @!grids and @!buffers can both be accessed by index or name (if it has
# one). The name is optionally supplied when calling .add-grid.
# In the case of @!grids, we pass back the grid array directly from the
# Terminal::Print::Grid object, actually notching both DWIM and DRY in one swoosh.
# because you can do things like $b.grid("background")[42][42] this way.
multi method grid() {
multi method grid( Int $index ) {
multi method grid( Str $name ) {
die "No grid has been named $name" unless my $grid-index = %!grid-name-map{$name};
#### grid-object stuff
# Sometimes you simply want the object back (for stringification, or
# introspection on things like column-range)
multi method grid-object( Int $index ) {
multi method grid-object( Str $name ) {
die "No grid has been named $name" unless my $grid-index = %!grid-name-map{$name};
multi method print-cell( $x, $y ) {
$!current-grid.print-cell($x, $y);
multi method print-cell( $x, $y, Str $c ) {
$!current-grid.print-cell($x, $y, $c);
multi method print-cell( $x, $y, %c ) {
$!current-grid.print-cell($x, $y, %c);
multi method print-string( $x, $y, Str() $string) {
$!current-grid.print-string($x, $y, $string);
multi method print-string( $x, $y, Str() $string, $color) {
$!current-grid.print-string($x, $y, $string, $color);
method change-cell( $x, $y, Str $c ) {
$!current-grid.change-cell($x, $y, $c);
#### print-grid stuff
multi method print-grid( Int $index ) {
die "Grid index $index does not exist" unless @!grids[$index]:exists;
print @!grids[$index];
multi method print-grid( Str $name ) {
die "No grid has been named $name" unless my $index = %!grid-name-map{$name};
print @!grids[$index];
# method !clone-grid-index( $origin, $dest? ) {
# my $new-grid;
# if $dest {
# $new-grid := self.add-grid($dest, new-grid => @!grids[$origin].clone);
# } else {
# @!grids.push: @!grids[$origin].clone;
# }
# return $new-grid;
# }
# #### clone-grid stuff
# multi method clone-grid( Int $origin, Str $dest? ) {
# die "Invalid grid '$origin'" unless @!grids[$origin]:exists;
# self!clone-grid-index($origin, $dest);
# }
# multi method clone-grid( Str $origin, Str $dest? ) {
# die "Invalid grid '$origin'" unless my $grid-index = %!grid-name-map{$origin};
# self!clone-grid-index($grid-index, $dest);
# }
method Str {
method gist {
"\{ cols: {self.columns} rows: {self.rows} which: {self.WHICH} grid: {self.current-grid.WHICH} \}";
=begin Golfing
The golfing mechanism is minimal. Further golfing functionality may be added via third party modules,
but the following features seemed to fulfill a 'necessary minimum' set of golfing requirements:
- Not being subjected to a constructor command, certainly not against the full name of the class
+ Solved via 'T'
- Having a succinct subroutine form which can initialize and shutdown the screen automatically
+ Solved via 'draw'
- Easy access to .print-string, sleep, colorization, and the grid indices list. (Even easier than using T());
+ Solved via 'd', 'w', 'h', 'p', 'cl', 'ch', 'slp', 'fgc', 'bgc', 'in'
=end Golfing
our $T = PROCESS::<$TERMINAL> =;
sub draw(Callable $block) is export {
my $drawn-promise =;
start {
my $end-promise =;
await $end-promise;
await $drawn-promise;
sub d($block) is export {
multi sub p($x, $y) is export {
$T.current-grid.print-string($x, $y);
multi sub p($x, $y, $string) is export {
$T.current-grid.print-string($x, $y, $string);
multi sub p($x, $y, $string, $color) is export {
$T.current-grid.print-string($x, $y, $string, $color);
multi sub ch($x, $y, $char) is export {
$T.current-grid.change-cell($x, $y, $char);
multi sub ch($x, $y, $char, $color) is export {
$T.current-grid.change-cell($x, $y, %(:$char, :$color) );
multi sub cl($x, $y, $char) is export {
$T.current-grid.print-cell($x, $y, $char);
multi sub cl($x, $y, $char, $color) is export {
$T.current-grid.print-cell($x, $y, %(:$char, :$color) );
sub slp($seconds) is export {
sleep $seconds;
my package EXPORT::DEFAULT {
OUR::{ 'T' } := $Terminal::Print::T;
OUR::{ 'w' } := $Terminal::Print::T.columns;
OUR::{ 'h' } := $Terminal::Print::T.rows;
OUR::{ 'in' } := $Terminal::Print::T.indices;
OUR::{ 'fgc' } := @Terminal::Print::Commands::fg_colors;
OUR::{ 'bgc' } := @Terminal::Print::Commands::bg_colors;