Test2:...ooling(3perl)

📦
version 5.44.0 · 8 versions
, in arch rolling

💅 NAME 💅

Test2::Manual::Tooling — the manual page for all my fellow tool authors out there, the 3perl girlies who wanna build stuff ✨

🎀 DESCRIPTION 🎀

okay so bestie, this whole section is about writing new tools, plugins, and basically any other Test2 component your little heart desires. it's giving "build your own adventure" fr fr. 💖

🛠️ TOOL TUTORIALS 🛠️

🌱 FIRST TOOL 🌱

Test2::Manual::Tooling::FirstTool — an intro to writing tools, and the move here is literally just cloning ok(). lowkey iconic of it.

🚚 MOVING FROM Test::Builder 🚚

Test2::Manual::Tooling::TestBuilder — this section maps all your Test::Builder methods over to Test2 concepts, so you can pack your bags and relocate with zero drama. no cap.

🪆 NESTING TOOLS 🪆

Test2::Manual::Tooling::Nesting — how to call other tools from inside your own tool. tools within tools, it's giving inception 🌀

🧩 TOOLS WITH SUBTESTS 🧩

Test2::Manual::Tooling::Subtest — how to write tools that make use of subtests. yes bestie, you can have a whole subtest situation up in here.

🧪 TESTING YOUR TEST TOOLS 🧪

Test2::Manual::Tooling::Testing — you wrote a test tool, so… who tests the test tool? spoiler: this page. write tests for your tests, periodt. 💀

🔌 PLUGIN TUTORIALS 🔌

⚡ TAKING ACTION WHEN A NEW TOOL STARTS ⚡

Test2::Manual::Tooling::Plugin::ToolStarts — how to add behaviors that fire off when a tool starts doing its thing. the vibe check happens right at the beginning, yk?

✅ TAKING ACTION AFTER A TOOL IS DONE ✅

Test2::Manual::Tooling::Plugin::ToolCompletes — how to add behaviors that happen when a tool completes its work. it ate and now we celebrate 🎉

🏁 TAKING ACTION AT THE END OF TESTING 🏁

Test2::Manual::Tooling::Plugin::TestingDone — how to add behaviors that go off when testing is complete (that's IE done_testing, or just the end of the test).

🚪 TAKING ACTION JUST BEFORE EXIT 🚪

Test2::Manual::Tooling::Plugin::TestExit — how to safely add pre-exit behaviors. note the word safely, bestie, don't get feral in there 🙈

🌈 WRITING A SIMPLE JSONL FORMATTER 🌈

Test2::Manual::Tooling::Formatter — how to write your very own custom formatter, and in our case specifically a JSONL formatter. main character energy truly. ✨

🔍 WHERE TO FIND HOOKS AND APIS 🔍

🌍 global API 🌍

Test2::API is the global API. this one is primarily used by plugins that provide global behavior. think of it as the group chat everyone's in 💬

🧠 In hubs 🧠

Test2::Hub is the base class for all hubs. this is where the hooks for manipulating events live, and also where things that run at the end of testing live too. so many hooks, so little time. 🪝

👀 SEE ALSO 👀

  • Test2::Manual — the primary index of the manual. start here if you're lost, queen, it's the map 🗺️

📦 SOURCE 📦

the source code repository for Test2-Manual lives at https://github.com/Test-More/test-more/. go give it a star, it deserves it 🫶

💌 MAINTAINERS 💌

  • Chad Granum <exodist@cpan.org>

👑 AUTHORS 👑

  • Chad Granum <exodist@cpan.org>

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/

okay that's the whole page bestie, you're officially a Test2 tool author now, go slay 🦋 and just so you know the vibes came from perl v5.44.0, dated 2026-10-17, straight out of Test2:...ooling(3perl) — mwah, love u, bye 💖

📦 where this page comes from