NAME

Chj::TEST

SYNOPSIS

 use Chj::TEST;
 # or
 use Chj::TEST use=> 'Method::Signatures'
     #, use=> ['Foo::Bar', qw(bar baz)],
     #, require=> 'CGI'
     ;
 # ^ this will use or require the indicated modules, and if RUN_TESTS
 # is set and they fail, will gracefully fail with a SKIP testing message
 # (if RUN_TESTS is not set, it will die as normally).

 TEST { 1+1 } 2; # success
 TEST { 1+1 } "2"; # fails,
     # because equality is compared on the result of Data::Dumper

 # compute also result lazily:
 TEST { 1+1 } GIVES {3-1}; # success

 TEST_STDOUT { print "Hello" } "Hello";
 TEST_EXCEPTION { die "Hello" } "Hello"; # " at .. line .." and
                                         # backtrace are cut off


 use Chj::TEST ':all';

 is run_tests(__PACKAGE__), 0; # 0 failures

 #run_tests;
 #  or
 #run_tests __PACKAGE__, "Another::Package";
 #  or
 #run_tests_ packages=> __PACKAGE__, numbers=>[2..4];
 #   aliases package, number, no also accepted

 #  For conditional running the tests as part of a global test suite:
 #perhaps_run_tests "main" or do_something_else;
 #  This will run run_tests("main") iff the RUN_TESTS environment
 #  variable is true, otherwise run do_something_else.

DESCRIPTION

If the `TEST` environmental variable is set to false (as opposed to not set at all), tests are dropped. This saves the memory otherwise required to hold the test code and results.

SEE ALSO

Chj::noTEST