CONTENTS

• NAME
• VERSION
• SYNOPSIS
• DESCRIPTION
• METHODS
  • Class Methods
    • new
  • Instance Methods
    • next
    • next_raw
    • wait
    • exit
    • handle_unicode
    • get_select_handles
• ATTRIBUTION
• SEE ALSO

#NAME

TAP::Parser::Iterator::Process - Iterator for process-based TAP sources

#VERSION

Version 3.30

#SYNOPSIS

use TAP::Parser::Iterator::Process;
my %args = (
 command  => ['python', 'setup.py', 'test'],
 merge    => 1,
 setup    => sub { ... },
 teardown => sub { ... },
);
my $it   = TAP::Parser::Iterator::Process->new(\%args);
my $line = $it->next;

#DESCRIPTION

This is a simple iterator wrapper for executing external processes, used by TAP::Parser. Unless you're writing a plugin or subclassing, you probably won't need to use this module directly.

#METHODS

#Class Methods

#new

Create an iterator. Expects one argument containing a hashref of the form:

command  => \@command_to_execute
merge    => $attempt_merge_stderr_and_stdout?
setup    => $callback_to_setup_command
teardown => $callback_to_teardown_command

Tries to uses IPC::Open3 & IO::Select to communicate with the spawned process if they are available. Falls back onto open().

#Instance Methods

#next

Iterate through the process output, of course.

#next_raw

Iterate raw input without applying any fixes for quirky input syntax.

#wait

Get the wait status for this iterator's process.

#exit

Get the exit status for this iterator's process.

#handle_unicode

Upgrade the input stream to handle UTF8.

#get_select_handles

Return a list of filehandles that may be used upstream in a select() call to signal that this Iterator is ready. Iterators that are not handle based should return an empty list.

#ATTRIBUTION

Originally ripped off from Test::Harness.

#SEE ALSO

TAP::Object, TAP::Parser, TAP::Parser::Iterator,

Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via the GitHub issue tracker or email regarding any issues with the site itself, search, or rendering of documentation.

The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the Perl issue tracker, the mailing list, or IRC to report any issues with the contents or format of the documentation.