padre::task::eval(3pm) [debian man page]

Padre::Task::Eval(3pm)					User Contributed Perl Documentation				    Padre::Task::Eval(3pm)

NAME

       Padre::Task::Eval - Task for executing arbitrary code via a string eval

SYNOPSIS

	 my $task = Padre::Task::Eval->new(
	     prepare => '1 + 1',
	     run     => 'my $foo = sub { 2 + 3 }; $foo->();',
	     finish  => '$_[0]->{prepare}',
	 );

	 $task->prepare;
	 $task->run;
	 $task->finish;

DESCRIPTION

       Padre::Task::Eval is a stub class used to implement testing and other miscellaneous functionality.

       It takes three named string parameters matching each of the three execution phases. When each phase of the task is run, the string will be
       eval'ed and the result will be stored in the same has key as the source string.

       If the key does not exist at all, nothing will be executed for that phase.

       Regardless of the execution result (or the non-execution of the phase) each phase will always return true. However, if the string eval
       throws an exception it will escape the task object (although when run properly inside of a task handle it should be caught by the handle).

METHODS

       This class contains now additional methods beyond the defaults provided by the Padre::Task API.

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 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::Task::Eval(3pm)

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

NAME

       Padre::Task::PPI - Generic PPI background processing task

SYNOPSIS

	 package Padre::Task::MyFancyTest;

	 use strict;
	 use base 'Padre::Task::PPI';

	 # Will be called after ppi-parsing:
	 sub process {
	     my $self	= shift;
	     my $ppi	= shift or return;
	     my $result = ...expensive_calculation_using_ppi...
	     $self->{result} = $result;
	     return;
	 }

	 1;

	 # elsewhere:

	 Padre::Task::MyFancyTest->new(
	     text => 'parse-this!',
	 )->schedule;

DESCRIPTION

       This is a base class for all tasks that need to do expensive calculations using PPI. The class will setup a PPI::Document object from a
       given piece of code and then call the "process_ppi" method on the task object and pass the PPI::Document as first argument.

       You can either let "Padre::Task::PPI" fetch the Perl code for parsing from the current document or specify it as the ""text"" parameter to
       the constructor.

       Note: If you don't supply the document text and there is no currently open document to fetch it from, "new()" will simply return the empty
       list instead of a "Padre::Task::PPI" object.

SEE ALSO

       This class inherits from "Padre::Task" and its instances can be scheduled using "Padre::TaskManager".

       The transfer of the objects to and from the worker threads is implemented with Storable.

AUTHOR

       Steffen Mueller "smueller@cpan.org"

COPYRIGHT AND 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.

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