prove6(1)

💖 NAME 💖

prove6 — run tests through a TAP harness. bestie, this is your test-running bestie.

---

🎀 USAGE 🎀

okay so here's the whole vibe:

prove6 [options] [files or directories]

✨ Boolean options (yes/no girlies) ✨

• -v, --verbose — print ALL the test lines, every single one, no crumbs left behind.
• -l, --lib — adds lib to the path for your tests (that's -Ilib, iconic).
• --shuffle — runs the tests in random order, chaotic good energy.
• --ignore-exit — ignore the exit status from test scripts. she does not care.
• --reverse — runs the tests in reverse order. backwards slay.
• -q, --quiet — suppresses some test output while running tests.
• -Q, --QUIET — only prints summary results. maximum minimalism 💅
• --timer — prints elapsed time after each test. clock it ⏱️
• --trap — traps Ctrl-C and prints the summary on interrupt.
• --help — displays this help.
• --version — displays the version.

🦋 Options that take arguments (the ones who need something from you) 🦋

• -I, --incdir — library paths to include.
• -e, --exec — interpreter to run the tests ('' for compiled tests).
• --ext — set the extensions for tests (default <t rakutest t6>).
• --harness — define test harness to use. see TAP::Harness.
• --reporter — result reporter to use. see REPORTERS.
• -j, --jobs — run N test jobs in parallel (try 9.)
• --err=stderr — direct the test's $*ERR to the harness' $*ERR.
• --err=merge — merge test scripts' $*ERR with their $*OUT.
• --err=ignore — ignore test script' $*ERR.

---

🌈 NOTES 🌈

🍓 Default Test Directory 🍓

if you don't supply any files or directories, prove6 looks for all files matching the pattern t/*.t. she finds them herself, self-sufficient queen.

🌸 Colored Test Output 🌸

colored test output is the default, but ngl — if output is not to a terminal, color is disabled. the vibe check fails on pipes.

color support requires Terminal::ANSIColor on Unix-like platforms. if the necessary module is not installed, colored output will not be available. 💀 tragic, i know.

⭐ Exit Code ⭐

if the tests fail, prove6 will exit with non-zero status. the numbers WILL tell on you.

---

💜 -e 💜

normally you can just pass a list of Perl 6 tests and the harness will know how to execute them. but — and hear me out — if your tests are not written in Perl 6, or if you want all tests invoked exactly the same way, use the -e switch:

prove6 -e='/usr/bin/ruby -w' t/
prove6 -e='/usr/bin/perl -Tw -mstrict -Ilib' t/
prove6 -e='/path/to/my/customer/exec'

periodt. 💅

---

🔥 --err 🔥

• --err=stderr — direct the test's $*ERR to the harness' $*ERR. this is the default behavior.
• --err=merge — if you need to make sure your diagnostics are displayed in the correct order relative to test results, you can use the --err=merge option to merge the test scripts' $*ERR into their $*OUT. this guarantees that $*OUT (where the test results appear) and $*ERR (where the diagnostics appear) will stay in sync. the harness will display any diagnostics your tests emit on $*ERR.

caveat: this is a bit of a kludge. in particular, note that if anything that appears on $*ERR looks like a test result, the test harness will get confused. use this option only if you understand the consequences and can live with the risk. 🚨

ps: currently not supported.

• --err=ignore — ignore the test script' $*ERR.

---

🧚 --trap 🧚

the --trap option will attempt to trap SIGINT (Ctrl-C) during a test run and display the test summary even if the run is interrupted. she catches the chaos and still gives you the recap. 🫶

---

👑 $*REPO 👑

prove6 introduces a separation between "options passed to the perl which runs prove" and "options passed to the perl which runs tests"; this distinction is by design. thus the perl which is running a test starts with the default $*REPO. additional library directories can be added via the PERL6LIB environment variable, via -Ifoo in PERL6OPT, or via the -Ilib option to prove6. three ways to feed her, she eats them all. ✨

---

and that's the whole page, bestie 🎀 — this was prove6(1) from the General Commands Manual, brought to you by the prove6(1) girlies themselves. mwah, go run your tests. 💖🦋💅