URI::P...L::Util(3pm)

💖 URI::PackageURL::Util 💖

okay bestie, so this page is from the User Contributed Perl Documentation and it's literally the URI::P...L::Util(3pm) situation — yes the name has dots in it, that's the vibe, iykyk ✨

---

✨ NAME ✨

URI::PackageURL::Util — the utility for URI::PackageURL 🎀

---

🌸 SYNOPSIS 🌸

use URI::PackageURL::Util qw(purl_to_urls);

$urls = purl_to_urls('pkg:cpan/GDT/URI-PackageURL@2.25');

$filename = basename($urls->{download});
$ua->mirror($urls->{download}, "/tmp/$filename");

---

🦋 DESCRIPTION 🦋

URL::PackageURL::Util is the utility package for URL::PackageURL. (yes those are the names, don't @ me, I'm reporting them exactly as they are 💅)

🍓 EXPORTED FUNCTIONS 🍓

💜 purl_types

use URI::PackageURL::Util qw(purl_types);
@types = purl_types();

Returns the list of known PURL types. that's it, that's the whole job, and she does it beautifully 👑

💜 purl_to_urls

use URI::PackageURL::Util qw(purl_to_urls);
$urls = purl_to_urls($purl_string // URI::PackageURL->new(...));

Converts the given Package URL string or a URI::PackageURL instance, and hands back a hash with "repository" and/or "download" URL. iconic behavior, no notes. 🌈

NOTE: This utility support few PURL types — "bitbucket", "cargo", "composer", "cpan", "docker", "gem", "github", "gitlab", "luarocks", "maven", "npm", "nuget", "pypi".

here's the whole rundown of which type gives you what, bestie — repository vs download, one by one, zero gatekeeping:

• bitbucket — Repository: YES · Download (*): YES
• cargo — Repository: YES · Download (*): YES
• composer — Repository: YES · Download (*): NO
• cpan — Repository: YES · Download (*): YES
• docker — Repository: YES · Download (*): NO
• gem — Repository: YES · Download (*): YES
• generic — Repository: NO · Download (*): YES (**)
• github — Repository: YES · Download (*): YES
• gitlab — Repository: YES · Download (*): YES
• luarocks — Repository: YES · Download (*): NO
• maven — Repository: YES · Download (*): YES
• npm — Repository: YES · Download (*): YES
• nuget — Repository: YES · Download (*): YES
• pypi — Repository: YES · Download (*): NO

the little asterisks mean things, don't skip them, they're important fr fr:

• (*) Only with version component
• (**) Only if download_url qualifier is provided

now watch her work 💅

$urls = purl_to_urls('pkg:cpan/GDT/URI-PackageURL@2.25');

print Dumper($urls);

# $VAR1 = {
#   'repository' => 'https://metacpan.org/release/GDT/URI-PackageURL-2.25',
#   'download'   => 'http://www.cpan.org/authors/id/G/GD/GDT/URI-PackageURL-2.25.tar.gz'
# };

---

🫶 SUPPORT 🫶

🙈 Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at <https://github.com/giterlizzi/perl-URI-PackageURL/issues>. You will be notified automatically of any progress on your issue. so like, you'll know, bestie, you won't be left on read. 📬

👑 Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

<https://github.com/giterlizzi/perl-URI-PackageURL>

git clone https://github.com/giterlizzi/perl-URI-PackageURL.git

---

⭐ AUTHOR ⭐

• Giuseppe Di Terlizzi <gdt@cpan.org>

---

💜 LICENSE AND COPYRIGHT 💜

This software is copyright (c) 2022-2026 by Giuseppe Di Terlizzi.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay. 🎀

---

💀 POD ERRORS 💀

Hey! The above document had some coding errors, which are explained below:

Around line 523:

=back without =over

not the =back without =over jumping out 😭 we still love her though

---

and that's the whole page, gorgeous — this was perl v5.40.1, dated 2026-01-31, filed under URI::P...L::Util(3pm). periodt. 💅✨