Test2::...Tooling(3)

💖 Test2::Manual::Tooling 💖

Okay so this is the Test2::...Tooling(3) page from User Contributed Perl Documentation — aka Test2::Manual::Tooling, the manual page for tool authors. Welcome to the group chat where we learn to build Test2 tools, plugins, and other components. No cap, this index is your map. 🗺️✨

---

🎀 NAME 🎀

Test2::Manual::Tooling — manual page for tool authors. That’s it, that’s the name, and it ate. 💅

🌸 DESCRIPTION 🌸

This section covers writing new tools, plugins, and other Test2 components. Basically: if you wanna make tooling that slaps, start here. 🛠️🦋

🌈 TOOL TUTORIALS 🌈

🧰 FIRST TOOL

• Test2::Manual::Tooling::FirstTool — intro to writing tools by cloning ok(). Iconic starter energy. 👑

🚚 MOVING FROM Test::Builder

• Test2::Manual::Tooling::TestBuilder — this section maps Test::Builder methods to Test2 concepts. If you’re moving over, this is your translator bestie. 🔁

🪆 NESTING TOOLS

• Test2::Manual::Tooling::Nesting — how to call other tools from your tool. Tool-ception, but make it valid. 🌀

🧪 TOOLS WITH SUBTESTS

• Test2::Manual::Tooling::Subtest — how to write tools that make use of subtests. Subtest girlies, this one’s for you. 🫶

✅ TESTING YOUR TEST TOOLS

• Test2::Manual::Tooling::Testing — how to write tests for your test tools. Test-ception, lowkey essential. 🧪💖

🎉 PLUGIN TUTORIALS 🎉

🚀 TAKING ACTION WHEN A NEW TOOL STARTS

• Test2::Manual::Tooling::Plugin::ToolStarts — how to add behaviors that occur when a tool starts work. Main character entrance vibes. ✨

🏁 TAKING ACTION AFTER A TOOL IS DONE

• Test2::Manual::Tooling::Plugin::ToolCompletes — how to add behaviors that occur when a tool completes work. The finish-line slay. 🎀

🔚 TAKING ACTION AT THE END OF TESTING

• Test2::Manual::Tooling::Plugin::TestingDone — how to add behaviors that occur when testing is complete (IE done_testing, or end of test). End-of-test era. 🌅

🚪 TAKING ACTION JUST BEFORE EXIT

• Test2::Manual::Tooling::Plugin::TestExit — how to safely add pre-exit behaviors. Pre-exit, but make it safe. 🛟

✍️ WRITING A SIMPLE JSONL FORMATTER ✍️

• Test2::Manual::Tooling::Formatter — how to write a custom formatter, in our case a JSONL formatter. Custom formatter era, and ours is JSONL. 🧾✨

🔎 WHERE TO FIND HOOKS AND APIS 🔎

🌍 global API

Test2::API is the global API. This is primarily used by plugins that provide global behavior. Think of it as the big-picture group chat. 📣

🧩 In hubs

Test2::Hub is the base class for all hubs. This is where hooks for manipulating events, or running things at the end of testing live. Hooks live here, bestie. 🪝💜

👀 SEE ALSO 👀

• Test2::Manual — primary index of the manual. Start here if you’re lost. 🗂️

📦 SOURCE 📦

The source code repository for Test2-Manual can be found at https://github.com/Test-More/test-more/. Go snoop, but respectfully. 🔍

🫶 MAINTAINERS 🫶

• Chad Granum <exodist@cpan.org>

✨ AUTHORS ✨

• Chad Granum <exodist@cpan.org>

📜 COPYRIGHT 📜

Copyright Chad Granum <exodist@cpan.org>.

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 cutie was rendered by perl v5.42.0 on 2025-07-28, and the page itself is Test2::...Tooling(3). Periodt. 💅✨🎀