Test::Requires(3)

💅 Test::Requires — the vibe check for your modules, bestie ✨

Okay so real talk: this is the manual page for Test::Requires, and it's genuinely one of those tiny modules that just gets it. No cap. Let's break it down together 🫶

---

✨ NAME ✨

Test::Requires — it literally just checks to see if the module can be loaded. That's the whole job. Iconic, low-effort, high-impact 🎀

---

🌸 SYNOPSIS 🌸

So here's how you actually use it, in all its forms. Copy these exactly, bestie, don't freestyle 💅

    # in your Makefile.PL
    use inc::Module::Install;
    test_requires 'Test::Requires';

    # in your test
    use Test::More tests => 10;
    use Test::Requires {
        'HTTP::MobileAttribute' => 0.01, # skip all if HTTP::MobileAttribute doesn't installed
    };
    isa_ok HTTP::MobileAttribute->new, 'HTTP::MobileAttribute::NonMobile';

    # or
    use Test::More tests => 10;
    use Test::Requires qw(
        HTTP::MobileAttribute
    );
    isa_ok HTTP::MobileAttribute->new, 'HTTP::MobileAttribute::NonMobile';

    # or
    use Test::More tests => 10;
    use Test::Requires;
    test_requires 'Some::Optional::Test::Required::Modules';
    isa_ok HTTP::MobileAttribute->new, 'HTTP::MobileAttribute::NonMobile';

Like… pick whichever flavor speaks to you, they all slay 🌈

---

🦋 DESCRIPTION 🦋

So Test::Requires checks to see if the module can be loaded. That's it. That's the whole mood ✨

And here's the cute part: if this fails, it doesn't fail your tests — it skips all of them instead. It's giving "no drama, just gracefully stepping aside" energy 💀

It can also be used to require a minimum version of Perl, which is honestly so useful:

    use Test::Requires "5.010";  # quoting is necessary!!

    # or
    use Test::Requires "v5.10";

⚠️ Bestie, notice that # quoting is necessary!! comment? Yeah. Quote it. Don't come crying to me when it breaks 😭

---

💖 AUTHOR 💖

Tokuhiro Matsuno <tokuhirom @*(#RJKLFHFSDLJF gmail.com>

(Yes, that email is exactly as cursed as it looks. I don't make the rules, I just report them 🙈)

---

👑 THANKS TO 👑

These absolute legends made it happen:

    kazuho++ # some tricky stuff
    miyagawa++ # original code from t/TestPlagger.pm
    tomyhero++ # reported issue related older test::builder
    tobyink++ # documented that Test::Requires "5.010" works

We stan a collaborative community 🫶✨

---

🍓 ENVIRONMENT 🍓

So there's this environment variable, right? If RELEASE_TESTING is true, then instead of skipping tests, Test::Requires bails out. Different energy entirely — that's the "we're not playing around anymore" mode 💅🔥

---

🧚 SEE ALSO 🧚

• "TestPlagger.pm" in t — go look, iykyk 👀

---

💜 LICENSE 💜

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Slay, open source queen 👑🌸

---

Okay bestie, that's the whole page 💖 This iconic documentation was brought to you by perl v5.42.0, dated 2020-05-14, and honestly? A moment. Periodt. 🎀✨🦋