plack::loader::shotgun(3pm) [debian man page]

Plack::Loader::Shotgun(3pm)				User Contributed Perl Documentation			       Plack::Loader::Shotgun(3pm)

NAME

       Plack::Loader::Shotgun - forking implementation of plackup

SYNOPSIS

	 plackup -L Shotgun

DESCRIPTION

       Shotgun loader delays the compilation and execution of your application until the runtime. When a new request comes in, this forks a new
       child, compiles your code and runs the application.

       This should be an ultimate alternative solution when reloading with Plack::Middleware::Refresh doesn't work, or plackup's default "-r"
       filesystem watcher causes problems. I can imagine this is useful for applications which expects their application is only evaluated once
       (like in-file templates) or on operating systems with broken fork implementation, etc.

       This is much like good old CGI's fork and run but you don't need a web server, and there's a benefit of preloading modules that are not
       likely to change. For instance if you develop a web application using Moose and DBIx::Class,

	 plackup -MMoose -MDBIx::Class -L Shotgun yourapp.psgi

       would preload those modules and only re-evaluates your code in every request.

AUTHOR

       Tatsuhiko Miyagawa with an inspiration from <http://github.com/rtomayko/shotgun>

SEE ALSO

       plackup

perl v5.14.2							    2011-06-22					       Plack::Loader::Shotgun(3pm)

Plack::Middleware::Lint(3pm)				User Contributed Perl Documentation			      Plack::Middleware::Lint(3pm)

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

perl v5.14.2							    2011-09-22					      Plack::Middleware::Lint(3pm)