NAME

Plack::Middleware::REPL - REPL when your application throws errors or warnings

SYNOPSIS

  enable "REPL";

DESCRIPTION

Plack::Middleware::REPL is a PSGI middleware component that enables REPL (read-eval-print-loop) when your application raises errors.

  # your Dancer app
  use Dancer;
  get '/' => sub {
      my $self = shift;
      my $n = parms()->{name}; # typo
      return "Hi there $n";
  };
  dance;

Run it with the REPL middleware:

  plackup -e 'enable "REPL"' app.pl

Hit your application, and you'll get a REPL shell on the console:

  Trace begun at ...
  ...
  $ :l
  File /Users/miyagawa/development/dancer/app.pl
    5: use Dancer;
    6:
    7: get '/' => sub {
    8:     my $self = shift;
  * 9:     my $n = parms()->{name};
   10:     return "Hi there $n";
   11: };
   12: dance;
  $ request->path
  /
  $ :u
  Now at /Users/miyagawa/perl5/perlbrew/perls/perl-5.12.3/lib/site_perl/5.12.3/Dancer/Route.pm:246 (frame 1).
  $ $self
  $Dancer_Route1 = Dancer::Route=HASH(0x10089d278);

See Carp::REPL for more commands in the REPL shell.

OPTIONS

warn

  enable "REPL", warn => 1;

Also enables REPL when your app throws warnings.

LIMITATIONS

Because of the way $SIG{__DIE__} works in Perl, this middleware doesn't work well with web application frameworks that sets its own exception handler, such as Mojolicious.

AUTHOR

Tatsuhiko Miyagawa <miyagawa@bulknews.net>

COPYRIGHT

Copyright 2011- Tatsuhiko Miyagawa

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Carp::REPL Devel::REPL CatalystX::REPL