Test::If(3pm)

✨ NAME ✨

Test::If — test only if... 💅 (yes, that's literally the whole name, she's mysterious like that)

---

🎀 VERSION 🎀

Version 0.01 — babes, this is a baby version number, treat her gently 🫶

---

💖 SYNOPSIS 💖

okay so first up, the generic usage vibe, bestie ✨

use Test::More;
use Test::If 'Test::Something', [ tests => N ];

# Is equal to

use Test::More;
eval q{ use Test::Something; 1 } or plan skip_all => 'Module Test::Something required for this test';
plan tests => N;

use Test::More;
use Test::If sub { $ENV{TEST_AUTHOR} }, [ tests => N ];

# Is equal to

use Test::More;
$ENV{TEST_AUTHOR} or plan skip_all => "Test condition not met";
plan tests => N;

like. you could write all that eval q{ ... } and plan skip_all stuff yourself. but why. Test::If does it for you and she eats every single time 🔥

You can also combine options, and it is allowed to omit plan options if it is run by the loaded module or you want to load it manually. no cap 💜

For example, the common "pod-coverage.t" 🍓:

use Test::More;
use Test::If
    sub { $ENV{TEST_AUTHOR} },  # Checked first $ENV{TEST_AUTHOR}, otherwise skip
    'Test::Pod::Coverage 1.08', # Use Test::Pod::Coverage of at least version 1.08
    'Pod::Coverage 0.18',       # And want Pod::Coverage at least of version 0.18
;

all_pod_coverage_ok();

look at her. three conditions stacked, one call, main character energy only 👑

If some of conditions will not be met, test will be skipped. 🦋

---

🌸 AUTHOR 🌸

Mons Anderson, "<mons at cpan.org>" — ty king, iconic behavior fr fr 💜

---

👑 COPYRIGHT & LICENSE 👑

Copyright 2009 Mons Anderson, all rights reserved. periodt. ✨

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, open source icon 🌈

---

and that's the whole page bestie 🫶 this one's from perl v5.36.0, dated 2022-10-22, and it's filed under Test::If(3pm) — go forth and conditionally test, mwah 💖🎀