Test2::Env(3)

🌸 NAME 🌸

Test2::Env(3) is the manual for Test2::Env — Documentation for environment variables used or set by Test2. Basically it's the env-var lore drop, bestie. 💖

✨ DESCRIPTION ✨

This is a list of environment variables that are either set by, or read by Test2. That's it. That's the whole assignment. Every variable has its own little section below, so you can scroll and vibe-check exactly what's up. 🫶

🎀 AUTHOR_TESTING 🎀

This env var is read by Test2. When set, Test2 will run tests that are normally skipped unless a module author is doing extra author-specific testing. So it's the "author mode: on" little switch, iykyk. ✨

🎀 AUTOMATED_TESTING 🎀

This env var is read by Test2. When set, it indicates the tests are run by an automated system and no human interaction is possible. Lowkey important for automated vibes. 🦋

See Test2::Require::AuthorTesting.

🎀 EXTENDED_TESTING 🎀

This env var is read by Test2. When set it indicates some extended testing that should normally be skipped will be run. It's giving "extra credit tests are unlocked". 💅

See Test2::Require::ExtendedTesting.

🎀 HARNESS_ACTIVE 🎀

This env var is read by Test2. It is usually set by prove (Test::Harness) or yath (App::Yath). So if you're running under a harness, this is the little signal that says "yup, we're in harness land". 🎀

🎀 NONINTERACTIVE_TESTING 🎀

This env var is read by Test2. When set this indicates the testing will not be interactive. No prompts, no waiting on a human, just non-interactive mode. 💜

See Test2::Require::NonInteractiveTesting.

🎀 RELEASE_TESTING 🎀

This env var is read by Test2. When set this indicates that release testing is being done, which may run more tests than normal. Release mode = extra tests, no cap. 🔥

See Test2::Require::ReleaseTesting.

🎀 T2_FORMATTER 🎀

This can be used to set the formatter that Test2 will use. If set to a string without a '+' prefix, then Test2::Formatter:: will be added to the start of the module name. If '+' is present it will be stripped and no further modification will be made to the module name. So the plus sign is literally the "don't namespace me, bestie" button. 💅

🎀 T2_IN_PRELOAD 🎀

Test2 sets this when preload mode is active. This is mainly used by App::Yath and similar tools that preload Test2, then fork to run tests. Preload, fork, slay. 🧚

🎀 TABLE_TERM_SIZE 🎀

This is used to set a terminal width for things like diagnostic message tables. So if your tables look cursed, this is the width knob. 🎀

🎀 TEST2_ACTIVE 🎀

Test2 sets this variable when tests are running. It's the "tests are alive" flag. ⭐

🎀 TEST2_ENABLE_PLUGINS 🎀

This can be used to force plugins to be loaded when the Test2 API is loaded. It takes a list of one or more plugin names separated by comma. If the module name does not have a '+' in front of it then the Test2::Plugin:: namespace is assumed and added. If a '+' is present at the start of a module name it will be stripped and no further modification will be made.

Examples:

TEST2_ENABLE_PLUGINS=BailOnFail
Test2_ENABLE_PLUGINS=SRand,+My::Plugin::Name

🎀 TEST_ACTIVE 🎀

Set by Test2 when tests are running. That's the whole thing, bestie. 🌈

🎀 TS_MAX_DELTA 🎀

Used to determine how many max lines of output will be provided when is() finds a deep data structure mismatch. So when your deep data structure fails, this decides how much of the mess you get to see. 😭

🎀 SOURCE 🎀

The source code repository for Test2-Suite can be found at https://github.com/Test-More/test-more/. Go look, bestie. 🫶

🎀 MAINTAINERS 🎀

Chad Granum <exodist@cpan.org>

🎀 AUTHORS 🎀

Chad Granum <exodist@cpan.org>

🎀 COPYRIGHT 🎀

Copyright Chad Granum <exodist@cpan.org>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/

---

That's the whole manual, bestie! 🫶 This is Test2::Env(3) from perl v5.42.0, dated 2025-07-28. Now go forth and env-var with main character energy. 💅✨