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

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

NNAAMMEE #

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

VVEERRSSIIOONN #

 Version 3.44

SSYYNNOOPPSSIISS #

  my $harness = TAP::Harness::Env->create(\%extra_args)

DDEESSCCRRIIPPTTIIOONN #

 This module implements the environmental variables that Test::Harness
 uses with TAP::Harness, and instantiates the appropriate class with the
 appropriate arguments.

MMEETTHHOODDSS #

 •   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.

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS #

“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 _p_r_o_v_e'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.

perl v5.36.3 2023-02-15 TAP::Harness::Env(3p)