# NAME Caroline - Yet another line editing library # SYNOPSIS use Caroline; my $c = Caroline->new; while (defined(my $line = $c->readline('> ')) { if ($line =~ /\S/) { print eval $line; } } # DESCRIPTION Caroline is yet another line editing library like [Term::ReadLine::Gnu](http://search.cpan.org/perldoc?Term::ReadLine::Gnu). This module supports - History handling - Complition - Portable - No C library dependency # PROJECT GOALS Provides portable line editing library for Perl5 community. # METHODS - my $caroline = Caroline->new(); Create new Caroline instance. Options are: - history\_max\_len : Str Set the limitation for max history size. - completion\_callback : CodeRef You can write completion callback function like this: my $c = Caroline->new( completion_callback => sub { my ($line) = @_; if ($line eq 'h') { return ( 'hello', 'hello there' ); } elsif ($line eq 'm') { return ( '突然のmattn' ); } return; }, ); - my $line = $caroline->read($prompt); Read line with `$prompt`. Trailing newline is removed. Returns undef on EOF. - $caroline->history\_add($line) Add $line to the history. - $caroline->history() Get the current history data in ` ArrayRef[Str] `. - $caroline->write\_history\_file($filename) Write history data to the file. - $caroline->read\_history\_file($filename) Read history data from history file. # Multi byte character support If you want to support multi byte characters, you need to set binmode to STDIN. You can add the following code before call Caroline. use Term::Encoding qw(term_encoding); my $encoding = term_encoding(); binmode *STDIN, ":encoding(${encoding})"; # LICENSE Copyright (C) tokuhirom. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. # SEE ALSO [https://github.com/antirez/linenoise/blob/master/linenoise.c](https://github.com/antirez/linenoise/blob/master/linenoise.c) # AUTHOR tokuhirom mattn