MetaCP...vorite(3pm)

💖 MetaCPAN::Client::Favorite — the manual page, but make it cute 💖

okay bestie, gather round, because we're looking at MetaCPAN::Client::Favorite(3pm) from the User Contributed Perl Documentation crew. yes, that's a Perl module, and yes, it's giving favorite entity object energy. let's get into it 💅

✨ NAME ✨

MetaCPAN::Client::Favorite — it's a Favorite data object, periodt. that's the whole name, that's the whole vibe 🎀

🌸 VERSION 🌸

version 2.044000 — this is the one we're working with, no cap 💜

🦋 SYNOPSIS 🦋

okay so here's how you actually use this thing, literally copy-paste adjacent:

# Query favorites for a given distribution:

my $favorites = $mcpan->favorite( {
    distribution => 'Moose'
} );

# Total number of matches ("how many favorites does the dist have?"):

print $favorites->total;

# Iterate over the favorite matches

while ( my $fav = $favorites->next ) { ... }

so you query favorites for a given distribution, you ask for the total number of matches (as the comment says, that's the "how many favorites does the dist have?" question 💭), and then you can iterate over the favorite matches one at a time. three moves. slay. 🔥

🌈 DESCRIPTION 🌈

it's a MetaCPAN favorite entity object. that's it bestie, that's the description, it's a whole entity object and it is iconic for it ✨

👑 ATTRIBUTES 👑

these are the fields you get to play with, each one a little treasure 🫶

🍓 date

an ISO8601 datetime string like "2016-11-19T12:41:46" that tells you when the favorite was created ⏰ lowkey useful for knowing exactly when someone decided to stan.

💜 user

the user ID (not the PAUSE ID, okay, do not mix those up) of the person who favorited the thing in question. so this is who did the favoriting 🙈

🧚 release

the release that was favorited. yes. the release. favorited. that one 🎀

⭐ id

the favorite ID. that's its little unique name tag 💫

🌸 author

the PAUSE ID of the author whose release was favorited. (here's where the PAUSE ID lives, bestie — remember, user up there is not this 👀)

🦋 distribution

the distribution that was favorited. the dist. the whole point of the favoriting 💖

🌟 AUTHORS 🌟

the legends who made this happen, show some respect:

• Sawyer X <xsawyerx@cpan.org>
• Mickey Nasriachi <mickey@cpan.org>

💌 COPYRIGHT AND LICENSE 💌

This software is copyright (c) 2016 by Sawyer X.

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

---

ngl bestie, that license part is basically the "you may do the thing, just follow Perl's rules" speech, and it applies to the same terms as the Perl 5 programming language system itself, so don't get creative with it 💅

okay and that's the whole page, we ate, no crumbs left. this manual page came to you via perl v5.40.1, dated 2026-07-05, from the MetaCP...vorite(3pm) page itself — mwah, bye bestie! 💖✨🎀🦋🌸🫶