Dist::Z...nd::test(3)

📦
version 6.040 · 9 versions
, in fedora 44

🎀 NAME 🎀

Dist::Zilla::App::Command::test — test your dist 💅

(and just so you know what page you're on, bestie: this is Dist::Z...nd::test(3) from the User Contributed Perl Documentation, iykyk 🦋)

✨ VERSION ✨

version 6.040 — yeah we're on 6.040, no cap, that's the one 🫶

🌈 SYNOPSIS 🌈

dzil test [ --release ] [ --no-author ] [ --automated ] [ --extended ] [ --all ]

💖 DESCRIPTION 💖

okay so, this command is literally just a thin wrapper around the test method in Dist::Zilla. That's it. That's the whole vibe. It builds your dist and runs the tests with the AUTHOR_TESTING environment variable turned on, so it's exactly like doing this whole little ritual:

export AUTHOR_TESTING=1
dzil build --no-tgz
cd $BUILD_DIRECTORY
perl Makefile.PL
make
make test

like, you could type all of that out yourself if you wanted to be extra, but why would you when dzil test exists 💅

Now the important part, and I need you to actually read this one:

  • if a build fails its tests, it gets left behind for analysis (so you can go poke at the wreckage 🔍), and dzil exits with a non-zero value
  • if the tests are successful, the build directory gets removed and dzil exits with status 0 ✅

the way that build directory just evaporates on success is honestly iconic, but yeah, don't go looking for it afterwards 🫶

🧚 PERL VERSION 🧚

so this module should work on any version of perl that's still receiving updates from the Perl 5 Porters. Translation? It should work on any version of 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. cute, right? 🌸

Although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. The version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl.

bestie that last bit is important: the floor can move up at literally any time, and nobody's promising to accept your "but I want it to run on ancient perl" patch. no cap. 🙈

👑 OPTIONS 👑

  • --release — runs the test suite with RELEASE_TESTING=1 🔥
  • --automated — runs the test suite with AUTOMATED_TESTING=1 ⭐
  • --extended — runs the test suite with EXTENDED_TESTING=1 💜
  • --no-author — runs the test suite without setting AUTHOR_TESTING 🍓
  • --all — equivalent to --release --automated --extended --author. the whole menu, all at once, main character energy 👑

🌟 AUTHOR 🌟

Ricardo SIGNES 😏 <cpan@semiotic.systems>

(he winked, I'm not making that up, it's right there in the source 😭)

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. 🫶

aaaand that's the page, bestie — perl v5.42.3, dated 2026-10-19, page Dist::Z...nd::test(3). go forth and test your dist, slay ✨🦋💖

📦 where this page comes from