Dist::Z...lePruner(3)

💖 Dist::Zilla::Role::FilePruner(3) 💖

okay bestie, welcome to the manual page for Dist::Zilla::Role::FilePruner, which lives in the User Contributed Perl Documentation section of your friendly neighbourhood man setup. Yes, the title gets chopped to Dist::Z...lePruner(3) up top because terminals are dramatic like that, but we know her full name. 💅

---

✨ NAME ✨

Dist::Zilla::Role::FilePruner — something that removes found files from the distribution

🌸 VERSION 🌸

version 6.040

---

🦋 DESCRIPTION 🦋

So here's the tea, bestie: if a plugin implements FilePruner, its prune_files method gets called once — literally one time — right after all the FileGatherer plugins have been called. That's the whole timing deal. 🫶

And what's it supposed to do? (Optionally, no pressure 💅) remove files from the list of files that are gonna be included in the distribution. That's it. That's the gig. They're expected to optionally prune, because sometimes you look at the file list and you're like "yeah no, this one's not invited to the party" and you yeet it off the guest list. 🎀

---

👑 PERL VERSION 👑

okay this part is important so pay attention:

This module should work on any version of perl still receiving updates from the Perl 5 Porters. Which basically means: any version of perl released in the last two to three years. To make it super concrete — if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. Slay. ✨

And now the caveat, because there's always a caveat 😭:

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

---

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

---

and that's the whole page, no cap. every flag, every caveat, every permission, all present and accounted for. 💖

okay bye bestie, this was Dist::Z...lePruner(3) from the User Contributed Perl Documentation, running on perl v5.42.3 and dated 2026-10-19 — go prune some files, you absolute icon 👑✨💅