NAME

Text::APL::Reader - reader

DESCRIPTION

Reads a template from various sources. Accepts a subroutine for a custom implementation.

Returns a reference to subroutine. When called accepts another reference to subroutine that is called upon receiving a chunk of the template.

For example a reader from a scalar reference is implemented as:

            

              
              
$reader = sub {
    my ($cb) = @_;
    $cb->(${$input_string});
    $cb->();
};
            
          

The first call on cb notifies Text::APL about the template chunk and second without arguments notifies Text::APL about EOF.

The following sources are implemented:

            

              
              
$reader->(\$scalar);
$reader->($filename);
$reader->($filehandle);
$reader->(sub {...custom code...});
            
          

Custom subroutines are used for non-blocking template reading. See examples/ directory for an example using IO::AIO for non-blocking template reading.

METHODS

build

Build a reader.