1Test::Is(3)           User Contributed Perl Documentation          Test::Is(3)
2
3
4

NAME

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

VERSION

10       version 20140823.1
11

SYNOPSIS

13       I want that this runs only on interactive environments:
14
15           use Test::Is 'interactive';
16
17       This test is an extended test: it takes much time to run or may have
18       special running conditions that may inconvenience a user that just want
19       to install the module:
20
21           use Test::Is 'extended';
22
23       Both:
24
25           use Test::Is 'interactive', 'extended';
26
27       This test is only for perl 5.10+:
28
29           use Test::Is 'perl v5.10';
30           use feature 'say';
31           ...
32

DESCRIPTION

34       This module is a simple way of following the specifications of the
35       environment <https://github.com/Perl-Toolchain-Gang/toolchain-
36       site/blob/master/lancaster-consensus.md#environment-variables-for-
37       testing-contexts> variables available for Perl tests as defined as one
38       of the "Lancaster Consensus <https://github.com/Perl-Toolchain-
39       Gang/toolchain-site/blob/master/lancaster-consensus.md>" at Perl QA
40       Hackathon 2013. Those variables ("NONINTERACTIVE_TESTING",
41       "EXTENDED_TESTING") define which tests should be skipped.
42
43       If the environment does not match what the author of the test expected,
44       the complete test is skipped (in the same way as "use Test::More
45       skip_all => ...").
46
47       As an author, you can also expect that you will automatically benefit
48       of later evolutions of this specification just by upgrading the module.
49
50       As a CPAN toolchain author (CPAN client, smoker...) you may want to
51       ensure at runtime that the installed version of this module matches the
52       environment you set yourself.
53

SEE ALSO

55       •   Environment variables for testing contexts
56           <https://github.com/Perl-Toolchain-Gang/toolchain-
57           site/blob/master/lancaster-consensus.md#environment-variables-for-
58           testing-contexts>: the specification of the Lancaster Consensus.
59
60       •   Test::DescribeMe by WOLFSAGE, also created at Perl QA Hackathon
61           2013.
62

AUTHOR

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

67       Copyright © 2013 Olivier Mengué.
68
69       This library is free software; you can redistribute it and/or modify it
70       under the same terms as Perl 5 itself.
71
72
73
74perl v5.36.0                      2023-01-20                       Test::Is(3)
Impressum