Test::...Runner(3pm)

💅 Test::...Runner(3pm) — like, the vibe

okay bestie, welcome to the manual page for Test::...Runner(3pm) — that's a section 3pm perl thing, "User Contributed Perl Documentation" energy, and it's genuinely important even tho it's kinda shy ✨

---

🌸 NAME 🌸

Test::Unit::Runner — the abstract base class for test runners. yes, abstract, it's giving "I'm the blueprint, not the build" 👑

---

✨ SYNOPSIS ✨

my $runner = Test::Unit::TestRunner->new();
$runner->filter(@filter_tokens);
$runner->start(...);

---

🦋 DESCRIPTION 🦋

so like, this class is the parent class of every single test runner. all of them. it's the mother of the group chat 💖

which means bestie, do not use it directly. it's not for that. it's a base class — it exists so all the other runner classes can inherit the same stuff. what kind of stuff? functionality such as state — think run-time options and that whole situation — all shared, all available to every runner class in the family. periodt.

---

🎀 suites_running() 🎀

returns an array stack of the current suites running. here's the mechanics, and it's lowkey elegant:

• when a new suite is started, it gets pushed onto the stack 📥
• when it's done, it gets popped off 📤

so the first element in the returned array is the top-level suite, and the last one is the innermost suite. outermost → innermost, top to bottom, that's the whole story. iykyk 💅

---

🧚 filter([ @tokens ]) 🧚

sets the runner's filter tokens to the given list. @tokens, that's it. that's the whole thing. slay.

---

🍓 reset_filter() 🍓

clears the current filter. boom, gone, fresh start ✨

---

👑 AUTHOR 👑

Copyright (c) 2000-2002, 2005 the PerlUnit Development Team (see Test::Unit or the AUTHORS file included in this distribution).

All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

^^ that's the legal bit, fr fr, and we respect it 💜

---

🌈 SEE ALSO 🌈

• Test::Unit::HarnessUnit
• Test::Unit::TestRunner
• Test::Unit::TkTestRunner

go read those next, bestie, they're the actual usable ones 🫶

---

and that's the whole page !! this one came out of perl v5.40.1, dated 2026-04-05 — catch u in the next manpage, mwah 💖💅✨