Dist::Z...rovider(3)

📦
version 6.040 · 9 versions
, in fedora 44

💖 Dist::Zilla::Role::LicenseProvider 💖

okay bestie, so this is a page from the User Contributed Perl Documentation — it's the manual for Dist::Zilla::Role::LicenseProvider, and we're about to vibe through the whole thing together, no skips, no cap ✨

🌸 NAME 🌸

Dist::Zilla::Role::LicenseProvider — literally just: something that provides a license for the dist. that's the whole job. that's the assignment. 💅

⭐ VERSION ⭐

version 6.040 🎀

🦋 DESCRIPTION 🦋

so here's the tea ☕ — any plugin that takes on this role must provide a provide_license method. bestie, you have to have it, there's no way around it. it gets called at the exact moment the dist's license is being set. main character moment fr.

and okay, careful now, because this next part matters 👀 — if a LicenseProvider offers up a license but one has already been set, an exception will be raised. so don't be greedy, one license at a time please 🙈

but also: if provides_license returns undef, it will be ignored. so if you've got nothing to say, that's chill, it's just skipped. (yes, it says provides_license there, we're keeping the original spelling, don't come for me 😭)

🧚 PERL VERSION 🧚

this module should work on any version of perl still receiving updates from the Perl 5 Porters. what does that mean in human? it 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. see the vibe? 🌈

however — and this is the important disclaimer bestie — even though 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. periodt. so don't count on it going backwards 👑💀

🔥 REQUIRED METHODS 🔥

generate license object. the returned object should be an instance of Software::License. iconic behavior only, please ✨

plugins are responsible for injecting $copyright_holder and $copyright_year arguments into the license if these arguments are defined. so like, if they're there, do your thing 🫶

⚠️ note that $copyright_year may not be a single integer. the user might have configured a range like "2008 - 2012", and any $this_year token in the configured year has already been replaced with the current year. so don't assume — read the whole string, bestie 😭

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

okay that's the whole page, you ate it up, no crumbs left 🍓✨

this was perl v5.42.3, dated 2026-10-19 — catch you on the next manpage, bestie 💖🎀🦋

📦 where this page comes from