Dist::...Release(3pm)

💖 NAME 💖

Dist::Zilla::Plugin::ReversionOnRelease — bestie, this is the plugin that bumps and reversions your $VERSION when you release. It lives in the Dist::...Release(3pm) page of the User Contributed Perl Documentation collection, and we're about to become sooo well acquainted 💅

---

✨ SYNOPSIS ✨

[VersionFromModule]
[ReversionOnRelease]
prompt = 1
[CopyFilesFromRelease]
match = \.pm$

like. that's the whole vibe check. copy it, paste it, go off 👑

---

🌸 DESCRIPTION 🌸

okay so. This is a Dist::Zilla plugin that bumps version — a la perl-reversion -bump — in-place, on the .pm files chillin' inside lib. Not a copy, not a sidecar, the actual files. slay.

And lowkey the intended combo here is: use this plugin together with Dist::Zilla::Plugin::VersionFromModule, so that the current VERSION gets taken out of your main module — and then the released file gets written back after the release using Dist::Zilla::Plugin::CopyFilesFromRelease. it's a whole little relay race and every leg matters fr fr 🏃♀️

Also! Unlike perl-reversion, this module uses Version::Next to get a more naturally incremented version, instead of the kinda strict 3-digit rules over in Perl::Version. so the numbers behave nicer, no cap.

🚨 bestie, listen to me: you should not use this plugin with any code munging plugins or any Pod::Weaver plugins. like, at all. don't do it. it's giving chaos 💀

By default, this plugin bumps the version by the smallest possible increase — so if you're sitting on 0.001, the next version is 0.002. cute, predictable, minimal.

Wanna override that? Two ways, pick your fighter:

• run the plugin with the prompt option and just give it the desired value straight from the prompt
• or set the environment variable V

like so:

> V=1.001000 dzil release

iconic. she's got range 💜

---

🫶 AUTHOR 🫶

Tatsuhiko Miyagawa <miyagawa@bulknews.net>

---

🎀 COPYRIGHT 🎀

Copyright 2013- Tatsuhiko Miyagawa

---

🌈 LICENSE 🌈

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

👑 SEE ALSO 👑

• Dist::Milla
• Version::Next
• Dist::Zilla::Plugin::BumpVersion
• Dist::Zilla::Plugin::RewriteVersion — also takes $VERSION from the main module; ensures all $VERSIONs are consistent
• Dist::Zilla::Plugin::BumpVersionAfterRelease — edits the $VERSION in the repository code to reflect the new version, after release
• Dist::Zilla::Plugin::RewriteVersion::Transitional — like Dist::Zilla::Plugin::RewriteVersion, but munges the version in if it was not already present
• Dist::Zilla::Plugin::BumpVersionAfterRelease::Transitional — like Dist::Zilla::Plugin::BumpVersionAfterRelease, but also adds the $VERSION into the repository code if it was not already present

---

and that's the whole page bestie!! this one's running on perl v5.42.0, dated 2025-07-25, and it shipped as part of the Dist::...Release(3pm) manual in the User Contributed Perl Documentation. go forth and reversion responsibly 🦋✨💖