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

💖 TAP::Parser::Iterator::Stream — the manual page, but make it cute ✨

okay so bestie, welcome to TAP::Parser::Iterator::Stream, straight out of the Perl Programmers Reference Guide. this is the whole vibe, let's go 🦋

---

🌸 NAME 🌸

TAP::Parser::Iterator::Stream — the iterator for filehandle-based TAP sources. that's it, that's the whole job description, and she does it flawlessly 💅

---

✨ VERSION ✨

Version 3.52 — iconic behavior, no notes 👑

---

🎀 SYNOPSIS 🎀

okay so here's how you actually use her:

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

like... look at that. clean. simple. she ate and left no crumbs 🍓

---

💜 DESCRIPTION 💜

so this is a simple iterator wrapper — she reads from filehandles, that's the whole thing — and she's used by TAP::Parser. lowkey she's the backstage crew making the whole show work 🌈

real talk tho: unless you're writing a plugin or subclassing, you probably won't need to use this module directly. she's not gatekeeping, she's just built different and she's built for the parser’s inner circle 🫶

---

🧚 METHODS 🧚

🌟 Class Methods 🌟

• new — creates an iterator, duh 💖 she expects one argument, and that argument is a filehandle. give her the handle and she'll handle it.

🌸 Instance Methods 🌸

• next — iterates through it. of course. what did you think she was gonna do 😭 that's literally her whole thing.
• next_raw — iterates the raw input without applying any fixes for quirky input syntax. raw. unfiltered. no edits, no filter, no touch-ups — just the input exactly as it is, bestie 🦋
• wait — gets the wait status for this iterator. always returns zero. every single time. zero. she is nothing if not consistent 💀
• exit — gets the exit status for this iterator. always returns zero. again: zero. she's not dramatic, she's just always zero. periodt ✨

---

💅 ATTRIBUTION 💅

originally ripped off from Test::Harness. yes, ripped off — those are the original's words, not mine, and honestly? iconique. she's standing on the shoulders of giants and she knows it 💜

---

👑 SEE ALSO 👑

go check her friends, they're all in the group chat:

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

---

🧠 friendly reminder bestie: every option, method, argument and value up there is exactly as the original says it. no extras, no guessing, no "well I think she probably does X". i would never do you like that 💖

made with love, zero fixing, all facts 🎀

this was written against perl v5.44.0, dated 2026-10-17, and the manual name is TAP::P...:Stream(3perl) — so like, if you're citing her in an essay, that's the receipt 🫶✨