Dist::Z...::Plugin(3)

📦
version 6.040 · 9 versions
, in fedora 44

💖 NAME 💖

okay so bestie, welcome to Dist::Zilla::Role::Plugin — it's a role and it's literally "something that gets plugged in to Dist::Zilla". that's the whole vibe. 🧩✨

(this is from the User Contributed Perl Documentation, page Dist::Z...::Plugin(3), if you were wondering where you even are rn 🫶)

🌸 VERSION 🌸

version 6.040 💅

✨ DESCRIPTION ✨

okay so here's the tea ☕: the Plugin role should be applied to all plugin classes. every single one. no skipping, bestie, we're not doing that today.

what it gives you is a few key methods and attributes that all plugins are gonna need. like, it's the little starter pack every plugin gets handed at the door. 🎀

🦋 PERL VERSION 🦋

this module should work on any version of perl still receiving updates from the Perl 5 Porters. what does that mean fr fr? it means it should work on any version of perl released in the last two to three years. so if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. both of them. living its best life. 🌈

⚠️ and here's the fine print, bestie: 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. that's just how it is. 💀

🎀 ATTRIBUTES 🎀

plugin_name 👑

the plugin name is generally determined when configuration is read. that's it, that's the lore. 📖

zilla 🦖

this attribute contains the Dist::Zilla object into which the plugin was plugged. so like, it's the whole party, and your plugin is the guest. 🎉

💅 METHODS 💅

log 📓

the plugin's log method delegates to the Dist::Zilla object's log in Dist::Zilla method — but only after including a bit of argument-munging. so it's not just a straight pass-through, there's a lil remix happening first. ✨

💜 AUTHOR 💜

Ricardo SIGNES 😏 <cpan@semiotic.systems>

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 documented with perl v5.42.3 and it's dated 2026-10-19 — iconic, no cap. go forth and plug in ur plugins 💖🌸✨

📦 where this page comes from