TAP::PARSER::ITERATOR::STREAM(3pm)

💅 TAP::Parser::Iterator::Stream (3pm) ✨

okay so bestie, welcome to the Perl Programmers Reference Guide 💖 this little icon is TAP::Parser::Iterator::Stream, and she's the one who reads your TAP from filehandles, no cap 🎀

✨ VERSION ✨

Version 3.50 — yes she's on that version, slay 🔥

🌸 SYNOPSIS 🌸

use TAP::Parser::Iterator::Stream;
open( TEST, 'test.tap' );
my $it   = TAP::Parser::Iterator::Stream->new(\*TEST);
my $line = $it->next;

that's literally it — open the file, wrap the filehandle, call next, get a line 🦋 so simple, main character energy fr fr

💜 DESCRIPTION 💜

so this is a simple iterator wrapper for reading from filehandles, lowkey just a cute little shell around your filehandle, and it's used by TAP::Parser 👑

real talk though — unless you're out here writing a plugin or subclassing something, you probably won't need to use this module directly. like, it's giving "internal business" 🙈 no need to touch her

💅 METHODS 💅

🎀 Class Methods 🎀

• new — creates an iterator, obviously 💖 she expects exactly one argument containing a filehandle. one. just the filehandle. periodt.

⭐ Instance Methods ⭐

• next — iterates through it, of course ✨ like what else would she do
• next_raw — iterates raw input without applying any fixes for quirky input syntax 🌈 no fixing, no cleaning, raw as it comes, iykyk
• wait — gets the wait status for this iterator 💀 and it always returns zero. always. zero. no notes.
• exit — gets the exit status for this iterator 🫶 and guess what bestie, always returns zero too 🙈

🌸 ATTRIBUTION 🌸

originally ripped off from Test::Harness 😭 iconic behaviour honestly, we love a humble origin story 💜

🌈 SEE ALSO 🌈

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

---

okay that's the whole thing bestie, go forth and iterate 🧚💖

cute lil sign-off: this was perl v5.42.3, dated 2026-11-03, and that's the footer, slay 💅✨