Dist::Zilla::Util(3)

💖 Dist::Zilla::Util 💖

okay bestie, welcome to Dist::Zilla::Util — the lil grab-bag of helper bits that Dist::Zilla itself reaches for. It's User Contributed Perl Documentation energy, and it's literally just "random snippets of code that Dist::Zilla wants". no cap, that's the whole job description. 🎀

---

✨ VERSION ✨

version 6.040 🫶

---

🧚 PERL VERSION 🧚

ok so this module is designed to work on any version of perl still receiving updates from the Perl 5 Porters. Translation? Any perl released in the last, like, two to three years. So if the newest drop is v5.40, then bestie, this works on both v5.40 and v5.38. iconic behavior. 💅

Now for the ✨fine print✨ that you really need to hear: it might work on older perls, but there's no guarantee the minimum required version won't get bumped up. It can be raised for literally any reason, and there is no promise that patches lowering the minimum perl will be accepted. so don't come for her. 😭

---

🔥 METHODS 🔥

🌸 abstract_from_file

This method — and bestie, listen, it is likely to change or go away — tries to guess the abstract of a file, assuming that file is Perl code. 🕵️‍♀️

How does it guess? It goes looking for:

• a POD =head1 section called NAME, or
• a comment beginning with ABSTRACT:

that's it, that's the vibe check. 🌈

🌸 expand_config_package_name

my $pkg_name = Dist::Zilla::Util->expand_config_package_name($string);

Also likely to change or go away, because we keep it real here. This one takes the string you hand it and rewrites it into a package name. ✨

The prefixes get rewritten like this:

• = becomes nothing (just… poof, gone, no notes 💀)
• @ becomes Dist::Zilla::PluginBundle::
• % becomes Dist::Zilla::Stash::
• otherwise, Dist::Zilla::Plugin:: gets prepended in front 🎀

periodt. that's the whole transformation table.

---

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

---

ok that's the whole page bestie!! go forth and guess some abstracts 💖

and a lil sign-off for you: this was perl v5.42.3, dated 2026-10-19, and the page is Dist::Zilla::Util(3). slay, bye!! ✨🦋💅