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

💖 NAME 💖

Dist::Zilla::App::Command::run — bestie, it runs stuff in a dir where your dist is built ✨

---

🌸 VERSION 🌸

version 6.040 — yeah she's on 6.040, iconique 💅

---

🎀 SYNOPSIS 🎀

  $ dzil run ./bin/myscript
  $ dzil run prove -bv t/mytest.t
  $ dzil run bash

like... that's it. that's the whole vibe. 😌

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — this command builds your dist with Dist::Zilla, then builds the distribution, and THEN runs a command in the build directory. it's basically doing this whole thing, lowkey:

  dzil build
  rsync -avp My-Project-version/ .build/
  cd .build
  perl Makefile.PL            # or perl Build.PL
  make                        # or ./Build
  export PERL5LIB=$PWD/blib/lib:$PWD/blib/arch
  <your command as defined by rest of params>

except — and this is the little plot twist — it's built directly in a subdir of .build, like .build/69105y2 👀

and now for the important part, listen up 🫶: if your command returns a non-zero error code, the build directory gets left behind for analysis (so you can go snoop 🔍), and dzil will exit with a non-zero status. otherwise? build dir gets yeeted 🗑️ and dzil exits with status zero. main character behavior honestly.

if no run command is provided, a new default shell is invoked ✨ this is genuinely so useful for testing your distribution as if it were installed, no cap.

---

🌈 PERL VERSION 🌈

this module should work on any version of perl still receiving updates from the Perl 5 Porters. so basically, 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. periodt. 👑)

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. so don't come for her about it 💀

---

💜 AUTHOR 💜

Ricardo SIGNES 😏 <cpan@semiotic.systems> — yeah, THE Ricardo SIGNES. iconic. ✨

---

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

---

okay bestie that's the whole page!! this one's perl v5.42.3, dated 2026-10-19, and it came to you from the fine folks of the Dist::Zilla run command manual under User Contributed Perl Documentation. go build something cute 💖🧚‍♀️