TAP::Harness::Env(3p) | Perl Programmers Reference Guide | TAP::Harness::Env(3p)

# NAME

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

# VERSION

Version 3.48

# 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 separated 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.

2025-01-28 | perl v5.40.1