Test::Run(3pm)

💖 NAME 💖

Test::Run — it's giving a new and improved test harness for TAP scripts, and honestly? bestie, it ate. 🍓

This page lives in the User Contributed Perl Documentation section as Test::Run(3pm), so you already know it's the people's harness. 💅

---

✨ SYNPOSIS ✨

okay so here's the whole vibe, copy-paste ready:

cpanp -i Task::Test::Run::AllPlugins
export HARNESS_PLUGINS="ColorSummary ColorFileVerdicts"
runprove t/*.t

install the plugin bundle, tell your harness which plugins you want via HARNESS_PLUGINS, then runprove your test files. iconic. 🎀

---

🌸 ABOUT 🌸

Test::Run is an improved test harness, originally based on Test::Harness version 2.xx by Michael G. Schwern, Andy Lester and others. shoutout to the OGs fr fr 🫶

lowkey important thing though: the top-level Test::Run by itself does not do much. it's the main character who refuses to carry the plot. 😭 if you want actual detailed instructions, you should refer to Task::Test::Run::AllPlugins. that's your girl. she has the lore.

the rest of this page is just some information and links about Test::Run, so think of it as the little vibe-check section at the end. ✨

---

🔗 LINKS 🔗

• http://testanything.org/wiki/index.php/Test::Run — Test::Run on the Test Anything Protocol wiki.
• http://testanything.org/wiki/index.php/TAP_Consumers — other TAP consumers. go meet the extended universe. 🌈
• Test::Tutorial — learn how to write Perl tests. bestie this is literally the "how to slay" tutorial, go read it. 📚

---

👑 ACKNOWLEDGEMENTS 👑

the (possibly ad-hoc) regex for matching the optional digits+symbols parameters' prefix of the sprintf conversion was originally written by Bart Lateur (BARTL on CPAN) for his String::Sprintf module. not me stanning a regex author but here we are 💖

---

📜 COPYRIGHT & LICENSE 📜

Copyright 2006 Shlomi Fish, all rights reserved.

This program is released under the following license: MIT X11.

---

ok and that's the whole page, no cap. every flag, every path, every credit — all present and accounted for. 🦋

signing off with the receipts: this is Test::Run(3pm), documented as part of perl v5.42.0, dated 2025-07-25. mwah. 💅💖