MetaCP...Author(3pm)

📦
version 2.044000 · 10 versions
, in ubuntu stonking

💖 NAME 💖

okay bestie, welcome to MetaCPAN::Client::Author — it's An Author data object, and yes the manual page header is MetaCP...Author(3pm) from the User Contributed Perl Documentation, iconic naming, we move 💅

🦋 VERSION 🦋

version 2.044000 ✨

🌸 SYNOPSIS 🌸

the whole vibe in one line:

my $author = $mcpan->author('MICKEY');

look at her. she's perfect. no notes. 🎀

💜 DESCRIPTION 💜

literally just: a MetaCPAN author entity object. that's it. that's the description. she's a data object, she holds author info, she serves cunt (the cunt in question being structured metadata) 💀

✨ ATTRIBUTES ✨

this is the main character section, buckle up 🫶

🌈 pauseid

the author's pause id — a lil string situation, something like "MICKEY" or "XSAWYERX".

🌈 name

the author's full name, if they've provided it in their MetaCPAN profile. heads up bestie: this one may contain Unicode characters, so she's fancy ✨

🌈 ascii_name

an ASCII-only version of the author's full name, again only if they've provided that info in their MetaCPAN profile.

🌈 city

the author's city, if they've put it in their MetaCPAN profile.

🌈 region

the author's region, if they've put it in their MetaCPAN profile.

🌈 country

the author's country, if they've put it in their MetaCPAN profile.

🌈 updated

an ISO8601 datetime string like "2016-11-19T12:41:46" telling you when the author last updated their MetaCPAN profile. and no cap, this one is always provided, and it's always in UTC 🕐

🌈 dir

the author's CPAN directory — it's giving "id/P/PE/PERLER".

🌈 gravatar_url

the author's gravatar.com user URL, if they have one. this URL gets generated using PAUSEID@cpan.org. the way that works is honestly kind of cute.

🌈 user

the user's internal MetaCPAN id. very backstage-pass energy.

🌈 donation

this is an arrayref holding zero or more hashrefs. each hashref has exactly two keys, "name" and "id". the known names right now are "paypal", "wishlist", and "flattr". the id will be an appropriate id or URL for the thing in question.

this may be empty if the author hasn't provided this info in their MetaCPAN profile. empty arrayref, we've all been there 😭

for example:

[
    { "name" => "paypal",   "id" => "brian.d.foy@gmail.com" },
    { "name" => "wishlist", "id" => "http://amzn.com/w/4O7IX9ZNQJR" },
],

🌈 email

this is an arrayref of zero or more email addresses that the author added to their MetaCPAN profile. slight plot twist: this does not include the "AUTHOR@cpan.org" email address that literally every CPAN author has. so don't go looking for it here, bestie.

🌈 website

this is an arrayref of website URLs the author provided in their MetaCPAN profile.

🌈 profile

this is an arrayref of zero or more hashrefs. each hashref has two keys, "name" and "id". the names are things like "github" or "stackoverflow". the id will be an appropriate id for the site in question.

for example:

[
    { name => "amazon",        id => "B002MRC39U"  },
    { name => "stackoverflow", id => "brian-d-foy" },
]

this may be empty if the author hasn't provided this info in their MetaCPAN profile.

🌈 perlmongers

this is an arrayref of zero or more hashrefs. each hashref has two keys, "name" and "url". the names are things like "Minneapolis.pm".

this may be empty if the author hasn't provided this info in their MetaCPAN profile.

this is a hashref where the keys are a link type and the values are URLs. the currently known keys are:

  • cpan_directory — the author's CPAN directory.
  • cpantesters_reports — the author's CPAN Testers Reports page.
  • cpantesters_matrix — the author's CPAN Testers matrix page.
  • cpants — the author's CPANTS page.
  • metacpan_explorer — a link to the MetaCPAN explorer site pre-populated with a request for the author's profile. obsessed with the pre-population ngl.

🌈 blog

this is an arrayref of zero or more hashrefs. each hashref has two keys, "url" and "feed". for example:

{
    url  => "http://blogs.perl.org/users/brian_d_foy/",
    feed => "http://blogs.perl.org/users/brian_d_foy/atom.xml",
}

🌈 release_count

this is a hashref holding counts for various types of releases. the known keys are:

  • cpan — the total number of distribution uploads the author currently has on CPAN.
  • latest — the total number of unique distributions the author currently has on CPAN.
  • backpan-only — the number of distribution uploads currently only available via BackPAN. the backpan-only girls, we respect them.

🌈 extra

returns a hashref. the contents of this are entirely arbitrary and will vary by author. so like... good luck, it's a mystery box, it's giving unhinged 🎁

🎀 METHODS 🎀

💫 BUILDARGS

ensures format of the input. that's her whole job. she's the bouncer at the door making sure everything looks right 💅

💫 releases

my $releases = $author->releases();

this method returns a MetaCPAN::Client::ResultSet of MetaCPAN::Client::Release objects. it includes all of the author's releases with the "latest" status. only the latest ones, she's not doing archival work, periodt.

💫 metacpan_url

returns a link to the author's page on MetaCPAN. click it, go look at them, support your local CPAN author 🫶

👑 AUTHORS 👑

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

legends. both of them. no further questions ✨

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. so go ahead and remix it, bestie 🎨

okay that's the whole page!! and for the cute lil sign-off: this lovely document is running under perl v5.40.1, dated 2026-07-05, filed under MetaCP...Author(3pm). iykyk 🌈💖✨ slay, stay hydrated, and may your arrayrefs never be undef 🦋

📦 where this page comes from