Dist::Z...rovider(3)

📦
version 6.040 · 9 versions
, in fedora 44

💖 NAME 💖

okay so bestie, welcome to the Dist::Zilla::Role::VersionProvider page — it's living in the User Contributed Perl Documentation manual, and it's all about something that provides a version number for the dist. that's it, that's the whole vibe. 🎀

✨ VERSION ✨

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

🦋 DESCRIPTION 🦋

so here's the tea: any plugin that implements this role must provide a provide_version method, and that method gets called when we're setting the dist's version. like, that's its whole moment, its main character moment, truly. 🌸

and listen, there's a rule here that you cannot skip:

  • if a VersionProvider offers up a version but one has already been set — an exception will be raised. 😭 deadass. no version drama allowed.
  • if provides_version returns undef? it will be ignored. swept under the rug. we move on. 🧹
ngl the mix of provide_version and provides_version is right there in the original lore — it's giving typo-adjacent, but we do not fix it, we do not question it, we simply report it faithfully. 💀

🌈 PERL VERSION 🌈

this module should work on any version of perl still receiving updates from the Perl 5 Porters. translation: anything released in the last two to three years, periodt. so if the most recently released version is v5.40, then babe this module should work on both v5.40 and v5.38. icon behaviour. ⭐

aaaand now the part where we're all a little sad 🙈 — even though it may work on older versions of perl, there's no guarantee that the minimum required version won't 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 get attached to an old perl, bestie 💔

👑 SEE ALSO 👑

Core Dist::Zilla plugins implementing this role: AutoVersion. that's the one. iykyk. 🫶

💜 AUTHOR 💜

Ricardo SIGNES 😏 <cpan@semiotic.systems> — the 😏 is part of the record, and honestly? iconic. 🔥

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. free as in yes bestie go off, legally sanctioned slay. 💅

okay and for the little sign-off moment: this whole page came to you via perl v5.42.3, dated 2026-10-19 🌸 🦋 — thanks for reading, mwah, go provide a version responsibly 💖

📦 where this page comes from