text::micromason::compilecache(3pm) [debian man page]

MicroMason::CompileCache(3pm)				User Contributed Perl Documentation			     MicroMason::CompileCache(3pm)

NAME

       Text::MicroMason::CompileCache - Use a Cache for Template Compilation

SYNOPSIS

       Instead of using this class directly, pass its name to be mixed in:

	   use Text::MicroMason;
	   my $mason = Text::MicroMason->new( -CompileCache );

       Use the standard compile and execute methods to parse and evalute templates:

	   print $mason->execute( text=>$template, 'name'=>'Dave' );

       The template does not have to be parsed the second time because it's cached:

	   print $mason->execute( text=>$template, 'name'=>'Bob' );

       Templates stored in files are also cached, until the file changes:

	   print $mason->execute( file=>"./greeting.msn", 'name'=>'Charles');

DESCRIPTION

   Public Methods
       compile()
	   Caching wrapper around normal compile() behavior.

   Supported Attributes
       compile_cache_text
	   Defaults to an instance of Text::MicroMason::Cache::Simple. You may pass in your own cache object.

       compile_cache_file
	   Defaults to an instance of Text::MicroMason::Cache::File. You may pass in your own cache object.

       This module uses a simple cache interface that is widely supported: the only methods required are "get($key)" and "set($key, $value)". You
       can use the simple cache classes provided in the Text::MicroMason::Cache:: namespace, or select other caching modules on CPAN that support
       the interface described in Cache::Cache.

SEE ALSO

       For an overview of this templating framework, see Text::MicroMason.

       This is a mixin class intended for use with Text::MicroMason::Base.

       For distribution, installation, support, copyright and license information, see Text::MicroMason::Docs::ReadMe.

perl v5.10.1							    2007-01-29					     MicroMason::CompileCache(3pm)

MicroMason::Debug(3pm)					User Contributed Perl Documentation				    MicroMason::Debug(3pm)

NAME

       Text::MicroMason::Debug - Provide developer info via warn

SYNOPSIS

       Instead of using this class directly, pass its name to be mixed in:

	 use Text::MicroMason;
	 my $mason = Text::MicroMason->new( -Debug );

       Use the standard compile and execute methods to parse and evalute templates:

	 print $mason->compile( text=>$template )->( @%args );
	 print $mason->execute( text=>$template, @args );

       You'll see lots of warning output on STDERR:

	 MicroMason Debug create: Text::MicroMason::Base::AUTO::Debug...
	 MicroMason Debug source: q(Hello <% $noun %>!)
	 MicroMason Debug lex: text, q(Hello ), expr, q( $noun ), text, q(!)
	 MicroMason Debug eval: sub { my @OUT; my $_out = sub { push ...

DESCRIPTION

       This package provides numerous messages via warn for developer use when debugging templates built with Text::MicroMason.

   Supported Attributes
       debug
	   Activates debugging messages for many methods. Defaults to logging everything.

	   Can be set to 0 or 1 to log nothing or everything.

	   Alternately, set this to a hash reference containing values for the steps you are interested in to only log this items:

	     debug => { source => 1, eval => 1 }

	   You can also selectively surpress some warnings:

	     debug => { default => 1, source => 0, eval => 0 }

   Private Methods
       debug_msg
	   Called to provide a debugging message for developer reference. No output is produced unless the object's 'debug' flag is true.

SEE ALSO

       For an overview of this templating framework, see Text::MicroMason.

       This is a mixin class intended for use with Text::MicroMason::Base.

       For distribution, installation, support, copyright and license information, see Text::MicroMason::Docs::ReadMe.

perl v5.10.1							    2007-01-29						    MicroMason::Debug(3pm)