1TAP::Parser::Iterator::UPsreorceCsosn(t3r)ibuted Perl DoTcAuPm:e:nPtaartsieorn::Iterator::Process(3)
2
3
4

NAME

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

VERSION

9       Version 3.43
10

SYNOPSIS

12         use TAP::Parser::Iterator::Process;
13         my %args = (
14          command  => ['python', 'setup.py', 'test'],
15          merge    => 1,
16          setup    => sub { ... },
17          teardown => sub { ... },
18         );
19         my $it   = TAP::Parser::Iterator::Process->new(\%args);
20         my $line = $it->next;
21

DESCRIPTION

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

METHODS

28   Class Methods
29       "new"
30
31       Create an iterator.  Expects one argument containing a hashref of the
32       form:
33
34          command  => \@command_to_execute
35          merge    => $attempt_merge_stderr_and_stdout?
36          setup    => $callback_to_setup_command
37          teardown => $callback_to_teardown_command
38
39       Tries to uses IPC::Open3 & IO::Select to communicate with the spawned
40       process if they are available.  Falls back onto "open()".
41
42   Instance Methods
43       "next"
44
45       Iterate through the process output, of course.
46
47       "next_raw"
48
49       Iterate raw input without applying any fixes for quirky input syntax.
50
51       "wait"
52
53       Get the wait status for this iterator's process.
54
55       "exit"
56
57       Get the exit status for this iterator's process.
58
59       "handle_unicode"
60
61       Upgrade the input stream to handle UTF8.
62
63       "get_select_handles"
64
65       Return a list of filehandles that may be used upstream in a select()
66       call to signal that this Iterator is ready. Iterators that are not
67       handle based should return an empty list.
68

ATTRIBUTION

70       Originally ripped off from Test::Harness.
71

SEE ALSO

73       TAP::Object, TAP::Parser, TAP::Parser::Iterator,
74
75
76
77perl v5.34.0                      2021-07-23 TAP::Parser::Iterator::Process(3)
Impressum