A REPL to experiment with Term::ReadLine::Perl5
treps.pl # enter the shell
The program serves several purposes.
For the person who interacts with Term::ReadLine::Perl5 as a result of using a program that makes use of this library e.g. Devel::Trepan, this program can be used to give you an understanding of what the capabilities are and how you might bind keys to make use of the libraries editing capabilites.
For the person who wants to use the Term::ReadLine::Perl5 API, this is a pretty solid example of how to use this library. It contains a multi-level dynamic completion and saves text in a command history.
It can also be used as an example for how to write a command shell where:
each command is its own module with OO properties like, help text, min and max arguments
command help text is in pod format that appears nicely on terminals while also appearing nicely in the POD that appears publically
the number of parameters passed are checked for validity
each command can control its command completion
There's much that can be done here. Please also feel free to modify for other readlines like Term::ReadLine::Gnu or Caroline.
Copyright (c) 2014 Rocky Bernstein.
This program is distributed WITHOUT ANY WARRANTY, including but not limited to the implied warranties of merchantability or fitness for a particular purpose.
The program is free software. You may distribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation (either version 2 or any later version) and the Perl Artistic License as published by O’Reilly Media, Inc. Please open the files named gpl-2.0.txt and Artistic for a copy of these licenses.
To install Term::ReadLine::Perl5::Demo::Cmd, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Term::ReadLine::Perl5::Demo::Cmd
CPAN shell
perl -MCPAN -e shell install Term::ReadLine::Perl5::Demo::Cmd
For more information on module installation, please visit the detailed CPAN module installation guide.