Dist::Z...stRunner(3)

💖 Dist::Z...stRunner(3) 💖

okay bestie, welcome to the manual page for Dist::Z...stRunner(3) — it's a piece of the User Contributed Perl Documentation, and yes the title is doing that cursed truncation thing, we don't talk about it 🙈. This page is short but it's important, so grab a strawberry drink and let's go 🍓✨

🌸 VERSION 🌸

This is version 6.040 — that's the vibe check, and it passed 💅

✨ NAME ✨

Dist::Zilla::Role::TestRunner — literally described as something used as a delegating agent to dzil test. That's it. That's the whole job. Iconic, honestly 👑

🦋 DESCRIPTION 🦋

so here's the tea ☕ — plugins that implement this role get their test method called whenever testing happens. that's the moment. main character energy.

When it's called, it gets handed:

• the root directory of the build test dir 📁, and
• an optional hash reference of arguments 🎀

And the valid arguments in that hashref include:

• jobs — if parallel testing is supported, this says how many tests to run at once 🏃♀️🏃♀️🏃♀️ no cap.

💜 PERL VERSION 💜

This module should work on any version of perl still receiving updates from the Perl 5 Porters. Which means: any perl released in the last two to three years. Fr fr — if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38 🫶

⚠️ okay so, real talk: it may work on older perls, but there is no guarantee that the minimum required version won't get bumped. The version can be increased for any reason, and there's no promise that patches to lower the minimum required perl will be accepted. So don't come for her 💀

---

🎀 ATTRIBUTES 🎀

default_jobs

This attribute is the default value that should be used as the jobs argument to the test method. It's giving "the fallback queen" 👑 — you don't pass jobs yourself, she's got a default for you.

🌈 METHODS 🌈

test

This method should throw an exception on failure. Periodt. If it breaks, it doesn't sulk silently — it throws. 😤

---

💖 AUTHOR 💖

Ricardo SIGNES 😏 <cpan@semiotic.systems>

(he gets an emoji in the byline and honestly? deserved ✨)

📜 COPYRIGHT AND LICENSE 📜

This software is copyright (c) 2026 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay 💅

---

and that's the whole page, bestie!! this was generated by perl v5.42.3 on 2026-10-19 for Dist::Z...stRunner(3) — take care of her, she's doing her best 🧚💜