Term::ReadLine::Perl5 - A Perl5 implementation GNU Readline
use Term::ReadLine::Perl5; $term = new Term::ReadLine::Perl5 'ProgramName'; while ( defined ($_ = $term->readline('prompt>')) ) { ... }
This is a implementation of the GNU Readline/History Library written in Perl5.
GNU Readline reads lines from an interactive terminal with emacs or vi editing capabilities. It provides as mechanism for saving history of previous input.
This package typically used in command-line interfaces and REPLs (Read, Eval, Print, Loop).
Term::ReadLine::Perl->new($name, [*IN, [*OUT])
Returns a handle for subsequent calls to readline functions.
$name is the name of the application.
$name
Optionally you can add two arguments for input and output filehandles. These arguments should be globs.
This routine might also be called via Term::ReadLine->new($term_name) if other Term::ReadLine packages like Term::ReadLine::Gnu is not available or if you have $ENV{PERL_RL} set to 'Perl5';
Term::ReadLine->new($term_name)
$ENV{PERL_RL}
At present, because this code has lots of global state, we currently don't support more than one readline instance.
Somebody please volunteer to rewrite this code!
stifle_history($max)
Stifle or put a cap on the history list, remembering only $max number of lines.
$max
MinLine([$minlength])
If $minlength is given, set $readline::minlength the minimum length a $line for it to go into the readline history.
$minlength
$readline::minlength
The previous value is returned.
remove_history($which)
Remove history element $which from the history. The removed element is returned.
$which
Following GNU Readline/History Library variables can be accessed from Perl program. See 'GNU Readline Library Manual' and ' GNU History Library Manual' for each variable. You can access them via the Attribs method. Names of keys in this hash conform to standard conventions with the leading rl_ stripped.
Attribs
rl_
Example:
$term = new Term::ReadLine::Perl5 'ReadLineTest' $attribs = $term->Attribs; $v = $attribs->{history_base}; # history_base
completion_suppress_append (bool) history_base (int) history_stifled (int) history_length (int) max_input_history (int) outstream (file handle)
To install this module type:
perl Build.PL make # for interactive testing: make test # for non-interactive testing AUTOMATED_TESTING=1 make test make install # might need sudo make install
The first implementation was in Perl4 (mostly) by Jeffrey Friedl. He referenced FSF the code Roland Schemers line_edit.pl.
Ilya Zakharevich turned this into a Perl5 module called Term::ReadLine::Perl. Some of the changes he made include using Term::ReadKey if present, and made this work under xterm. The file Term/ReadLine/Perl5/CHANGES up to but not including version 1.04 contains a list of his changes.
Starting with version 1.04 Rocky Bernstein forked the code, adding GNU readline history. He put it into a public git repository (github) and also started modernizing it by doing the things CPAN prefers, including adding POD documentation, non-interactive tests, and respecting CPAN module namespaces.
Bugs are accepted via the github issues tracker.
This program is free software; you can redistribute it and/or modify it under the terms of either:
a) the GNU General Public License as published by the Free Software Foundation; version 2, or
b) the "Artistic License" which comes with Perl.
To install Term::ReadLine::Perl5, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Term::ReadLine::Perl5
CPAN shell
perl -MCPAN -e shell install Term::ReadLine::Perl5
For more information on module installation, please visit the detailed CPAN module installation guide.