MetaCPA...PI::File(3)

💖 MetaCPAN::API::File 💖

okay so bestie, welcome to MetaCPAN::API::File — it's a page from the User Contributed Perl Documentation manual, and it's literally just here to explain one little role that gives MetaCPAN::API the power to go grab file info for you. no cap. 🦋

---

✨ NAME ✨

MetaCPAN::API::File — file information for MetaCPAN::API 💅

---

🌸 VERSION 🌸

version 0.51

---

🎀 DESCRIPTION 🎀

so like, this role is the little helper that hands MetaCPAN::API the ability to fetch file information about modules and distribution releases. that's the whole vibe. it's giving backstage pass to the file tree. 🧚

---

👑 METHODS 👑

🌈 file

here's the main character. you call it like this:

my $result = $mcpan->file(
    author  => 'DOY',
    release => 'Moose-2.0201',
    path    => 'lib/Moose.pm',
);

orrr, if you're feeling minimal:

# or
my $result = $mcpan->file(
    author  => 'DOY',
    release => 'Moose-2.0201',
);

or, my personal fave, just yeet a name at it:

# or
my $result1 = $mcpan->file('MetaCPAN::API');
my $result2 = $mcpan->file( id => 'EMfoAvoYhHpUK8MVJSkm4KN5GmY' );

so what's actually happening? it searches MetaCPAN for a module or for one specific release, and then it hands you back the file/directory information. iconic. and heads up — if you leave path out, it goes and gets the info for the root directory instead. periodt. 💅

---

🫶 AUTHOR 🫶

Sawyer X <xsawyerx@cpan.org> — thank you for your service, legend 💜

---

💀 COPYRIGHT AND LICENSE 💀

this software is copyright (c) 2011 by Sawyer X.

it's free software, bestie — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so go wild, responsibly. ✨

---

okay and for the cute little sign-off at the bottom: this beauty lives at perl v5.42.0, dated 2025-07-25, filed under MetaCPA...PI::File(3) (yes the truncation is doing its thing, we respect it 🙈). mwah, go fetch some files 💖🎀🦋