BackPA...Release(3pm)

💖 NAME 💖

BackPAN::Index::Release — it's literally one single release of a distribution, bestie. That's it, that's the whole vibe. ✨

---

🌸 SYNOPSIS 🌸

okay so here's how you actually use this thing:

my $b = BackPAN::Index->new();

# Find version 1.2.3 of Acme-Colour
my $release = $b->release("Acme-Colour", '1.2.3');

print "   CPANID: " . $release->cpanid . "\n";
print "     Date: " . $release->date . "\n";
print "     Dist: " . $release->dist . "\n";
print "Distvname: " . $release->distvname . "\n";
print " Filename: " . $release->filename . "\n";
print " Maturity: " . $release->maturity . "\n";
print "     Path: " . $release->path . "\n";
print "  Version: " . $release->version . "\n";

no cap, that's the whole flow. 🦋

---

🎀 DESCRIPTION 🎀

so like, BackPAN::Index::Release objects represent releases — the individual tarballs/zip files — of a distribution on BackPAN. 💅

for example (and I need you to picture this): Acme-Pony-1.2.3.tar.gz is a release of the Acme-Pony distribution. one tarball, one release, one icon. periodt. 👑

---

✨ METHODS ✨

💜 cpanid

my $cpanid = $release->cpanid;

gives you the PAUSE ID of whoever authored the release. the author's whole identity, in one little string. 🫶

💜 date

my $date = $release->date;

the date of the release, but make it UNIX epoch seconds. raw, unfiltered, integer-core. ⏰

💜 dist

my $dist_name = $release->dist;

the name of the distribution this release belongs to. which family this tarball is part of. 🧚

💜 distvname

my $distvname = $release->distvname;

returns the name of the distribution, then a hyphen, then the version. like a lil name tag with the version stitched on. 🌈

💜 filename

my $filename = $release->filename;

the filename of the release — and listen, it's just the file part. no directories, no drama, just the name. 🍓

💜 maturity

my $maturity = $release->maturity;

the maturity of the release. how grown-up is this tarball feeling today. 💀

💜 path

my $path = $release->path;

the full path on CPAN to the release. heads up though — this is a BackPAN::File object, not a plain string. it's giving object, not string. 🙈

💜 version

my $version = $release->version;

returns the version of the release. the number. the whole point. ⭐

💜 as_hash

my $data = $release->as_hash;

returns a hash ref containing all the data inside $release. everything, in one tidy lil bundle. obsessed. 💖

---

👑 AUTHOR 👑

Leon Brocard <acme@astray.com> and Michael G Schwern <schwern@pobox.com> — legends, both of them. 🫶

---

🌸 COPYRIGHT 🌸

Copyright (C) 2005-2009, Leon Brocard

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

---

🔥 SEE ALSO 🔥

• BackPAN::Index
• BackPAN::Index::Dist
• BackPAN::Index::File

go read those too, iykyk. ✨

---

okay bestie that's the whole page 💖 this was BackPA...Release(3pm) from the User Contributed Perl Documentation, running on perl v5.42.0, dated 2025-07-25 — slay, bye! 💅🎀