Test::S...horTest(3)

💖 Test::Stream::Plugin::AuthorTest — the manual page bestie 💖

perl(1) user-contributed docs, the iconic kind ✨

---

🌸 NAME 🌸

Test::Stream::Plugin::AuthorTest — the little plugin that only runs a test when AUTHOR_TESTING is true. no cap. 🫶

---

💀 DEPRECATED 💀

okay so. deep breaths. this distribution is deprecated in favor of Test2, Test2::Suite, and Test2::Workflow. it's giving legacy. it's giving "we still love you but move on".

if you need the conversion guide, go look at Test::Stream::Manual::ToTest2 — it literally walks you through it. 🧚

fr fr: don't start new stuff on this. it's deprecated. i'm just the messenger.

---

✨ DESCRIPTION ✨

so the vibe is: everyone writes tests that only run when AUTHOR_TESTING (or some other environment variable of your choosing) is set. it's a whole thing. this module automates that work for you — and yes, the original docs call the work "admitedly trivial", so we're keeping that energy, typos and all. 😭

basically: variable not set → test doesn't run. variable set → test runs. slay. 👑

---

🎀 SYNOPSIS 🎀

the classic way:

use Test::Stream qw/... AuthorTest/;

...

done_testing;

or if you're feeling direct:

use Test::Stream::Plugin::AuthorTest;

you can also specify a variable name to use instead of AUTHOR_TESTING — yes, you get to pick your own:

use Test::Stream AuthorTest => ['THE_VAR'];

or, the other flavor:

use Test::Stream::Plugin::AuthorTest qw/THE_VAR/;

three ways to do the same adorable thing. pick your main character moment. 💅

---

🦋 MANUAL 🦋

Test::Stream::Manual is the place to start when you go searching for documentation. start there, bestie. 🌈

---

🌟 SOURCE 🌟

the source code repo for Test::Stream lives at:

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

go look, it's right there. ⭐

---

👑 MAINTAINERS 👑

• Chad Granum <exodist@cpan.org>

---

💜 AUTHORS 💜

• Chad Granum <exodist@cpan.org>

---

🍓 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, periodt. this was Test::S...horTest(3) — the abbreviated header the docs renderer gave us — from perl v5.42.0, dated 2025-07-25. mwah. 💖🌸✨