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-2013 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.