Test2::...:Module(3)

okay so welcome to the User Contributed Perl Documentation page for Test2::Require::Module(3) — the header files it under the extra-truncated Test2::...:Module(3) label, but bestie, the actual module is Test2::Require::Module. We’re skipping tests when packages aren’t installed or versions are too low, and we’re doing it with main character energy. 💅✨

🌸 NAME 🌸

Test2::Require::Module — skip tests if certain packages are not installed, or insufficient versions. 🦋

🎀 DESCRIPTION 🎀

Sometimes you have tests that are nice to run, but depend on tools that may not be available. Instead of adding the tool as a dep, or making the test always skip, it is common to make the test run conditionally. This package helps make that possible. 💖

This module is modeled after Test::Requires. The difference is that this module is based on Test2 directly, and does not go through Test::Builder. Another difference is that the packages you check for are not imported into your namespace for you. This is intentional. Periodt. 💀

✨ SYNOPSIS ✨

here’s the whole vibe, bestie:

# The test will be skipped unless Some::Module is installed, any version.
use Test2::Require::Module 'Some::Module';

# The test will be skipped unless 'Other::Module' is installed and at
# version '5.555' or greater.
use Test2::Require::Module 'Other::Module' => '5.555';

# We now need to use them directly, Test2::Require::Module does not import
# them for us.
use Some::Module;
use Other::Module;

🌈 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 ⭐

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! 🫶 signed off with perl v5.42.0, dated 2025-07-28, and the footer label is Test2::...:Module(3). love that for us. 💖✨