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=b0fce4e4b2d9dfb1e911815169a347244622309d;hp=c7640a407241790a37ec800c75711bfe06780349;hb=e2d0b0198529e2e06593df8ebab7a8413bc932e1;hpb=6aa584927ce35a633ee66fd372f3a6c2c23aa447 diff --git a/lib/Devel/REPL.pm b/lib/Devel/REPL.pm index c7640a4..b0fce4e 100644 --- a/lib/Devel/REPL.pm +++ b/lib/Devel/REPL.pm @@ -1,15 +1,30 @@ package Devel::REPL; use Term::ReadLine; -use Moose; -use namespace::clean -except => [ 'meta' ]; +use Moo; +use namespace::sweep; use 5.008001; # backwards compat, doesn't warn like 5.8.1 -our $VERSION = '1.003000'; # 1.3.0 - -with 'MooseX::Object::Pluggable'; +our $VERSION = '1.003014'; use Devel::REPL::Error; +use Scalar::Util qw/blessed/; +use Module::Runtime (); + +sub load_plugin { + my ($self, $plugin) = @_; + $plugin = "Devel::REPL::Plugin::$plugin"; + Module::Runtime::use_module("$plugin"); + if (my $pre = $plugin->can('BEFORE_PLUGIN')) { + $pre->($self, $plugin); + } + Moo::Role->apply_roles_to_package( + 'Devel::REPL', $plugin + ); + if (my $pre = $plugin->can('AFTER_PLUGIN')) { + $pre->($self, $plugin); + } +} has 'term' => ( is => 'rw', required => 1, @@ -26,10 +41,16 @@ has 'out_fh' => ( default => sub { shift->term->OUT || \*STDOUT; } ); +has 'exit_repl' => ( + is => 'rw', required => 1, + default => sub { 0 } +); + sub run { my ($self) = @_; while ($self->run_once_safely) { - # keep looping + # keep looping unless we want to exit REPL + last if $self->exit_repl; } } @@ -51,11 +72,11 @@ sub run_once { my ($self) = @_; my $line = $self->read; - return unless defined($line); # undefined value == EOF + return unless defined($line); # undefined value == EOF my @ret = $self->formatted_eval($line); - $self->print(@ret); + $self->print(@ret) unless $self->exit_repl; return 1; } @@ -180,8 +201,8 @@ message will be returned. Here are a few examples: 1 $_ nosuchfunction Compile error: Bareword "nosuchfunction" not allowed while "strict subs" in use at (eval 130) line 5. - - $_ + + $_ In the first example above you see the output of the command (C), if any, and then the return value of the statement (C<1>). Following @@ -208,16 +229,20 @@ exported functions from that module are available for immediate use: (Do you need to predeclare carp?) Compile error: syntax error at (eval 129) line 5, near "carp "I'm dieeeing!\n"" BEGIN not safe after errors--compilation aborted at (eval 129) line 5. - - $_ use Carp - + + $_ use Carp + $_ carp "I'm dieeeing!\n" I'm dieeeing! at /usr/share/perl5/Lexical/Persistence.pm line 327 1 - $_ + $_ + +To quit from the shell, hit C or C. + + MSWin32 NOTE: control keys won't work if TERM=dumb + because readline functionality will be disabled. -To quit from the shell, hit C or C. =head2 Run Control Files @@ -277,6 +302,34 @@ L L +=item * + +L + +=item * + +L + +=item * + +L + +=item * + +L + +=item * + +L + +=item * + +L + +=item * + +L + =back =head2 Plugins @@ -289,7 +342,9 @@ 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. +above. These plugins can be loaded in your C<< $HOME/.re.pl/repl.rc >> like: + + load_plugin qw( CompletionDriver::Global DumpHistory ); Writing your own plugins is not difficult, and is discussed in the L manual page, along with links to the manual pages of @@ -322,35 +377,41 @@ the following: =item * -L >= 0.64 +L >= 0.74 =item * -L >= 0.0009 +L >= 0.18 =item * -L >= 0.15 +L =item * -L >= 0.14 +L =item * -L +L =item * -L +L =item * -L +L =item * -L +L + +=back + +Optionally, some plugins if installed will require the following modules: + +=over 4 =item * @@ -358,16 +419,36 @@ L =item * +L + +=item * + +L + +=item * + +L + +=item * + +L + +=item * + L =item * -L +L =item * L +=item * + +L + =back =head1 AUTHOR @@ -388,7 +469,15 @@ Matt S Trout - mst (at) shadowcatsystems.co.uk (L >> + +=item Norbert Buchmuller C<< >> + +=item Dave Houston C<< >> + +=item Chris Marshall =back