Regexp:...rl::Dist(3)

💅 Regexp::Pattern::Perl::Dist(3) — the manual page, but make it make sense ✨

okay so bestie, this is the manual page for Regexp::Pattern::Perl::Dist(3), and honestly? it's short, it's sweet, and it does exactly one thing. let's get into it 🎀

---

🌸 NAME 🌸

Regexp::Pattern::Perl::Dist — regexp patterns related to Perl distribution. that's it. that's the whole vibe. it's giving "one job, done well" 💖

⭐ VERSION ⭐

this doc describes version 0.007 of Regexp::Pattern::Perl::Dist (from the Perl distribution Regexp-Pattern-Perl), released on 2022-07-30. lock it in 🗓️

🦋 SYNOPSIS 🦋

the whole flex is like three lines, no cap:

use Regexp::Pattern; # exports re()
my $re = re("Perl::Dist::perl_distname");

that's the entire flow. use it, call re() on the pattern name, get your regex. slay ✨

💜 DESCRIPTION 💜

Regexp::Pattern is a convention for organizing reusable regex patterns. that's the concept, that's the whole point — reusable patterns, organized, not copy-pasted into seventeen different files like some kind of chaos gremlin 🙈

🔥 REGEXP PATTERNS 🔥

perl_distname

this is the one pattern in the house, and here's the receipts 💅

Examples:

Example #1.

"" =~ re("Perl::Dist::perl_distname");  # DOESN'T MATCH

Example #2.

"Foo-Bar" =~ re("Perl::Dist::perl_distname");  # matches

Example #3.

"Foo-0Bar" =~ re("Perl::Dist::perl_distname");  # matches

Example #4.

"0Foo-Bar" =~ re("Perl::Dist::perl_distname");  # DOESN'T MATCH

Example #5.

"Foo::Bar" =~ re("Perl::Dist::perl_distname");  # DOESN'T MATCH

so like, dash yes, colon no, leading digit no, empty string absolutely not. the vibe check is thorough 👑

🌈 HOMEPAGE 🌈

please visit the project's homepage at <https://metacpan.org/release/Regexp-Pattern-Perl>. go say hi 🫶

🧚 SOURCE 🧚

source repository is at <https://github.com/perlancar/perl-Regexp-Pattern-Perl>. the code lives there, bestie 🍓

👑 SEE ALSO 👑

• other "Regexp::Pattern::Perl::*" modules. the whole family, iconic 💖
• Regexp::Pattern
• some utilities related to Regexp::Pattern: App::RegexpPatternUtils, rpgrep from App::rpgrep.

🎀 AUTHOR 🎀

perlancar <perlancar@cpan.org> — main character energy fr fr 💜

🌸 CONTRIBUTING 🌸

to contribute, you can send patches by email/via RT, or send pull requests on GitHub. all routes welcome 🫶

most of the time, you don't need to build the distribution yourself. you can simply modify the code, then test via:

% prove -l

literally just that. prove -l, you're golden ✨

if you do want to build the distribution (e.g. to try to install it locally on your system), you can install Dist::Zilla, Dist::Zilla::PluginBundle::Author::PERLANCAR, and sometimes one or two other Dist::Zilla plugin and/or Pod::Weaver::Plugin. any additional steps required beyond that are considered a bug and can be reported to me. so if it needs extra steps? that's a bug, not a you problem 🔥

💅 COPYRIGHT AND LICENSE 💅

this software is copyright (c) 2022, 2020 by perlancar <perlancar@cpan.org>.

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, go off 💖

💀 BUGS 💀

please report any bugs or feature requests on the bugtracker website <https://rt.cpan.org/Public/Dist/Display.html?Name=Regexp-Pattern-Perl>. they will see it 👀

when submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature. receipts are required, bestie — no vague "it's broken" energy 🙈

---

and that's the whole page!! 🎉 cute lil sign-off: this was perl v5.32.1, dated 2022-09-26, rendering Regexp:...rl::Dist(3) — you're officially caught up, go be iconic with your regexes 🦋💜