TAP::Harness::Env - Parsing harness related environmental variables where appropriate
my $harness = TAP::Harness::Env->create(\%extra_args)
Perl Programmers Reference Guide TAP::Harness::Env(3)
NAME
TAP::Harness::Env - Parsing harness related environmental variables
where appropriate
VERSION
Version 3.42
SYNOPSIS
my $harness = TAP::Harness::Env->create(\%extra_args)
DESCRIPTION
This module implements the environmental variables that Test::Harness
uses with TAP::Harness, and instantiates the appropriate class with the
appropriate arguments.
METHODS
o 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.
ENVIRONMENTAL VARIABLES
"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_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"
"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.
"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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | runtime/perl-532 |
+---------------+-----------------------+
|Stability | Pass-through volatile |
+---------------+-----------------------+
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from
http://www.cpan.org/src/5.0/perl-5.32.0.tar.gz.
Further information about this software can be found on the open source
community website at https://www.perl.org/.
perl v5.32.0 2020-06-14 TAP::Harness::Env(3)