Test::Is(3pm)

📦
version 20140823.1 · 5 versions
, in ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Test::Is 💖

okay bestie, so this is the manual page for Test::Is from the User Contributed Perl Documentation section (that's the 3pm part, iykyk). It's a Perl module that lets you skip tests in a declarative way, following the Lancaster Consensus. Basically it's giving "I'm not running this unless the vibes are right" but, like, as actual code. ✨

🌸 VERSION 🌸

version 20140823.1

✨ SYNOPSIS ✨

Say I want that this runs only on interactive environments:

use Test::Is 'interactive';

Say this test is an extended test: it takes much time to run or may have special running conditions that may inconvenience a user that just want to install the module:

use Test::Is 'extended';

Both, bestie? Both. We do both:

use Test::Is 'interactive', 'extended';

And this test is only for perl 5.10+:

use Test::Is 'perl v5.10';
use feature 'say';
...

🦋 DESCRIPTION 🦋

This module is a simple way of following the specifications of the environment variables available for Perl tests as defined as one of the Lancaster Consensus at Perl QA Hackathon 2013. Link for the environment variables spec, fr fr:

https://github.com/Perl-Toolchain-Gang/toolchain-site/blob/master/lancaster-consensus.md#environment-variables-for-testing-contexts

and the main character consensus itself:

https://github.com/Perl-Toolchain-Gang/toolchain-site/blob/master/lancaster-consensus.md

Those variables — NONINTERACTIVE_TESTING, EXTENDED_TESTING — define which tests should be skipped. 👑

If the environment does not match what the author of the test expected, the complete test is skipped (in the same way as use Test::More skip_all => ...). no half-skipping, no situationship, the whole test is out. 💅

As an author, you can also expect that you will automatically benefit of later evolutions of this specification just by upgrading the module. so you're future-proofed just by updating, periodt.

As a CPAN toolchain author (CPAN client, smoker...) you may want to ensure at runtime that the installed version of this module matches the environment you set yourself. vibe check your own setup, bestie. 🌈

🔥 SEE ALSO 🔥

👑 AUTHOR 👑

Olivier Mengué, <mailto:dolmen@cpan.org>

Copyright © 2013 Olivier Mengué.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl 5 itself.

k that's the whole page bestie, every flag-shaped detail intact, no cap 🧚

this page is perl v5.36.0, dated 2022-10-13, and it lives in Test::Is(3pm) — mwah, take care of her 💖🎀

📦 where this page comes from