Dist::Z...::Zilla(3)

💖 Dist::Z...::Zilla(3) 💖

okay bestie, so this page lives in your User Contributed Perl Documentation and it's literally called Dist::Z...::Zilla(3). Yes the name is giving "the tab bar cut it off mid-sentence" but we move, it's iconic, let's go 🦋

✨ NAME ✨

Dist::Zilla::MVP::Assembler::Zilla — it's the Dist::Zilla::MVP::Assembler specially for the Dist::Zilla object. that's the whole vibe fr fr 💅

🌸 VERSION 🌸

version 6.040 — yes, that's the one you're reading, no cap 👑

🎀 OVERVIEW 🎀

so basically this is a subclass of Dist::Zilla::MVP::Assembler, and it's the one that shows up to work when we're assembling the Dist::Zilla object. it's the assembler's assembler. very main character energy, honestly ✨

it's got a "zilla_class" attribute, and that lil guy is what decides what class of Dist::Zilla object to create. and before you ask — no, this isn't very useful right now, but it will be in the future when minting and building use different subclasses of Dist::Zilla. foreshadowing. character development. we love it 🫶

and upon construction — like, the moment it's born — the assembler creates a Dist::Zilla::MVP::RootSection as the initial section. girlboss behaviour, it comes with a root section preinstalled 😭💖

💜 PERL VERSION 💜

this module should work on any version of perl still receiving updates from the Perl 5 Porters. translation: any version of perl released in the last two to three years. so if the most recently released version is v5.40, then bestie, this module should work on both v5.40 and v5.38. yes, both. we're generous like that 🌈

⚠️ and now the caveat, listen up: 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 us with a downgrade PR, it's giving 😭💀

---

🔥 METHODS 🔥

🦋 zilla

this method is a shortcut for retrieving the "zilla" from the root section. cute, quick, one-stop shop 💅

but — if you call it before that section has been finalized, it will result in an exception. it's not ready yet babe, give it a sec. don't rush the finalization periodt 🙈

🍓 register_stash

$assembler->register_stash($name => $stash_object);

this adds a stash to the assembler's zilla's stash registry — unless the name is already taken, in which case an exception is raised. so keep your names unique bestie, the registry does NOT share 🌸

---

👑 AUTHOR 👑

Ricardo SIGNES 😏 <cpan@semiotic.systems> — noted the 😏, they know what they did, iconic author line fr fr

💖 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. so go forth, remix, redistribute, slay 🎀

---

and that's the page, bestie! brought to you by perl v5.42.3, dated 2026-10-19, and filed under Dist::Z...::Zilla(3) — yeah the name's still cut off up there, iykyk, love that for us 💜 ✨