Test2::Bundle(3perl)

💖 Test2::Bundle — the tea on bundles 💖

ok so this is a page from the Perl Programmers Reference Guide, and we're talking about Test2::Bundle, bestie. sit down, grab a strawberry 🍓, it's gonna be cute and it's gonna be thorough.

---

✨ NAME ✨

Test2::Bundle — the docs for bundles, periodt.

---

🦋 DESCRIPTION 🦋

okay so picture this: a bundle is literally just a collection of Tools and Plugins. that's it. that's the whole job. 👑

and here's the rule, no cap — bundles should not provide any tools or behaviors of their own. like, zero original content, bestie. they should simply combine the tools and the behaviors of other packages. it's giving group project where everyone else did the work and the bundle just put its name on it 💅.

---

🌸 FAQ 🌸

Should my bundle subclass Test2::Bundle?

no. 🙅♀️

currently this class is empty. like, fully empty. eventually they might want to add behavior, and in that case they do not want anyone to already be subclassing it. so don't. iykyk. 🎀

---

🔥 HOW DO I WRITE A BUNDLE? 🔥

bestie writing a bundle can be so simple. watch this:

package Test2::Bundle::MyBundle;
use strict;
use warnings;

use Test2::Plugin::ExitSummary; # Load a plugin

use Test2::Tools::Basic qw/ok plan done_testing/;

# Re-export the tools
our @EXPORTS = qw/ok plan done_testing/;
use base 'Exporter';

1;

that's it. that's the bundle. it loaded a plugin with use Test2::Plugin::ExitSummary;, it pulled in tools from Test2::Tools::Basic with qw/ok plan done_testing/, and then it re-exported them with our @EXPORTS = qw/ok plan done_testing/; plus use base 'Exporter';. slay. 💖

now — if you wanna do anything more complex than that, you should look into Import::Into and Symbol::Move. those are your big-girl tools, go off. 🧚

---

🔗 SOURCE 🔗

the source code repository for Test2-Suite lives at https://github.com/Test-More/test-more/. go lurk, it's iconic.

---

👑 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/

---

ok that's the whole page, you ate it, you understood it, you're basically a bundle expert now 🫶

sign-off time: this was perl v5.44.0, dated 2026-10-17, and it's the Test2::Bundle(3perl) page from the Perl Programmers Reference Guide. mwah. 💋✨