---
name: "TAP::Harness::Env"
section: "3p"
platform: "openbsd"
package: "man"
version: "8.0-current-20261101"
release: "OpenBSD 8.0-current (2026-11-01)"
platforms: ["openbsd"]
url: "https://new.carta.tech/TAP::Harness::Env"
---

# TAP::Harness::Env(3p)

Parsing harness related environmental variables where appropriate

## NAME

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

## VERSION

Version 3.50

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