TAP::HARNESS::ENV(3perl)

💖 TAP::Harness::Env 💖

okay bestie, so this is TAP::Harness::Env from the Perl Programmers Reference Guide — it's the little module that reads your environment variables and hands you back a fully-glammed-up harness object. slay ✨

---

🌸 NAME 🌸

TAP::Harness::Env — parsing harness related environmental variables where appropriate 🎀

like, it reads the env vars and does the right thing. that's the whole vibe. 💅

---

⭐ VERSION ⭐

Version 3.52 — periodt, that's the one you're getting. 👑

---

🦋 SYNOPSIS 🦋

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

that's it. one line. one call. main character energy fr fr. 💜

---

✨ DESCRIPTION ✨

so this module is the one that implements all the environmental variables that Test::Harness uses together with TAP::Harness, and then it instantiates the appropriate class with the appropriate arguments. no cap. it's giving glue code, but make it iconic. 🫶

---

💅 METHODS 💅

• create( \%args ) — This function reads the environment and generates an appropriate argument hash from it. If you hand it any arguments in %extra_args, those are gonna override the environmental defaults (yes bestie, your args win, the env could never 🙈). It accepts "harness_class" (which defaults to "TAP::Harness"), and any argument the harness class accepts. 🎀

---

🌈 ENVIRONMENTAL VARIABLES 🌈

these are the levers you can pull from outside the code. obsessed honestly. 💖

• "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. lowkey iconic.
• "HARNESS_VERBOSE" If true, "TAP::Harness" will output the verbose results of running its tests. it's giving tell me everything, i wanna know. 👑
• "HARNESS_SUBCLASS" Specifies a TAP::Harness subclass to be used in place of TAP::Harness. customisation era fr fr. 🦋
• "HARNESS_OPTIONS" Provide additional options to the harness. Currently supported options are:
  • "j<n>" — Run <n> (default 9) parallel jobs. multitasking queen. 🔥
  • "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. iykyk. 💀

Multiple options may be separated by colons:

HARNESS_OPTIONS=j9:c make test

see? colons. cute little separators. 🎀

• "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. yesss make it pretty. 🌈💅
• "HARNESS_IGNORE_EXIT" If set to a true value, instruct "TAP::Parser" to ignore exit and wait status from test scripts. like, we simply are not looking at that. 🙈

---

and that's the whole page bestie!! 🫶 this was perl v5.44.0, dated 2026-10-17, and it's the TAP::Harness::Env(3perl) page — go forth and configure your harness, you absolute legend. 💜🎀✨