Dist::Z...DistINI(3)

💖 Dist::Zilla::Plugin::DistINI — a plugin to add a dist.ini to newly-minted dists 💖

okay bestie, welcome to the manual page for Dist::Zilla::Plugin::DistINI, which lives in the User Contributed Perl Documentation and is literally the plugin that hands your brand-new dist its very own dist.ini. 🎀

✨ VERSION ✨

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

---

🌸 DESCRIPTION 🌸

so this plugin does one thing and it does it with main character energy: it produces a dist.ini file in a new dist, laying out the required core attributes from the dist that's being minted. periodt. 💅

ngl, this plugin is dead simple and pretty stupid, but the vibe is that it'll get better as dist minting facilities improve. like, for example? it will not specify any plugins. not even one. it's giving bare minimum. 😭

in the meantime, you may be happier with a dist.ini template. just saying. 🙈

---

🧚 PERL VERSION 🧚

this module should work on any version of perl still receiving updates from the Perl 5 Porters. that 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 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 don't come for her about it. 💀

---

👑 ATTRIBUTES 👑

🍓 append_file

this parameter may be a filename in the profile's directory to append to the generated dist.ini with things like plugins. iykyk. ✨

in other words, if you make this file, called plugins.ini:

[@Basic]
[NextRelease]
[@Git]

…and your profile.ini includes:

[DistINI]
append_file = plugins.ini

…then the generated dist.ini in a newly-minted dist will look something like this:

name    = My-New-Dist
author  = E. Xavier Ample <example@example.com>
license = Perl_5
copyright_holder = E. Xavier Ample
copyright_year   = 2010

[@Basic]
[NextRelease]
[@Git]

and that's it, that's the whole glow-up. 🔥

---

💜 AUTHOR 💜

Ricardo SIGNES 😏 <cpan@semiotic.systems> — an icon, honestly.

🌟 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. 💖

---

okay that's the whole page, bestie! this one was generated by perl v5.42.3 and dated 2026-10-19, and it belongs to the Dist::Z...DistINI(3) corner of the User Contributed Perl Documentation. take care of her, she's doing her best. 🫶🌸👑