oracular (3) Plack::Middleware::Lint.3pm.gz

NAME

       Plack::Middleware::Lint - Validate request and response

SYNOPSIS

         use Plack::Middleware::Lint;

         my $app = sub { ... }; # your app or middleware
         $app = Plack::Middleware::Lint->wrap($app);

         # Or from plackup
         plackup -e 'enable "Lint"' myapp.psgi

DESCRIPTION

       Plack::Middleware::Lint is a middleware component to validate request and response environment formats.
       You are strongly suggested to use this middleware when you develop a new framework adapter or a new PSGI
       web server that implements the PSGI interface.

       This middleware is enabled by default when you run plackup or other launcher tools with the default
       environment development value.

DEBUGGING

       Because of how this middleware works, it may not be easy to debug Lint errors when you encounter one,
       unless you're writing a PSGI web server or a framework.

       For example, when you're an application developer (user of some framework) and see errors like:

         Body should be an array ref or filehandle at lib/Plack/Middleware/Lint.pm line XXXX

       there's no clue about which line of your application produces that error.

       We're aware of the issue, and have a plan to spit out more helpful errors to diagnose the issue. But
       until then, currently there are some workarounds to make this easier. For now, the easiest one would be
       to enable Plack::Middleware::REPL outside of the Lint middleware, like:

         plackup -e 'enable "REPL"; enable "Lint"' app.psgi

       so that the Lint errors are caught by the REPL shell, where you can inspect all the variables in the
       response.

AUTHOR

       Tatsuhiko Miyagawa

       Tokuhiro Matsuno

SEE ALSO

       Plack