TAP::Harness::Env - Parsing harness related environmental variables where appropriate
Version 3.35
my $harness = TAP::Harness::Env->create(\%extra_args)
This module implements the environmental variables that Test::Harness uses with TAP::Harness, and instantiates the appropriate class with the appropriate arguments.
create( \%args )
This function reads the environment and generates an appropriate argument hash from it. If given any arguments in %extra_args, these will override the environmental defaults. In accepts harness_class (which defaults to TAP::Harness), and any argument the harness class accepts.
%extra_args
harness_class
TAP::Harness
HARNESS_PERL_SWITCHES
Setting this adds perl command line switches to each test file run.
For example, HARNESS_PERL_SWITCHES=-T will turn on taint mode. HARNESS_PERL_SWITCHES=-MDevel::Cover will run Devel::Cover for each test.
HARNESS_PERL_SWITCHES=-T
HARNESS_PERL_SWITCHES=-MDevel::Cover
Devel::Cover
HARNESS_VERBOSE
If true, TAP::Harness will output the verbose results of running its tests.
HARNESS_SUBCLASS
Specifies a TAP::Harness subclass to be used in place of TAP::Harness.
HARNESS_OPTIONS
Provide additional options to the harness. Currently supported options are:
j<n>
Run <n> (default 9) parallel jobs.
c
Try to color output. See "new" in TAP::Formatter::Base.
a<file.tgz>
Will use TAP::Harness::Archive as the harness class, and save the TAP to file.tgz
file.tgz
fPackage-With-Dashes
Set the formatter_class of the harness being run. Since the HARNESS_OPTIONS is seperated by :, we use - instead.
:
-
Multiple options may be separated by colons:
HARNESS_OPTIONS=j9:c make test
HARNESS_TIMER
Setting this to true will make the harness display the number of milliseconds each test took. You can also use prove's --timer switch.
--timer
HARNESS_COLOR
Attempt to produce color output.
HARNESS_IGNORE_EXIT
If set to a true value instruct TAP::Parser to ignore exit and wait status from test scripts.
TAP::Parser
To install Test::Harness, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Test::Harness
CPAN shell
perl -MCPAN -e shell install Test::Harness
For more information on module installation, please visit the detailed CPAN module installation guide.