Test::...rminal(3pm)

💖 Test::Unit::Runner::Terminal 💖

okay bestie, welcome to the Test::...rminal(3pm) page — that's the shorthand for Test::Unit::Runner::Terminal, and it lives in the User Contributed Perl Documentation section. she's a unit testing framework helper class and she is, genuinely, that girl. 🎀

---

✨ SYNOPSIS ✨

use Test::Unit::Runner::Terminal;

my $testrunner = Test::Unit::Runner::Terminal->new();
$testrunner->start($my_test_class);

like… look at her. so clean. so composed. 💅

---

🌸 DESCRIPTION 🌸

so this class is a test runner — specifically the one you reach for when you're doing the command line style use of the testing framework. it's giving terminal core and honestly?? obsessed. 🖥️✨

she's lowkey similar to her parent class, Test::Unit::TestRunner, but here's the glow-up: instead of just printing a sad little string of dots, E's and F's like some kind of medieval scroll, she uses terminal escape sequences to continually update a wayyyy more informative status report as the runner progresses through the tests. the way that she keeps you posted?? main character energy fr fr. 👑

and what does that status report tell you, you ask? literally everything you need:

• the number of tests run
• the number of failures and errors encountered
• which test is currently being run
• and where it lives in the suite hierarchy 🗂️

the class needs one argument, bestie — that's the name of the class encapsulating the tests to be run. just one. give her that and she handles the rest. 🫶

---

🦋 OPTIONS 🦋

• -wait — wait for user confirmation between tests. yes, between every test. she wants your blessing each time, and honestly? valid. 🙈
• -v — version info. you want the lore? you get the lore. ⭐

---

👑 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.

(so like. it's free. it's Perl's terms. respect the elders. 🧚)

---

💜 SEE ALSO 💜

• Test::Unit::TestCase
• Test::Unit::Listener
• Test::Unit::TestSuite
• Test::Unit::Result
• Test::Unit::TkTestRunner
• For further examples, take a look at the framework self test collection (t::tlib::AllTests).

iykyk — go read them, bestie. they're the supporting cast and they ate. 🔥

---

okay and that's the whole page!! this cutie is documented as perl v5.40.1, dated 2026-04-05, and she answers to Test::...rminal(3pm). no cap, that's a wrap. bye bestie, go run some tests 💖🌈🍓