NAME

Regexp::Pattern::Perl::Module - Regexp patterns related to Perl modules

VERSION

This document describes version 0.007 of Regexp::Pattern::Perl::Module (from Perl distribution Regexp-Pattern-Perl), released on 2022-07-30.

SYNOPSIS

use Regexp::Pattern; # exports re()
my $re = re("Perl::Module::perl_modname");

DESCRIPTION

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

REGEXP PATTERNS

  • perl_modname

    Perl module name e.g. Foo::Bar.

    Examples:

    Example #1.

    "" =~ re("Perl::Module::perl_modname");  # DOESN'T MATCH

    Example #2.

    "Foo::Bar" =~ re("Perl::Module::perl_modname");  # matches

    Example #3.

    "Foo::0Bar" =~ re("Perl::Module::perl_modname");  # matches

    Example #4.

    "0Foo::Bar" =~ re("Perl::Module::perl_modname");  # DOESN'T MATCH

    Example #5.

    "Foo/Bar" =~ re("Perl::Module::perl_modname");  # DOESN'T MATCH
  • perl_modname_pm

    Perl module name in Foo/Bar.pm.

    Examples:

    Example #1.

    "" =~ re("Perl::Module::perl_modname_pm");  # DOESN'T MATCH

    Example #2.

    "Foo/Bar.pm" =~ re("Perl::Module::perl_modname_pm");  # matches

    Example #3.

    "Foo/0Bar.pm" =~ re("Perl::Module::perl_modname_pm");  # matches

    Example #4.

    "0Foo/Bar.pm" =~ re("Perl::Module::perl_modname_pm");  # DOESN'T MATCH

    Example #5.

    "Foo/Bar" =~ re("Perl::Module::perl_modname_pm");  # DOESN'T MATCH

    Example #6.

    "Foo::Bar" =~ re("Perl::Module::perl_modname_pm");  # DOESN'T MATCH
  • perl_modname_with_optional_args

    Examples:

    Example #1.

    "" =~ re("Perl::Module::perl_modname_with_optional_args");  # DOESN'T MATCH

    Example #2.

    "Foo::Bar" =~ re("Perl::Module::perl_modname_with_optional_args");  # matches

    Example #3.

    "Foo::0Bar" =~ re("Perl::Module::perl_modname_with_optional_args");  # matches

    Example #4.

    "0Foo::Bar" =~ re("Perl::Module::perl_modname_with_optional_args");  # DOESN'T MATCH

    Example #5.

    "Foo/Bar" =~ re("Perl::Module::perl_modname_with_optional_args");  # DOESN'T MATCH

    Example #6.

    "Foo::Bar=" =~ re("Perl::Module::perl_modname_with_optional_args");  # matches

    Example #7.

    "Foo::Bar=a" =~ re("Perl::Module::perl_modname_with_optional_args");  # matches

    Example #8.

    "Foo::Bar=a,b,c" =~ re("Perl::Module::perl_modname_with_optional_args");  # matches

    Example #9.

    "Foo::Bar=a=1" =~ re("Perl::Module::perl_modname_with_optional_args");  # matches

    Example #10.

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

HOMEPAGE

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

SOURCE

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

SEE ALSO

Other Regexp::Pattern::Perl::* modules.

Regexp::Pattern

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

AUTHOR

perlancar <perlancar@cpan.org>

CONTRIBUTING

To contribute, you can send patches by email/via RT, or send pull requests on GitHub.

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

% prove -l

If you 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.

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.

BUGS

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

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.