NAME

 Proc::Parallel - run multiple commands and process their output in parallel

SYNOPSIS

 use Proc::Parallel;

 startcommand($command, $per_line_callback, $at_eof_callback);

 finish_commands();

DESCRIPTION

This module is a wrapper around an asynchronous IO library. It provides an easy interface for starting a bunch of commands and processing each line of output from those commands.

It uses IO::Event::Callback.

When the last of the commands finish, Event::unloop_all() is called so this module is not safe to use with other Event-based code.

The commands are started as you call startcommand(), but no output will be processed unless you call IO::Event::loop() or let finish_commands() call it for you. The call to finish_commands() or IO::Event::loop() returns when all the commands have completed. Additional commands may be started after calling finish_commands().

In addition to the command to run, the startcommand() function takes two IO::Event-style callbacks: one that's called for each line of output and one that's called when at end-of-file.

EXAMPLE

 startcommand($command, sub { 
        my ($handler, $ioe, $input_buffer_reference) = @_;
        while (<$ioe>) {
                # do suff for each line
        }
 });

 finish_commands();

LICENSE

This package may be used and redistributed under the terms of either the Artistic 2.0 or LGPL 2.1 license.