TAP::P...rocess(3perl)

💖 NAME 💖

TAP::Parser::Iterator::Process — the iterator for process-based TAP sources, bestie 🫶

Yes it's a long name. Yes it's worth it. Come with me.

---

✨ VERSION ✨

Version 3.52 👑

---

🌸 SYNOPSIS 🌸

okay so picture this — you just want a tiny iterator wrapped around a whole entire external process:

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;

that's it. that's the whole vibe. 💅

---

🦋 DESCRIPTION 🦋

So this module is a simple iterator wrapper for executing external processes — and it's used by TAP::Parser. That's its whole job, and it does it gorgeously. 💖

Real talk though: unless you're writing a plugin or subclassing something, you probably won't need to use this module directly. It's giving backstage crew energy. Iconic, essential, not on stage. 😌

---

🎀 METHODS 🎀

🌈 Class Methods

• new — creates an iterator. It expects one argument containing a hashref, shaped exactly like this:

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

It tries to use IPC::Open3 & IO::Select to talk to the spawned process if they are available. And if they're not? No stress, it falls back onto open(). Adaptable queen. 🧚

💜 Instance Methods

• next — iterates through the process output, of course. It's literally the job description. next. ⭐
• next_raw — iterates raw input without applying any fixes for quirky input syntax. no glow-ups, no edits, just raw. 💀
• wait — gets the wait status for this iterator's process. sit tight bestie ⏳
• exit — gets the exit status for this iterator's process. how did it go?? 👀
• handle_unicode — upgrades the input stream to handle UTF8 ✨ because unicode deserves rights
• get_select_handles — returns a list of filehandles that may be used upstream in a select() call to signal that this Iterator is ready. And — important — iterators that are not handle based should return an empty list. no handles, no list, no drama. 🙈

---

🌟 ATTRIBUTION 🌟

Originally ripped off from Test::Harness. (respectfully. with love. 🫶)

---

👑 SEE ALSO 👑

• TAP::Object
• TAP::Parser
• TAP::Parser::Iterator

---

k that's the whole page, you ate that ngl 🍓 this was perl v5.44.0, dated 2026-10-17, from the Perl Programmers Reference Guide — TAP::P...rocess(3perl), signing off, mwah 💋