X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=p5sagit%2FDevel-REPL.git;a=blobdiff_plain;f=lib%2FDevel%2FREPL.pm;h=03557de3fbc9494b28cac3b0fa38000cc6d33bbc;hp=b84493169b76582fc15a5b7a4ace8e5f7645779d;hb=796cd7ec80de14e45ca8221d545aceb7b9bc0b71;hpb=e72070d72c5b10cdddcd1da281b6a6cbeccf48b4 diff --git a/lib/Devel/REPL.pm b/lib/Devel/REPL.pm index b844931..03557de 100644 --- a/lib/Devel/REPL.pm +++ b/lib/Devel/REPL.pm @@ -1,4 +1,7 @@ package Devel::REPL; +# ABSTRACT: A modern perl interactive shell + +our $VERSION = '1.003027'; use Term::ReadLine; use Moose; @@ -149,9 +152,10 @@ sub print { print $fh "\n" if $self->term->ReadLine =~ /Gnu/; } -=head1 NAME +1; +__END__ -Devel::REPL - a modern perl interactive shell +=pod =head1 SYNOPSIS @@ -199,7 +203,8 @@ which means a single statement doesn't require the semicolon. You can add one if you like, though. If you followed the first example in the L above, you'll have the -History and LexEnv plugins loaded (and there are many more available). +L and L +plugins loaded (and there are many more available). Although the shell might support "up-arrow" history, the History plugin adds "bang" history to that so you can re-execute chosen commands (with e.g. C). The LexEnv plugin ensures that lexical variables declared with the @@ -263,61 +268,20 @@ A C profile ships with C; it loads the following plugins (note that some of these require optional features -- or you can also use the C profile): -=over 4 - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=item * - -L - -=back +=for :list +* L +* L +* L +* L +* L +* L +* L +* L +* L +* L +* L +* L +* L =head2 Plugins @@ -329,7 +293,7 @@ output, or even add commands to the shell environment. A number of plugins ship with C, and more are available on the CPAN. Some of the shipped plugins are loaded in the default profile, mentioned -above. These plugins can be loaded in your C<< $HOME/.re.pl/repl.rc >> like: +above. These plugins can be loaded in your F< $HOME/.re.pl/repl.rc > like: load_plugin qw( CompletionDriver::Global DumpHistory ); @@ -363,68 +327,17 @@ distribution interactively (e.g. C). =for comment I hope to automatically generate this data via a Pod::Weaver section -=over 4 - -=item * Completion plugin - extensible tab completion - -=item * DDS plugin - better format results with Data::Dump::Streamer - -=item * DDC plugin - even better format results with Data::Dumper::Concise - -=item * INC completion driver - tab complete module names in use and require - -=item * Interrupt plugin - traps SIGINT to kill long-running lines - -=item * Keywords completion driver - tab complete Perl keywords and operators - -=item * LexEnv plugin - variables declared with "my" persist between statements - -=item * MultiLine::PPI plugin - continue reading lines until all blocks are closed - -=item * Nopaste plugin - upload a session\'s input and output to a Pastebin - -=item * PPI plugin - PPI dumping of Perl code - -=item * Refresh plugin - automatically reload libraries with Module::Refresh - -=back - -=head1 AUTHOR - -Matt S Trout - mst (at) shadowcatsystems.co.uk (L) - -=head1 CONTRIBUTORS - -=over 4 - -=item Stevan Little - stevan (at) iinteractive.com - -=item Alexis Sukrieh - sukria+perl (at) sukria.net - -=item epitaph - -=item mgrimes - mgrimes (at) cpan dot org - -=item Shawn M Moore - sartak (at) gmail.com - -=item Oliver Gorwits - oliver on irc.perl.org - -=item Andrew Moore - C<< >> - -=item Norbert Buchmuller C<< >> - -=item Dave Houston C<< >> - -=item Chris Marshall - -=item Karen Etheridge C<< >> - -=back - -=head1 LICENSE - -This library is free software under the same terms as perl itself +=for :list +* Completion plugin - extensible tab completion +* DDS plugin - better format results with Data::Dump::Streamer +* DDC plugin - even better format results with Data::Dumper::Concise +* INC completion driver - tab complete module names in use and require +* Interrupt plugin - traps SIGINT to kill long-running lines +* Keywords completion driver - tab complete Perl keywords and operators +* LexEnv plugin - variables declared with "my" persist between statements +* MultiLine::PPI plugin - continue reading lines until all blocks are closed +* Nopaste plugin - upload a session\'s input and output to a Pastebin +* PPI plugin - PPI dumping of Perl code +* Refresh plugin - automatically reload libraries with Module::Refresh =cut - -1;