Dist::Z...::smoke(3)

💨 Dist::Z...::smoke(3) — bestie's guide to smoking your dist

okay so this is Dist::Z...::smoke(3), from the User Contributed Perl Documentation, and it's literally the manual page for Dist::Zilla::App::Command::smoke — aka the thing that smokes your dist 🌸

---

✨ NAME ✨

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

🎀 VERSION 🎀

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

🦋 SYNOPSIS 🦋

  dzil smoke [ --release ] [ --author ] [ --no-automated ]

that's it. that's the whole vibe. three optional flags and you're off 👑

🌈 DESCRIPTION 🌈

okay so this command builds and tests the distribution in "smoke testing mode." it's giving "let's just see if it even works" energy and honestly? iconic.

this command is a thin wrapper around the test method in Dist::Zilla. like, it's not doing anything wild, it's just doing the thing for you. it builds your dist and runs the tests with the AUTOMATED_TESTING environment variable turned on, so it's basically the same as you doing this whole little dance yourself:

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

and here's the tea on what happens after ☕️:

• if a build fails tests, it gets left behind for analysis (so you can go poke at it, bestie, it's not going anywhere) and dzil exits with a non-zero value 😭
• if the tests are successful, the build directory gets removed and dzil exits with status 0 ✨

so basically: fail = sad leftover dir + nonzero exit, win = clean sweep + 0. the vibe check is real.

💜 PERL VERSION 💜

This module should work on any version of perl still receiving updates from the Perl 5 Porters. This means it should work on any version of perl released in the last two to three years. (That is, if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38.)

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.

fr fr, don't come for the maintainers about ancient perl. the minimum can go up whenever, for any reason, and patches to lower it might just get a 💀. no promises, bestie.

💅 OPTIONS 💅

one bullet per flag, as the universe intended:

• --release — this will run the test suite with RELEASE_TESTING=1 🔥
• --no-automated — this will run the test suite without setting AUTOMATED_TESTING 🙈
• --author — this will run the test suite with AUTHOR_TESTING=1 ✨

---

👑 AUTHOR 👑

Ricardo SIGNES 😏 <cpan@semiotic.systems>

(not me putting the little smirk emoji in there — it's canon, it's in the original, I don't make the rules 🫶)

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

---

aaaand that's the whole page, bestie 🧚 go smoke that dist. and for the cute sign-off: this lil doc is running on perl v5.42.3, dated 2026-10-19, filed under Dist::Z...::smoke(3) — slay, bye 💖