plack::middleware::conditional(3pm) [debian man page]

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

NAME

       Plack::Middleware::Conditional - Conditional wrapper for Plack middleware

SYNOPSIS

	 use Plack::Builder;

	 builder {
	     enable_if { $_[0]->{REMOTE_ADDR} eq '127.0.0.1' } 'StackTrace', force => 1;
	     $app;
	 };

	 # or using the OO interface:
	 $app = Plack::Middleware::Conditional->wrap(
	     $app,
	     condition	=> sub { $_[0]->{REMOTE_ADDR} eq '127.0.0.1' },
	     builder => sub { Plack::Middleware::StackTrace->wrap($_[0], force => 1) },
	 );

DESCRIPTION

       Plack::Middleware::Conditional is a piece of meta-middleware, to run a specific middleware component under runtime conditions. The goal of
       this middleware is to avoid baking runtime configuration options in individual middleware components, and rather share them as another
       middleware component.

EXAMPLES

       Note that some of the middleware component names are just made up for the explanation and might not exist.

	 # Minify JavaScript if the browser is Firefox
	 enable_if { $_[0]->{HTTP_USER_AGENT} =~ /Firefox/ } 'JavaScriptMinifier';

	 # Enable Stacktrace when being accessed from the local network
	 enable_if { $_[0]->{REMOTE_ADDR} =~ /^10.0.1.*/ } 'StackTrace';

	 # Work with other conditional setter middleware:
	 # Transcode Jpeg on the fly for mobile clients
	 builder {
	     enable 'MobileDetector';
	     enable_if { $_[0]->{'plack.mobile_detected'} }
	       'TranscodeJpeg', max_size => 30_000;
	     $app;
	 };

       Note that in the last example MobileDetector should come first because the conditional check runs in pre-run conditions, which is from
       outer to inner: that is, from the top to the bottom in the Builder DSL code.

AUTHOR

       Tatsuhiko Miyagawa

       Steve Cook

SEE ALSO

       Plack::Builder

perl v5.14.2							    2012-04-14				       Plack::Middleware::Conditional(3pm)

Plack::Middleware::File::Sass(3pm)			User Contributed Perl Documentation			Plack::Middleware::File::Sass(3pm)

NAME

       Plack::Middleware::File::Sass - Sass and SCSS support for all Plack frameworks

SYNOPSIS

	 use Plack::App::File;
	 use Plack::Builder;

	 builder {
	     mount "/stylesheets" => builder {
		 enable "File::Sass";
		 Plack::App::File->new(root => "./stylesheets");
	     };
	 };

	 # Or with Middleware::Static
	 enable "File::Sass", syntax => "scss";
	 enable "Static", path => qr/.css$/, root => "./static";

DESCRIPTION

       Plack::Middleware::File::Sass is a Plack middleware component that works with Plack::App::File or Plack::Middleware::Static to compile Sass
       <http://sass-lang.com/> templates into CSS stylesheet in every request.

       When a request comes in for .css file, this middleware changes the internal path to .sass or .scss, depending on the configuration, in the
       same directory. If the Sass template is found, a new CSS stylesheet is built on memory and served to the browsers.  Otherwise, it falls
       back to the original .css file in the directory.

       This middleware should be very handy for the development. While Sass to CSS rendering is reasonably fast, for the production environment
       you might want to precompile Sass templates to CSS files on disk and serves them with a real web server like nginx or lighttpd.

SASS BACKENDS

       If you have the sass gem version higher than 3 installed and have the "sass" executable available in your PATH, this module automatically
       uses the command to convert Sass or SCSS into CSS. If the command is not available and you have Text::Sass perl module available, it will
       be used. Otherwise you'll get an exception during the initialization of this middleware component.

OPTIONS

       syntax
	   Defines which syntax to use. Valid values are sass and scss. Defaults to sass.

AUTHOR

       Tatsuhiko Miyagawa <miyagawa@bulknews.net>

LICENSE

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

SEE ALSO

       Plack::App::File Text::Sass http://sass-lang.com/ <http://sass-lang.com/>

perl v5.12.4							    2011-02-14					Plack::Middleware::File::Sass(3pm)