Dist::Z...uneCruft(3)

💖 NAME 💖

Dist::Zilla::Plugin::PruneCruft — the plugin that prunes all the stuff you probs didn't mean to include, bestie 🧹✨

---

🌸 VERSION 🌸

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

---

✨ SYNOPSIS ✨

okay so real talk: this plugin exists to compensate for the stupid crap that keeps turning up in your working copy 🫠 It removes all of it before it sneaks into your dist and screws everything up. It's giving personal-hygiene-for-your-tarball 💅

Drop it in your dist.ini like this:

[PruneCruft]

And if you want to exclude certain exclusions (yes babe, exclusions of exclusions, we're doing recursion up in here 😭), use the except option — and you can specify it multiple times, fr fr:

[PruneCruft]
except = \.gitignore
except = t/.*/\.keep$

Oh and also? This plugin is included in the @Basic bundle 👑 so if you're already running @Basic, congrats, you already have it.

---

🦋 PERL VERSION 🦋

This module should work on any version of perl that's still receiving updates from the Perl 5 Porters. Which basically means: any version of perl released in the last two to three years. (So like, 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 won't 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. periodt 💀

---

👀 SEE ALSO 👀

• Dist::Zilla plugins: @Basic, PruneFiles, ManifestSkip.

go read those too, they're the friend group 🫶

---

💜 AUTHOR 💜

Ricardo SIGNES 😏 <cpan@semiotic.systems>

---

🎀 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. iykyk 🌈

---

sending u off with the receipts: this was perl v5.42.3, dated 2026-10-19, and the manual page is Dist::Z...uneCruft(3) 💖 now go prune something, bestie 🧚✨