NAME

Regexp::Pattern::CPAN - Regexp patterns related to CPAN

VERSION

This document describes version 0.005 of Regexp::Pattern::CPAN (from Perl distribution Regexp-Pattern-CPAN), released on 2021-07-27.

SYNOPSIS

use Regexp::Pattern; # exports re()
my $re = re("CPAN::pause_id");

DESCRIPTION

Regexp::Pattern is a convention for organizing reusable regex patterns.

REGEXP PATTERNS

• pause_id

  PAUSE author ID, or PAUSE ID for short.

  I'm not sure whether PAUSE allows digit for the first letter. For safety I'm assuming no.

  Examples:

  Example #1.

  "PERLANCAR" =~ re("CPAN::pause_id");  # matches

  Only allows uppercase.

  "perlancar" =~ re("CPAN::pause_id");  # DOESN'T MATCH

  too short.

  "A" =~ re("CPAN::pause_id");  # DOESN'T MATCH

  contains whitespace.

  "PERL ANCAR" =~ re("CPAN::pause_id", {-anchor=>1});  # DOESN'T MATCH

  too long.

  "RANDALSCHWARTZ" =~ re("CPAN::pause_id", {-anchor=>1});  # DOESN'T MATCH

• release_tarball_filename

  Tags: capturing

  Proper filename of a typical distribution release tarball.

  Examples:

  Example #1.

  "Acme-CPANModulesBundle-Import-PerlAdvent-2000-0.001.tar.gz" =~ re("CPAN::release_tarball_filename", {-anchor=>1});  # matches

  v prefix before version number allowed.

  "Acme-CPANModulesBundle-Import-PerlAdvent-2000-v0.001.tar.gz" =~ re("CPAN::release_tarball_filename", {-anchor=>1});  # matches

  No distribution name.

  "0.001.tar.gz" =~ re("CPAN::release_tarball_filename", {-anchor=>1});  # DOESN'T MATCH

  Unfortunately, numeric namespace name gets mistaken as version number.

  "Acme-CPANModulesBundle-Import-PerlAdvent-2000.tar.gz" =~ re("CPAN::release_tarball_filename", {-anchor=>1});  # matches

  No version number.

  "Acme-CPANModulesBundle-Import-PerlAdvent.tar.gz" =~ re("CPAN::release_tarball_filename", {-anchor=>1});  # DOESN'T MATCH

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Regexp-Pattern-CPAN.

SOURCE

Source repository is at https://github.com/perlancar/perl-Regexp-Pattern-CPAN.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Regexp-Pattern-CPAN

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.

SEE ALSO

Regexp::Pattern::Perl

Regexp::Pattern

Some utilities related to Regexp::Pattern: App::RegexpPatternUtils, rpgrep from App::rpgrep.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2021, 2020, 2018, 2017 by 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.