Test::...sertion(3pm)

✨ NAME ✨

Test::Unit::Assertion — the abstract base class for assertions 💅

---

🌸 NAME (yes bestie, again — it's giving sequel energy) 🌸

Okay so, real talk: any assertion class that's tryna plug into Test::Unit::Assert needs to implement this interface. That's the whole vibe. No cap. 🦋

🎀 Required methods 🎀

• new — makes you a fresh new assertion object, brand spanking new ✨. Takes whatever arguments you desire, like literally whatever you want, it's your world. Ngl it isn't strictly necessary for the framework to work with this class, but it's generally considered a good idea. Main character choice fr fr. 👑
• do_assertion — bestie. THIS is the important one. The one that actually matters. The moment. 💖 If Test::Unit::Assert::assert gets called with an object as its first argument, then it does this iconic little move:

$_[0]->do_assertion(@_[1 .. $#_]) ||
    $self->fail("Assertion failed");

So what that means for you is: do_assertion should return true when the assertion succeeds, and false when it doesn't. 😭 OR, alternatively, you can fail by throwing a Test::Unit::Failure object — that bad boy gets caught further up the stack and used to produce a sensible error report 🫶.

Generally it's good practice for do_assertion to die with a meaningful error on assertion failure rather than just returning false. Like, be dramatic, but be informative about it, yk? 💀

---

🌈 AUTHOR 🌈

Copyright (c) 2001 Piers Cawley <pdcawley@iterative-software.com>.

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

---

⭐ SEE ALSO ⭐

• Test::Unit::Assert
• Test::Unit::CodeRef
• Test::Unit::Regexp

---

And that's the whole page, bestie!! 🥳 This lil gem is from perl v5.40.1 and it was dated 2026-04-05, in the User Contributed Perl Documentation era, mwah 💋✨