Dist::Z...Provider(3)

✨ NAME ✨

Dist::Zilla::Role::NameProvider β€” okay bestie, this is the thing that provides a name for the dist πŸ’– like, it's the role your plugin takes on when it wants to be the one to name the baby (the dist).


🌸 VERSION 🌸

version 6.040 πŸŽ€ periodt, that's the vibe, don't @ me.


πŸ¦‹ DESCRIPTION πŸ¦‹

So here's the tea, bestie πŸ“ β€” any plugin that implements this role has GOT to provide a provide_name method. That method is what gets called when the dist's name is being set. It's giving main character energy, it's giving "I am the one who names things" ✨.

Now, the rules, because there ARE rules πŸ™ˆ:

  • If a NameProvider offers up a name but one has already been set? Yeah no, an exception will be raised πŸ’€. You cannot just show up late with a name like that's allowed.
  • If provide_name returns undef, it's just ignored 🫢 like okay girl, no name today, we move on, no drama.

That's literally it. Simple. Iconic. No cap πŸ’….


πŸ’œ PERL VERSION πŸ’œ

This module should work on any version of perl still receiving updates from the Perl 5 Porters 🌈 β€” which basically means any perl released in the last two to three years. Like, if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38 πŸ‘‘.

Now the fine print, and I need you to actually read this part 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. So like... don't come for her with that patch, fr fr πŸ’€.

🧚 AUTHOR 🧚

Ricardo SIGNES 😏 <cpan@semiotic.systems> β€” yeah that emoji is IN the byline, we stan a legend who ships the vibe 🌟.


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, no crumbs left, we ate and left no notes πŸ’…βœ¨ β€” brought to you by perl v5.42.3, dated 2026-10-19, from the wilds of the Dist::Z...Provider(3) neighborhood 🌈🫢

πŸ“¦ where this page comes from