Test::S...lOnFail(3)

💖 Test::Stream::Plugin::BailOnFail — the "we're DONE here" plugin 💖

okay bestie so real quick, this is from the User Contributed Perl Documentation section of your man pages, and the page title is literally Test::S...lOnFail(3) (yes the terminal chopped the middle out, it's giving "name too long for the header, not my problem"). Anyways. Sit down, hydrate, let's talk about the plugin that bails out of your whole test suite the second one thing fails 🫶

---

🚨 DEPRECATED 🚨

ngl this one hurts. This distribution is deprecated in favor of Test2, Test2::Suite, and Test2::Workflow.

If you're migrating, go read Test::Stream::Manual::ToTest2 — it's literally a conversion guide, they did the work for you 💅

---

🧪 EXPERIMENTAL CODE WARNING 🧪

"This module is still EXPERIMENTAL"

So here's the tea: Test-Stream is now stable, but this particular module is still out here being experimental. You are absolutely still free to use it — nobody's stopping you — but you have been warned that it may change in backwords incompatible ways. (That typo is in the original, I am not fixing it, it's canon now 😭)

That message will get removed from this module's POD once it's considered stable. Until then: it vibes here. 🙈

---

✨ DESCRIPTION ✨

So what does it DO. This module will issue a bailout event after the first test failure. That's it, that's the whole personality. This will prevent your tests from continuing, which honestly? Sometimes you need that. Sometimes you need the tests to stop before they embarrass themselves.

Here's the detail that matters, bestie: the bailout runs when the context is released — meaning it runs when the test function you're using, like ok(), returns. Why does that matter? Because it gives the tools the ability to output any extra diagnostics they may need. So the diagnostics get their moment before the curtain drops. iconic behaviour honestly 👑

---

🎀 SYNOPSIS 🎀

use Test::Stream qw/Core BailOnFail/;

ok(1, "pass");
ok(0, "fail");
ok(1, "Will not run");

see that third one? "Will not run". It's not a threat, it's a promise. the first ok(0, ...) said "we're done" and the plugin said "say less" 💀

---

🔗 SOURCE 🔗

The source code repository for Test::Stream can be found at:

http://github.com/Test-More/Test-Stream/

go star it, go read it, go be nosy, it's your right 🦋

---

👑 MAINTAINERS 👑

• Chad Granum <exodist@cpan.org>

---

🌸 AUTHORS 🌸

• Chad Granum <exodist@cpan.org>

(yes it's the same name in both sections, no I will not be commenting further, that's just how the manpage is built 💅)

---

📜 COPYRIGHT 📜

Copyright 2015 Chad Granum <exodist7@gmail.com>.

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

See:

http://dev.perl.org/licenses/

---

and that's the whole page, bestie!! this was Test::S...lOnFail(3) from the perl v5.42.0 era, dated 2025-07-25 — shoutout to the version and the date for showing up, and shoutout to YOU for reading a deprecated module's docs all the way to the bottom. main character energy fr fr 🌈✨💖