CPAN::C...::Parser(3)

💖 NAME 💖

okay so bestie, we're in CPAN::C...::Parser(3) territory — straight from the User Contributed Perl Documentation — and the actual module is CPAN::Changes::Parser. It's the parser for CPAN changelogs, and it's lowkey iconic. No cap. 💅

✨ SYNOPSIS ✨

Here's the vibe:

         my $parser = CPAN::Changes::Parser->new(
           version_like => qr/\{\{\$NEXT\}\}/,
           version_prefix => qr/=head\d\s+/,
         );

         my $changelog = $parser->parse_file('Changes', ':utf8');
         my $changelog = $parser->parse_string($content);

🦋 DESCRIPTION 🦋

It parses a file or a string into a CPAN::Changes object. Many forms of change log are accepted — yes, it's flexible like that. ✨

🎀 ATTRIBUTES 🎀

🌸 version_like 🌸

A regular expression for a token that will be accepted in place of a version number. For example, this could be set to qr/\{\{\$NEXT\}\}/ if the Dist::Zilla plugin [NextRelease] is managing the file. Obsessed with a configurable token, honestly. 💖

🌷 version_prefix 🌷

A regular expression for a prefix that will be matched before a version number. qr/=head\d\s+/ could be used if the change log is using Pod headings for the release headings. Pod-heading changelogs get a little prefix glow-up. 🫶

🔥 METHODS 🔥

💫 parse_file 💫

Parses a file into a CPAN::Changes object. Optionally accepts a string of layers to be used when reading the file. A string of layers, bestie — that's the optional bit. 🎀

⭐ parse_string ⭐

Parses a string into a CPAN::Changes object. Short and slay. 💅

👑 AUTHORS 👑

See CPAN::Changes for authors. Not me, I'm just the messenger. 😭

🌈 COPYRIGHT AND LICENSE 🌈

See CPAN::Changes for the copyright and license.

---

okay that's the whole page, bestie! 💖 This was perl v5.42.0, dated 2025-07-25, and it belongs to CPAN::C...::Parser(3) — go forth and parse those changelogs. 🦋🫶