SYNOPSIS

     use Regexp::Pattern; # exports re()
    
     my $re = re('YouTube::video_id');
     say "ID does not look like a YouTube video ID" unless $id =~ /\A$re\z/;

SPECIFICATION VERSION

    0.1.0

DESCRIPTION

    Regexp::Pattern is a convention for organizing reusable regexp patterns
    in modules.

 Structure of an example Regexp::Pattern::* module

     package Regexp::Pattern::Example;

    # INSERT_BLOCK: lib/Regexp/Pattern/Example.pm def pod_verbatim

    A Regexp::Pattern::* module must declare a package global hash variable
    named %RE. Hash keys are pattern names, hash values are defhashes (see
    DefHash). At the minimum, it should be:

     { pat => qr/.../ },

    Regexp pattern should be written as qr// literal, or (less desirable)
    as a string literal. Regexp should not be anchored (qr/^...$/) unless
    necessary. Regexp should not contain capture groups unless necessary.

 Using a Regexp::Pattern::* module

    A Regexp::Pattern::* module can be used manually by itself, as it
    contains simply data that can be grabbed using a normal means, e.g.:

     use Regexp::Pattern::Example;
    
     say "Input does not match blah"
         unless $input =~ /\A$Regexp::Pattern::Example::RE{re1}{pat}\z/;

    Regexp::Pattern (this module) also provides re() function

FUNCTIONS

 get_re_pat

    Get a regexp pattern by name from a Regexp::Pattern::* module.

    Syntax:

     get_re_pat($name[, \%args ]) => $re

    $name is MODULE_NAME::PATTERN_NAME where MODULE_NAME is name of a
    Regexp::Pattern::* module without the Regexp::Pattern:: prefix and
    PATTERN_NAME is a key to the %RE package global hash in the module.

    Die when pattern by name $name cannot be found (either the module
    cannot be loaded or the pattern with that name is not found in the
    module).

 list_re_pat_modules

 list_re_pats

 re

    Shortcut for "get_re_pat". Exported by default.

SEE ALSO

    Regexp::Common. Regexp::Pattern is an alternative to Regexp::Common.
    Regexp::Pattern offers simplicity and lower startup overhead. Instead
    of a magic hash, you query available regexes using get_re_pat (shortcut
    re) and list_re_pats functions.

    Regexp::Common::RegexpPattern, a bridge module to use patterns in
    Regexp::Pattern::* modules via Regexp::Common.