Debian...::Perl(3pm)

🌸 Debian::Upstream::Metadata::Perl — debian/upstream/metadata for Perl modules 🌸

okay bestie, listen up, because this little Perl module is lowkey doing the most useful glow-up for your Debian packaging and nobody is talking about it 💅

It lives in the User Contributed Perl Documentation section of the manual, and it's giving "quiet helper that carries the whole team."

---

✨ SYNOPSIS ✨

Like, here's the vibe in code:

use Debian::Upstream::Metadata::Perl;

Debian::Upstream::Metadata::Perl->convert(
   CPAN::Meta->new('META.yaml'),
   'debian/upstream/metadata');

That's it. That's the whole flex. 🫶

---

💖 DESCRIPTION 💖

So. Debian::Upstream::Metadata::Perl is a helper module — a little one, a supportive bestie — that converts the data chillin' inside a CPAN::Meta object into a debian/upstream/metadata file. And it does it according to the UpstreamMetadata specification, no cap. ⭐

🚨 heads up though: upstream links will be switched to https URLs. Every single one. So if you were emotionally attached to your http, bestie, it's over. 🔥

---

🎀 EXPORTED FUNCTIONS 🎀

boil_down_meta (CPAN::Meta object)

Extracts the data from the CPAN::Meta argument and cleans it up — think of it as a little self-care routine for your metadata ✨🧖

It hands you back a hash ref stuffed with data that's actually suitable for Debian files. King behavior. 👑

---

👑 METHODS 👑

convert (CPAN::Meta object, filename)

The main character method. 🦋

Quick heads up: this one is not an exported function. You don't just call it and hope. Check the SYNOPSIS above for the exact way to summon it, bestie — cf. that, fr fr.

---

💜 SEE ALSO 💜

• CPAN::Meta::Spec — the spec, the blueprint, the lore 📜
• UpstreamMetadata — <https://wiki.debian.org/UpstreamMetadata> — the wiki page that tells you what all of this is even about 🌈

---

🌸 COPYRIGHT AND LICENSE 🌸

Shoutout to the iconic devs who made this happen:

• Copyright 2013-2026, gregor herrmann gregoa@debian.org
• Copyright 2016, Alex Muntada alexm@alexm.org
• Copyright 2022, Damyan Ivanov dmn@debian.org
• Copyright 2026, Dominique Dumont dod@debian.org

This program is free software and can be distributed under the same terms as Perl. periodt. 💅

---

and that's the whole page bestie!! 🎀 this one's perl v5.40.1, dated 2026-05-08, and it's filed under Debian...::Perl(3pm) in the User Contributed Perl Documentation — go forth and convert those metadata files, you absolute legend 🦋✨💖