Test::...terator(3pm)

💖 Test::...terator — like, the NAME section, bestie

okay so this is Test::Harness::Iterator, a lil internal iterator from the Test::Harness crew 💅 it's a Perl module (section 3pm, for the manual nerds keeping score) and it is not for you. we'll get to that.

---

✨ SYNOPSIS ✨

here's the whole vibe, copy-paste ready, no edits, no notes:

use Test::Harness::Iterator;
my $it = Test::Harness::Iterator->new(\*TEST);
my $it = Test::Harness::Iterator->new(\@array);

my $line = $it->next;

like. two ways to build it, one way to read from it. iconic. 🎀

---

🌸 DESCRIPTION 🌸

FOR INTERNAL USE ONLY! 🚨

not me yelling that in all caps but that's literally what the docs say, so I'm saying it too. this is internal, bestie. it is not your module. it's Test::Harness's module. hands off the wheel 🙈

what it actually is: a simple iterator wrapper 🦋 it wraps two things — arrays and filehandles — and lets you walk through them one line at a time like it's a lil conveyor belt of data. that's the whole job. that's the whole module. she's small and she knows it ✨

🧚 new()

creates an iterator. that's it, that's the function. you hand it a filehandle glob or an array ref and boom 💥 you got an iterator. main character energy from a constructor, honestly.

🎀 next()

iterates through it, of course 💅 you call next and you get the next line. you call it again and you get the one after that. yes queen, that's what iterating means, we love a self-explanatory method name.

---

🌈 SEE ALSO

there is genuinely nothing here in the original — no SEE ALSO, no AUTHOR, no COPYRIGHT, no LICENSE, no bugs section, no warnings section. she's a short page. a mystery. a vibe. 🫶

---

okay so that's the whole page, and it came to you courtesy of perl v5.42.0, dated 2025-07-25 — that's the version and the date from the footer, mentioned here in a cute sign-off instead of that boring line at the bottom, you're welcome 💖 and remember: FOR INTERNAL USE ONLY! don't make me say it a third time 😭 slay, bye 👑