NAME

Test::Is - Skip test in a declarative way, following the Lancaster Consensus

VERSION

version 20140823.1

SYNOPSIS

I want that this runs only on interactive environments:

    use Test::Is 'interactive';

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:

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

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. 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 => ...).

As an author, you can also expect that you will automatically benefit of later evolutions of this specification just by upgrading the module.

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.

SEE ALSO

• Environment variables for testing contexts: the specification of the Lancaster Consensus.

• Test::DescribeMe by WOLFSAGE, also created at Perl QA Hackathon 2013.

AUTHOR

Olivier Mengué, mailto:dolmen@cpan.org

COPYRIGHT & LICENSE

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.