TAP::Harness::Env(3pm)

📦
version 5.42.3 · 15 versions
, in alpine 3.24

🌸 TAP::Harness::Env(3pm) 🌸

okay bestie, welcome to TAP::Harness::Env(3pm) from the Perl Programmers Reference Guide — it's giving environment-variable parser for your harness, and yes it's iconic for that. ✨

🎀 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. No cap: it's the little env-var matchmaker. 💖

🌟 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. It accepts "harness_class" (which defaults to "TAP::Harness"), and any argument the harness class accepts. Slay. 💅

✨ 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 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. 🙈

okay that's the whole vibe check 💅 — this page came from perl v5.42.3, dated 2026-11-03, and it's TAP::Harness::Env(3pm) signing off 🫶✨

📦 where this page comes from