Dist::Z...leMunger(3)

✨ NAME ✨

so like… Dist::Zilla::Role::FileMunger — bestie, it's a role for stuff that messes with a file's destination or its content. that's it, that's the whole vibe 💅

---

📌 VERSION 📌

version 6.040 — no cap, that's the one 🫶

---

💖 DESCRIPTION 💖

okay so. a FileMunger gets one (1) chance to mess around with every single file that's gonna be included in the distribution. like, it gets to pull up and do its thing. iconic behavior fr fr ✨

every FileMunger's munge_files method gets called exactly once. and by default, that method is super chill about it: it just calls the munge_file method — yes bestie, note the missing terminal s, it's munge_file not munge_files, don't get it twisted 😭 — one time for each file, and it skips any file that has an encoding attribute of bytes. those ones are not invited to the party 🙈

the whole point of munge_file is that it's expected to change attributes about the file before the file gets written out to the built distribution. that's its moment. main character energy 👑

and if you're the type who wants to modify all the files — yeah, including the ones with an encoding of bytes, the ones that got left out — or if you just want to pick a smaller, more curated little set of files to mess with? then go off and provide your own munge_files method. your munge, your rules 💅

---

🐪 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. slay. consistent.) 🌸

now, it might work on older versions of perl, but no guarantee is made that the minimum required version won't get increased. the version may be increased for any reason, and there's no promise that patches will be accepted to lower the minimum required perl. so don't come for us with that 💀

---

🌟 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, bestie 🦋 this was Dist::Zilla::Role::FileMunger, perl v5.42.3, dated 2026-10-19 — go forth and munge responsibly 💜