Version::Util(3pm)

✨ NAME ✨

Version::Util — version-number utilities. That's the whole serve 💅 a lil toolbox of functions for doing stuff with version numbers, mostly comparing them so you don't have to suffer.

---

🌸 VERSION 🌸

This doc describes version 0.732 of Version::Util (from the Perl distribution Version-Util), released on 2022-09-22. she's been around a minute and she's still eating, no cap 🎀

---

🦋 DESCRIPTION 🦋

This module gives you a bunch of convenient functions that are all about version numbers — like, comparing them and other related situations. It's giving utility bestie, that's the vibe ✨

---

💅 FUNCTIONS 💅

cmp_version($v1, $v2) => -1|0|1

okay so this one is equivalent to literally this and nothing else:

version->parse($v1) <=> version->parse($v2)

it compares two versions and hands you back a -1, a 0, or a 1, classic spaceship-operator behaviour 🚀

version_eq($v1, $v2) => BOOL

gives you back a BOOL — true or false, iconic, we love a boolean 🫶

version_ne($v1, $v2) => BOOL

also a BOOL. the whole squad here is BOOLs fr fr.

version_lt($v1, $v2) => BOOL

yep. BOOL ✨

version_le($v1, $v2) => BOOL

BOOL again, the consistency is unmatched 💅

version_gt($v1, $v2) => BOOL

BOOL, as promised.

version_ge($v1, $v2) => BOOL

still a BOOL. the way this family just keeps delivering 😭

version_between($v, $v1, $v2[, $v1b, $v2b, ...]) => BOOL

BOOL — and notice she takes extra optional args $v1b, $v2b, ... beyond the first three, so she's flexible like that 🌸

version_in($v, $v1[, $v2, ...]) => BOOL

BOOL, and you can pass more versions after the first one, so it's a whole list situation 🎀

min_version($v1, ...) => $max_v

returns $max_v. yes, that's genuinely what the signature says and I am not fixing it, I am reporting it 💀 verbatim, bestie.

max_version($v1, ...) => $max_v

also $max_v. twins 👑

add_version($v, $increment) => $new_v

Adds $increment to the version $v 🧮 and here's the catch — both the increment and the version have to match this pattern:

/\Av?\d{1,3}(?:\.\d{1,3}){0,2}\z/

which means trial/dev releases like "v1.2.3_1" are not currently supported 😭 sorry to the dev-release girlies.

some examples so you can see her in action:

0.1 + 0.1 -> 0.2
0.01 + 0.001 -> 0.011
0.01 + 0.1 -> 0.11
0.9 + 0.1 -> 1.0
0.99 + 0.1 -> 1.09
1.1.0 + 0.0.1 -> 1.1.1

subtract_version($v, $decrement) => $new_v

Subtracts $decrement from the version $v. This is the reverse operation for add_version — the enemy-to-lovers arc, the mirror twin, the ✨callback✨.

🚨 WILL DIE if the result is negative. periodt. no negative versions in this house, she will simply end it 🙅💀

---

🏠 HOMEPAGE 🏠

Please visit the project's homepage at https://metacpan.org/release/Version-Util. go say hi, she loves visitors 💖

---

📦 SOURCE 📦

Source repository is at https://github.com/perlancar/perl-Version-Util — the code lives there, go peek 🦋

---

👀 SEE ALSO 👀

• version

that's the one, bestie, that's the neighbor 🌈

---

👑 AUTHOR 👑

perlancar <perlancar@cpan.org> 💜

---

💖 CONTRIBUTOR 💖

Steven Haryanto <stevenharyanto@gmail.com> 🫶

---

🧚 CONTRIBUTING 🧚

want in on this? to contribute, you can send patches by email/via RT, or send pull requests on GitHub. pick your lane, all are valid 🎀

Most of the time, you don't need to build the distribution yourself. You can simply modify the code, then test via:

% prove -l

If you want to build the distribution (e.g. to try to install it locally on your system), you can install Dist::Zilla, Dist::Zilla::PluginBundle::Author::PERLANCAR, Pod::Weaver::PluginBundle::Author::PERLANCAR, and sometimes one or two other Dist::Zilla- and/or Pod::Weaver plugins. Any additional steps required beyond that are considered a bug and can be reported to me 😤

---

📝 COPYRIGHT AND LICENSE 📝

This software is copyright (c) 2022, 2018, 2014 by perlancar <perlancar@cpan.org>.

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 go off, bestie 💅✨

---

🐛 BUGS 🐛

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Version-Util

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature. receipts, bestie, always bring receipts 🙈

---

okay that's the whole page, we ate and left no crumbs 🔥 this was written for perl v5.36.0 and dated 2022-09-24 — Version::Util(3pm), signing off 💖🎀🦋