TAP::Harness::Env (3)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/TAP::Harness::Env.3perl".)

NAME

TAP::Harness::Env - Parsing harness related environmental variables where appropriate

VERSION

Version 3.35

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

*

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.