App::Y...verting(3pm)

📦
version 1.000172 · 8 versions
, in ubuntu stonking

💖 App::Y...verting(3pm) — the manual page bestie, but make it a group chat

okay so real talk: this is App::Y...verting, a page from the User Contributed Perl Documentation collection, and it's literally just the "things you gotta change in your tests before you can use yath" list. no cap. it's the glow-up guide your test suite didn't know it needed. 🦋

✨ NAME ✨

App::Y...verting — the stuff you may need to change in your tests before you can use yath. 💅

🌸 NON-TAP FORMATTER 🌸

so by default yath tells any Test2 or Test::Builder tests to use Test2::Formatter::Stream instead of Test2::Formatter::TAP. why? because the goal is to get as much data as possible to yath, and TAP is, hate to say it, a lossy formatter by comparison. it's giving ✨bottleneck✨.

normally this is not a problem at all, bestie. but — and here's the tea — tests that do strange things with STDERR/STDOUT, or that try to intercept output from the regular TAP formatter, can lowkey have issues with this. 🫠

🎀 SOLUTIONS 🎀

🔥 HARNESS-NO-STREAM

you can add a harness directive to the top of the offending tests that tells the harness those specific tests should still use the TAP formatter. iconic behavior.

#!/usr/bin/perl
# HARNESS-NO-STREAM
...

this directive can come after the #! line, and after use statements, but it must come BEFORE any empty lines or runtime statements. do not skip that part. periodt. 👑

🦋 --no-stream

you can also run yath with the --no-stream option, which will have tests default to TAP.

not recommended though bestie, because TAP is lossy. 😭

💀 TESTS ARE RUN VIA FORK BY DEFAULT 💀

the default mode for yath is to preload a few things, then fork to spawn each test. it's a complicated procedure, and it uses goto::file under the hood. ngl sometimes you have tests that simply will not work this way, or tests that verify specific libraries are not already loaded. vibe check: failed. 💔

💜 SOLUTIONS 💜

🌈 HARNESS-NO-PRELOAD

you can use this harness directive inside your tests to tell yath not to fork, but to instead launch a new perl process to run the test. slay.

#!/usr/bin/perl
# HARNESS-NO-PRELOAD
...

🍓 --no-fork

🎀 --no-preload

both of these options tell yath not to preload+fork, but to run ALL tests in new processes.

it's slow though. like, slow slow. it is better to mark specific tests that have issues in preload mode. ✨ targeted, not blanket ✨

🧚 SOURCE 🧚

the source code repository for Test2-Harness can be found at

http://github.com/Test-More/Test2-Harness/

👑 MAINTAINERS 👑

Chad Granum <exodist@cpan.org>

⭐ AUTHORS ⭐

Chad Granum <exodist@cpan.org>

Copyright 2020 Chad Granum <exodist7@gmail.com>.

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/

and that's the whole page bestie, you ate 💅✨ this was perl v5.40.1, dated 2026-05-10, and yep — it's still App::Y...verting(3pm) at the top and the bottom, main character energy from start to finish. 🎀🦋💜

📦 where this page comes from