Test2::Plugin(3pm)

📦
version 5.42.3 · 16 versions
, in alpine 3.24

💖 NAME: Test2::Plugin(3pm) 💖

Hey bestie! This is the manual page for Test2::Plugin, straight out of the Perl Programmers Reference Guide — and yes, the title is giving main character energy. 💅

Test2::Plugin - Documentation for plugins.

✨ DESCRIPTION ✨

Okay so, plugins are packages that cause behavior changes, or other side-effects, for the test file that loads them. That's their whole vibe. 🌸

🚨 Important vibe check: plugins should not export any functions, or provide any tools. They should be distinct units of functionality.

If you wish to combine behavior changes with tools then you should write a Plugin, a Tools module, and a bundle that loads them both. Slay, but keep those layers separate. 🎀

💬 FAQ 💬

Should I subclass Test2::Plugin?

No. Currently this class is empty. Eventually we may want to add behavior, in which case we do not want anyone to already be subclassing it. So yeah — don't do it, bestie. 🙈

🛠️ HOW DO I WRITE A PLUGIN? 🛠️

Writing a plugin is not as simple as writing a Test2::Bundle, or writing Test2::Tools. Plugins alter behavior, or cause desirable side-effects. To accomplish this you typically need a custom import() method that calls one or more functions provided by the Test2::API package. ✨

If you want to write a plugin you should look at existing plugins, as well as the Test2::API and Test2::Hub documentation. There is no formula for a Plugin, they are generally unique, however consistent rules are that they should not load other plugins, or export any functions. Periodt. 💅

🌈 SOURCE 🌈

The source code repository for Test2-Suite can be found at https://github.com/Test-More/test-more/.

👑 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 💖 Manual footer says perl v5.42.3, dated 2026-11-03 — bye from Test2::Plugin(3pm) 🫶

📦 where this page comes from