Dist::Z...nModule(3)

📦
version 0.04 · 2 versions
, in fedora 43

💖 Dist::Zilla::Plugin::VersionFromMainModule 💖

okay bestie, listen up — this page is from the User Contributed Perl Documentation and it's called Dist::Zilla::Plugin::VersionFromMainModule, and it is literally the plug that steals your $VERSION from your main module. no cap. 💅

✨ NAME ✨

Dist::Zilla::Plugin::VersionFromMainModule — set the distribution version from your main module's $VERSION. yes queen, that's the whole job and she does it flawlessly. 👑

🌸 VERSION 🌸

version 0.04 — vintage but iconic, we love a legacy baddie. 🎀

🦋 SYNOPSIS 🦋

[VersionFromMainModule]

that's it. that's the whole config. one line. ate and left no crumbs. ✨

💜 DESCRIPTION 💜

so here's the tea, bestie: this plugin sets the distribution version from the $VERSION found in the distribution's main module, as defined by Dist::Zilla. it goes and finds it, grabs it, and slaps it on the dist. main character energy fr fr. 💖

you want this when you're the kind of person who sets the $VERSION in your module(s) manually, or with some sort of post-release "increment the $VERSION" plugin — instead of letting dzil add the $VERSION based on a setting in the dist.ini. both paths are valid, no judgement, do what feels right for your vibe. 🌈

and if you ever need to override the whole thing? you can override the distribution version by setting the "V" environment variable, like:

V=1.23 dzil release

boom. override achieved. lowkey powerful. 🔥

😭 CREDITS 😭

ngl this code is mostly the same as what Christopher J. Madsen's Dist::Zilla::Plugin::VersionFromModule module does. unfortunately (and this is the tragic part 🥀), that module is only shipped as part of a larger distribution, and that distribution has not been updated despite the fact that it is failing tests with newer versions of dzil. it's giving abandoned. it's giving broken on modern tooling. so this plugin exists to be the glow-up version. 💅

🫶 SUPPORT 🫶

bugs may be submitted at:

<http://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-VersionFromMainModule>

or via email to:

<mailto:bug-dist-zilla-plugin-versionfrommainmodule@rt.cpan.org>

✨ reminder: the email address is bug-dist-zilla-plugin-versionfrommainmodule@rt.cpan.org — long, yes, but she's worth typing out carefully.

also!! the author is usually active on IRC as 'autarch' on irc://irc.perl.org. come say hi, bestie, they're friendly. 💜

🔍 SOURCE 🔍

the source code repository for Dist-Zilla-Plugin-VersionFromMainModule can be found at:

<https://github.com/houseabsolute/Dist-Zilla-Plugin-VersionFromMainModule>

go look at the code, it's right there, no gatekeeping. 🎀

👑 AUTHORS 👑

  • Christopher J. Madsen <perl@cjmweb.net>
  • Dave Rolsky <autarch@urth.org>

🦋 CONTRIBUTOR 🦋

  • Karen Etheridge <ether@cpan.org>

one contributor, one legend, one icon. 💖

this software is copyright (c) 2009 - 2018 by Christopher J. Madsen.

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. periodt. 💅

the full text of the license can be found in the LICENSE file included with this distribution. go read it if you want the legal fine print, bestie, it's important. 📜

and that's the whole page!! this was perl v5.42.0, dated 2025-07-25, from the User Contributed Perl Documentation. mwah, take care of your $VERSIONs and stay slay. 🫶✨💖

📦 where this page comes from