TAP::Parser::Iterator::Process(3p) Perl Programmers Reference Guide #

TAP::Parser::Iterator::Process(3p) Perl Programmers Reference Guide

NNAAMMEE #

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

VVEERRSSIIOONN #

 Version 3.44

SSYYNNOOPPSSIISS #

   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;

DDEESSCCRRIIPPTTIIOONN #

 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.

MMEETTHHOODDSS #

CCllaassss MMeetthhooddss _"_n_e_w_"

 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()".

IInnssttaannccee MMeetthhooddss _"_n_e_x_t_"

 Iterate through the process output, of course.

 _"_n_e_x_t___r_a_w_"

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

 _"_w_a_i_t_"

 Get the wait status for this iterator's process.

 _"_e_x_i_t_"

 Get the exit status for this iterator's process.

 _"_h_a_n_d_l_e___u_n_i_c_o_d_e_"

 Upgrade the input stream to handle UTF8.

 _"_g_e_t___s_e_l_e_c_t___h_a_n_d_l_e_s_"

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

AATTTTRRIIBBUUTTIIOONN #

 Originally ripped off from Test::Harness.

SSEEEE AALLSSOO #

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

perl v5.36.3 2023-02-15 TAP::Parser::Iterator::Process(3p)