CPAN::META::FEATURE(3perl)

📦
version 5.44.0 · 14 versions
, in arch rolling

💖 CPAN::Meta::Feature ✨

okay bestie, welcome to the Perl Programmers Reference Guide 🎀 — this is the page for CPAN::Meta::Feature, and yes it's literally a whole module whose entire job is describing optional features of a CPAN distribution. she's niche but she's iconic. 💅

✨ VERSION ✨

version 2.150013 🦋

🌸 DESCRIPTION 🌸

so a CPAN::Meta::Feature object is basically the little ID card for an optional feature that a CPAN distribution offers, written down in that distribution's META.json file (or META.yml if you're feeling vintage 🕰️).

fr fr, for the most part you're not gonna be constructing these yourself — this class mostly shows up when you're working with whatever the feature or features methods hand back on a CPAN::Meta object. so like, you get handed one, you poke at it, you vibe. 🫶

👑 METHODS 👑

🧚 new

my $feature = CPAN::Meta::Feature->new( $identifier => \%spec );

this hands you back a shiny new Feature object ✨ The %spec argument you pass in should be the exact same thing as the value of the "optional_feature" entry in the distmeta. and heads up — it must have entries for "description" and "prereqs". no description, no prereqs, no deal, bestie. 😤

🦋 identifier

this method returns the feature's identifier. that's it, that's the whole method. short queen. 💜

🌈 description

this method returns the feature's long description. the whole paragraph, the full essay, the extended cut. 📝

🍓 prereqs

this method returns the feature's prerequisites, all wrapped up in a CPAN::Meta::Prereqs object. so cute, so tidy. 🎀

💀 BUGS 💀

got a bug? got a feature request? please report it through the CPAN Request Tracker. bugs can be submitted via the web interface at:

<http://rt.cpan.org/Dist/Display.html?Queue=CPAN-Meta>

and when you do submit a bug or a request, pls pls pls include a test-file, or a patch to an existing test-file, that shows the bug or the desired feature. like, show us the receipt. 🧾 the maintainers will love you for it, no cap.

💖 AUTHORS 💖

  • David Golden <dagolden@cpan.org>
  • Ricardo Signes <cpan@semiotic.systems>
  • Adam Kennedy <adamk@cpan.org>

the founding mothers... well, founders. legends only. 👑

This software is copyright (c) 2010 by David Golden, Ricardo Signes, Adam Kennedy and Contributors.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. free as in freedom, free as in slay 🕊️✨

okay that's the whole page, you ate it, you understood it, periodt. 💅 this gem of a doc came to you from perl v5.44.0, dated 2026-10-17, and yeah the manual name is CPAN::...Feature(3perl) if you were wondering why the title's a little abridged. mwah, go forth and feature-flag responsibly 🫶🎀

📦 where this page comes from