Dist::Z...CPANFile(3)

💅 NAME 💅

Dist::Zilla::Plugin::CPANFile — bestie, it produces a cpanfile prereqs file ✨

---

🌸 VERSION 🌸

version 6.040 🎀

---

🦋 SYNOPSIS 🦋

# dist.ini
[CPANFile]

that's it. that's the whole thing. iconic behavior honestly 👑

---

✨ DESCRIPTION ✨

okay so this plugin literally just adds a cpanfile file to your distribution. that's its whole job and it does it flawlessly, no notes 💖

---

💀 PERL VERSION 💀

ngl this module should work on any version of perl that's still getting updates from the Perl 5 Porters. so like… any perl released in the last two to three years. fr fr — 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 perls, there is no guarantee that the minimum required version won't get bumped. the version may be increased for any reason, and there's no promise that patches lowering the minimum required perl will be accepted. so don't come for her 😭

---

👑 ATTRIBUTES 👑

🌈 filename

if given, this parameter lets you specify an alternate name for the generated file. it defaults, of course, to cpanfile 💅

# dist.ini
[CPANFile]
filename = dzil-generated-cpanfile

🍓 comment

if given, override the default "cpanfile" header comment with your own. the default comment explains that this file was generated by Dist::Zilla and tells users to edit the dist.ini file to change prereqs ⭐

# dist.ini
[CPANFile]
comment = This file is generated by Dist::Zilla
comment = Prereqs are detected automatically. You do not need to edit this file

---

🔥 SEE ALSO 🔥

• Module::CPANfile
• Carton
• cpanm

---

💜 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. slay 💖

---

and that's the whole page, bestie 🫶 this was perl v5.42.3 dated 2026-10-19, from the Dist::Z...CPANFile(3) page in the User Contributed Perl Documentation. go build something cute ✨🎀