Dist::Z...:Tester(3)

📦
version 6.040 · 9 versions
, in fedora 44

🌸 NAME 🌸

Dist::Zilla::App::Tester — bestie, it's the testing library for Dist::Zilla::App. That's the whole vibe. You're in the right spot in the manual (section 3), we're so back. 💖

✨ VERSION ✨

version 6.040 — that's the one, no cap.

🦋 DESCRIPTION 🦋

Okay so here's the tea: this module exports literally one function. One. That's it. And its name is test_dzil. Iconic minimalism, honestly. 👑

💅 test_dzil

This function is how you test Dist::Zilla::App. She takes two mandatory options, and bestie, they are not optional, I need you to know that:

  1. The path to a Dist::Zilla-based distribution. Where the thing lives. 📁
  2. An array reference to a list of arguments. Yes, an arrayref, I said what I said.

Then there's a third optional argument — a hash reference with even more options inside. And rn, at this exact moment in time, the only supported option in there is tempdir.

And what does she give you back? A Dist::Zilla::App::Tester::Result 🫶 — which inherits from App::Cmd::Tester::Result. So all that parent energy comes along for free.

The methods people typically call on that result are these three, and honestly? They ate:

  • output — the output of running dzil. Everything she said while she was working. 📢
  • tempdir — the folder used for temporary files. The little home for the throwaway stuff. 🏠
  • build_dir — the folder where the distribution was built. Where the baby got assembled. 🍼

🌈 PERL VERSION 🌈

So this module should work on any version of perl still receiving updates from the Perl 5 Porters. Which basically means: any perl released in the last two to three years. Like, if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. That's the rule. 📏

Now, could it maybe work on older perls? Sure, maybe, but no guarantee is made that the minimum required version won't get raised. It can be raised for literally any reason, and there is no promise that patches to lower the minimum will be accepted. So don't come for her. 💀

👑 AUTHOR 👑

Ricardo SIGNES 😏 <cpan@semiotic.systems> — main character, honestly.

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. So go forth and share the love, bestie. 🫶

And that's the whole page fr fr 💖 — brought to you by perl v5.42.3, dated 2026-10-19, straight from the Dist::Z...:Tester(3) corner of the Dist::Zilla::App docs. Go write some tests, you've got this. ✨🦋🌸

📦 where this page comes from