Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

padre::cache(3pm) [debian man page]

Padre::Cache(3pm)					User Contributed Perl Documentation					 Padre::Cache(3pm)

NAME

       Padre::Cache - The Padre Temporary Data Cache API

DESCRIPTION

       Padre::Cache implements a light memory only caching mechanism which is designed to support GUI objects that need to temporarily store state
       data.

       By providing this caching in a neutral location that is not directly bound to the user interface objects, the cached data can survive
       destruction and recreation of those interface objects.

       This is particularly valuable for situations such as a shift in the active language or the relocation of a tool that would result in
       interface objects being rebuilt.

       Cache data is stored in a "Stash", which is a "HASH" reference containing arbitrary content, and is keyed off a project or document.

METHODS

   stash
	 my $stash = Padre::Cache->stash( 'Padre::Wx::MyClass' => $project );

       The "stash" method fetches the "HASH" reference stash for a particular key pair, which consists of a GUI class name and a project or
       document.

       The "HASH" reference returned can be used directly withouth the need to do any kind of "get" or "set" call to the stash.

       Calling "stash" multiple times is guarenteed to fetch the same "HASH" reference.

   release
	   Padre::Cache->release( $project->root );

       The "release" method is used to flush all of the stash data related to a particular project root or file name for all of the GUI elements
       that make use of stash objects from Padre::Cache.

       Although this method is available for use, it should generally not be called directly. The built in "DESTROY" for both project and document
       objects will call this method for you, automatically cleaning up the stash data when the project or document itself is destroyed.

COPYRIGHT &; LICENSE
       Copyright 2008-2012 The Padre development team as listed in Padre.pm.

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

       The full text of the license can be found in the LICENSE file included with this module.

perl v5.14.2							    2012-06-27							 Padre::Cache(3pm)

Check Out this Related Man Page

Padre::PPI::UpdateCopyright(3pm)			User Contributed Perl Documentation			  Padre::PPI::UpdateCopyright(3pm)

NAME

       Padre::PPI::UpdateCopyright - Demonstration transform

SYNOPSIS

	 my $transform = Padre::PPI::UpdateCopyright->new(
	     name => 'Adam Kennedy'
	 );
	 $transform->apply( Padre::Current->document );

DESCRIPTION

       "Padre::PPI::UpdateCopyright" provides a demonstration of a typical Padre::Transform class.

       This class implements a document transform that will take the name of an author and update the copyright statement to refer to the current
       year, if it does not already do so.

METHODS

   new
	 my $transform = Padre::PPI::UpdateCopyright->new(
	     name => 'Adam Kennedy'
	 );

       The "new" constructor creates a new transform object for a specific author. It takes a single "name" parameter that should be the name (or
       longer string) for the author.

       Specifying the name is required to allow the changing of a subset of copyright statements that refer to you from a larger set in a file.

   name
       The "name" accessor returns the author name that the transform will be searching for copyright statements of.

TO DO

       May need to overload some methods to forcefully prevent Document objects becoming children of another Node.

SUPPORT

       See the support section in the main module.

AUTHOR

       Adam Kennedy <adamk@cpan.org>

COPYRIGHT

       Copyright 2009-2010 The Padre development team as listed in Padre.pm.

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

       The full text of the license can be found in the LICENSE file included with this module.

perl v5.14.2							    2012-06-27					  Padre::PPI::UpdateCopyright(3pm)
Man Page