CPAN::META::REQUIREMENTS::RANGE(3pm)

💖 CPAN::Meta::Requirements::Range(3pm) — a whole vibe of version rules ✨

Okay so bestie, welcome to the CPAN::Meta::Requirements::Range page from the Perl Programmers Reference Guide — yes it's a mouthful, but it's also kinda iconic ngl. It's the manual page for a little object that holds version requirements for a CPAN dist. Periodt. 🌸

---

✨ NAME ✨

CPAN::Meta::Requirements::Range — literally just a set of version requirements for a CPAN dist. That's the whole thing. 🎀

---

🦋 VERSION 🦋

version 2.143 — this is the one, no cap.

---

🌈 SYNOPSIS 🌈

Here's the vibe check in code form, run this and slay:

use CPAN::Meta::Requirements::Range;

my $range = CPAN::Meta::Requirements::Range->with_minimum(1);

$range = $range->with_maximum('v2.2');

my $stringified = $range->as_string;

Look at her go. 💅

---

👑 DESCRIPTION 👑

So a CPAN::Meta::Requirements::Range object models a set of version constraints — like, exactly the kind you'd see specified in the META.yml or META.json files in CPAN distributions, and as defined by CPAN::Meta::Spec. The way this works is you just keep building it up: add more and more constraints, and it'll reduce them down to the simplest possible representation. It's giving minimalism. 🧚

And the best part? If you hand it constraints that are logically impossible, it identifies them immediately by throwing exceptions. Not me getting rejected in real time 😭 — but that's actually what you want, fr fr.

---

💜 METHODS 💜

🌸 with_string_requirement

$req->with_string_requirement('>= 1.208, <= 2.206');
$req->with_string_requirement(v1.208);

This method parses the passed-in string and adds the appropriate requirement. And yes, a version can be a Perl "v-string" — she's flexible like that. 💅 It understands version ranges as described in the "Version Ranges" in CPAN::Meta::Spec. For example:

1.3
>= 1.3
<= 1.3
== 1.3
!= 1.3
> 1.3
< 1.3
>= 1.3, != 1.5, <= 2.0

A version number without an operator is equivalent to specifying a minimum (>=). Extra whitespace is allowed — she's not gonna fight you over a couple of spaces, that's lowkey chill of her. ✨

🫶 with_range

$range->with_range($other_range)

This creates a new range object that is a merge of two others. Two ranges become one, it's giving friendship bracelet energy. 🎀

🍓 with_exact_version

$range->with_exact_version( $version );

This sets the version required to exactly the given version. No other version would be considered acceptable. It's giving "this or nothing" main character energy — no wiggle room, no compromises, absolutely zero. 👑

This method returns the version range object.

⭐ with_minimum

$range->with_minimum( $version );

This adds a new minimum version requirement. If the new requirement is redundant to the existing specification, this has no effect — it just politely does nothing, which is so mature of it.

Minimum requirements are inclusive. So $version is required, along with any greater version number. She said "this and up, no exceptions bestie." 💖

This method returns the version range object.

🦋 with_maximum

$range->with_maximum( $version );

This adds a new maximum version requirement. If the new requirement is redundant to the existing specification, this has no effect — same chill energy as above.

Maximum requirements are inclusive. No version strictly greater than the given version is allowed. So the ceiling is real, but you're allowed to touch it. 🙈

This method returns the version range object.

🌸 with_exclusion

$range->with_exclusion( $version );

This adds a new excluded version. For example, you might use these three method calls:

$range->with_minimum( '1.00' );
$range->with_maximum( '1.82' );

$range->with_exclusion( '1.75' );

So any version between 1.00 and 1.82 inclusive would be acceptable — except for 1.75. It's giving blocked. 💀 Not 1.75 specifically catching strays but okay, we've all been there.

This method returns the requirements object.

🎀 as_struct

$range->as_struct( $module );

This returns a data structure containing the version requirements. Lowkey important though: this should not be used for version checks — see accepts_module instead. Don't do it bestie, that's not what she's for. 🫶

💅 as_string

$range->as_string;

This returns a string containing the version requirements in the format described in CPAN::Meta::Spec. But listen: this should only be used for informational purposes — like error messages — and should not be interpreted or used for comparison. See accepts instead, that's the one that actually does the work. ✨

🔥 accepts

my $bool = $range->accepts($version);

Given a version, this method returns true if the version specification accepts the provided version. In other words, given:

'>= 1.00, < 2.00'

We will accept 1.00 and 1.75 but not 0.50 or 2.00. It's a whole vibe check and some versions are simply not passing it. 💀

🌈 is_simple

This method returns true if and only if the range is an inclusive minimum — that is, if their string expression is just the version number. Simple, clean, unbothered. The way she just is. ✨

---

💖 AUTHORS 💖

• David Golden <dagolden@cpan.org>
• Ricardo Signes <rjbs@cpan.org>

Legend behaviour, both of them. 👑

---

🌸 COPYRIGHT AND LICENSE 🌸

This software is copyright (c) 2010 by David Golden and 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 software, free spirit, we love to see it. 🫶

---

Alright bestie, that's the whole page — every method, every caveat, no skips, we ate and left no crumbs. 😌✨

🎀 perl v5.42.3 · 2026-11-03 · CPAN::Meta::Requirements::Range(3pm) 🎀

Byeee, go write some requirements that actually accept the right versions 💅💖