Test2::Require::Module(3) User Contributed Perl Documentation Test2::Require::Module(3)

# [NAME](#NAME)

Test2::Require::Module - Skip tests if certain packages are not installed, or insufficient versions.

# [DESCRIPTION](#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.

# [SYNOPSIS](#SYNOPSIS)

```
    # 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](#SOURCE)

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

# [MAINTAINERS](#MAINTAINERS)

[Chad Granum <exodist@cpan.org>](#Chad)

# [AUTHORS](#AUTHORS)

[Chad Granum <exodist@cpan.org>](#Chad~2)

# [COPYRIGHT](#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/*

2026-10-24 perl v5.44.0

---

Document: Test2::Require::Module(3pm) from perl-test-simple 1.302226-r1 (Chainguard OS)
Source: https://github.com/Test-More/test-more