NAME

Regexp::Pattern::Path - Regexp patterns related to path

VERSION

This document describes version 0.003 of Regexp::Pattern::Path (from Perl distribution Regexp-Pattern-Path), released on 2020-01-03.

SYNOPSIS


            
              
              use Regexp::Pattern; # exports re()
my $re = re("Path::dirname_unix");

DESCRIPTION

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

PATTERNS

dirname_unix

Valid directory name on Unix.

Just like filename_unix but allows '.' and '..' (although strictly speaking '.' and '..' are just special directory names instead of regular ones).

Examples:


            
              
              "foo" =~ re("Path::dirname_unix");  # matches
"foo bar" =~ re("Path::dirname_unix");  # matches

Too short.


            
              
              "" =~ re("Path::dirname_unix");  # doesn't match

Too long.


            
              
              "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" =~ re("Path::dirname_unix");  # doesn't match

contains slash.


            
              
              "foo/bar" =~ re("Path::dirname_unix");  # doesn't match

begins with slash.


            
              
              "/foo" =~ re("Path::dirname_unix");  # doesn't match

ends with slash.


            
              
              "foo/" =~ re("Path::dirname_unix");  # doesn't match

contains null (\0).


            
              
              "foo\0" =~ re("Path::dirname_unix");  # doesn't match
"." =~ re("Path::dirname_unix");  # matches
".." =~ re("Path::dirname_unix");  # matches
"..." =~ re("Path::dirname_unix");  # matches

filename_dos

Valid filename on DOS (8.3/short filenames).

The following rules are used in this pattern:

1. Contains 1-8 characters, optionally followed by a period and 0-3 characters (extension).
2. Valid characters include letters A-Z (a-z is also allowed in this regex), numbers 0-9, and the following special characters:: _ underscore ^ caret $ dollar sign ~ tilde ! exclamation point # number sign % percent sign & ampersand hyphen (-) {} braces @ at sign ` single quote ' apostrophe () parentheses
3. The name cannot be one of the following reserved file names: CLOCK$, CON, AUX, COM1, COM2, COM3, COM4, LPT1, LPT2, LPT3, LPT4, NUL, and PRN.

Examples:


            
              
              "FOO" =~ re("Path::filename_dos");  # matches

Lowercase letters not allowed (convert your string to uppercase first if you want to accept lowercase letters).


            
              
              "foo" =~ re("Path::filename_dos");  # matches
"FOOBARBA.TXT" =~ re("Path::filename_dos");  # matches

Contains period other than as filename-extension separator.


            
              
              ".FOO.TXT" =~ re("Path::filename_dos");  # doesn't match

Does not contain filename.


            
              
              ".TXT" =~ re("Path::filename_dos");  # doesn't match

Empty.


            
              
              "" =~ re("Path::filename_dos");  # doesn't match

Name too long.


            
              
              "FOOBARBAZ" =~ re("Path::filename_dos");  # doesn't match

Extension too long.


            
              
              "FOOBARBA.TEXT" =~ re("Path::filename_dos");  # doesn't match

reserved name CON.


            
              
              "CON" =~ re("Path::filename_dos");  # doesn't match
"CONAUX" =~ re("Path::filename_dos");  # matches

Starts with space.


            
              
              " FOO.BAR" =~ re("Path::filename_dos");  # doesn't match

Contains space.


            
              
              "FOO .BAR" =~ re("Path::filename_dos");  # doesn't match
"_\$!%-\@'^.~#&" =~ re("Path::filename_dos");  # matches
"{}`()." =~ re("Path::filename_dos");  # matches

Contains invalid character [ and ].


            
              
              "FILE[1].TXT" =~ re("Path::filename_dos");  # doesn't match

filename_unix

Valid filename on Unix.

Length must be 1-255 characters. The only characters not allowed include "\0" (null) and "/" (forward slash, for path separator). Also cannot be '.' or '..'.

Examples:


            
              
              "foo" =~ re("Path::filename_unix");  # matches
"foo bar" =~ re("Path::filename_unix");  # matches

Too short.


            
              
              "" =~ re("Path::filename_unix");  # doesn't match

Too long.


            
              
              "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" =~ re("Path::filename_unix");  # doesn't match

contains slash.


            
              
              "foo/bar" =~ re("Path::filename_unix");  # doesn't match

begins with slash.


            
              
              "/foo" =~ re("Path::filename_unix");  # doesn't match

ends with slash.


            
              
              "foo/" =~ re("Path::filename_unix");  # doesn't match

contains null (\0).


            
              
              "foo\0" =~ re("Path::filename_unix");  # doesn't match

Cannot be ".".


            
              
              "." =~ re("Path::filename_unix");  # doesn't match

Cannot be "..".


            
              
              ".." =~ re("Path::filename_unix");  # doesn't match
"..." =~ re("Path::filename_unix");  # matches

filename_windows

Valid filename on Windows (long filenames).

The following rules are used in this pattern:

1. Contains 1-260 characters (including extension).
2. Does not contain the characters \0, [\x01-\x1f], <, >, :, ", /, \, |, ?, *.
3. The name cannot be one of the following reserved file names: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9.
4. Does not end with a period.
5. Does not begin with a period.
6. Cannot be '.' or '..'.

References: - https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file

Examples:

Empty.


            
              
              "" =~ re("Path::filename_windows");  # doesn't match
"FOO" =~ re("Path::filename_windows");  # matches
"foo" =~ re("Path::filename_windows");  # matches
"FOOBARBA.TXT" =~ re("Path::filename_windows");  # matches

Starts with period.


            
              
              ".FOO.TXT" =~ re("Path::filename_windows");  # doesn't match

Ends with period.


            
              
              "bar." =~ re("Path::filename_windows");  # doesn't match

reserved name CON.


            
              
              "CON" =~ re("Path::filename_windows");  # doesn't match

reserved name LPT3.


            
              
              "LPT3" =~ re("Path::filename_windows");  # doesn't match
"CONAUX" =~ re("Path::filename_windows");  # matches
"FOO .BAR" =~ re("Path::filename_windows");  # matches
"foo[1].txt" =~ re("Path::filename_windows");  # matches
"foo(2).txt" =~ re("Path::filename_windows");  # matches

Contains invalid character \0.


            
              
              "foo\0" =~ re("Path::filename_windows");  # doesn't match

Contains control character.


            
              
              "foo\b" =~ re("Path::filename_windows");  # doesn't match

Contains invalid character /.


            
              
              "foo/bar" =~ re("Path::filename_windows");  # doesn't match

Contains invalid characters <>.


            
              
              "foo<bar>" =~ re("Path::filename_windows");  # doesn't match

Contains invalid character :.


            
              
              "foo:bar" =~ re("Path::filename_windows");  # doesn't match
"foo's file" =~ re("Path::filename_windows");  # matches

Contains invalid character ".


            
              
              "foo \"bar\"" =~ re("Path::filename_windows");  # doesn't match

Contains invalid character \.


            
              
              "foo\\bar" =~ re("Path::filename_windows");  # doesn't match

Contains invalid character |.


            
              
              "foo|bar" =~ re("Path::filename_windows");  # doesn't match

Contains invalid character ?.


            
              
              "foo?" =~ re("Path::filename_windows");  # doesn't match

Contains invalid character *.


            
              
              "foo*" =~ re("Path::filename_windows");  # doesn't match

Too long.


            
              
              "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" =~ re("Path::filename_windows");  # doesn't match

HOMEPAGE

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

SOURCE

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

BUGS

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

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.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

To install Regexp::Pattern::Path, copy and paste the appropriate command in to your terminal.

cpanm

cpanm Regexp::Pattern::Path

CPAN shell

perl -MCPAN -e shell
install Regexp::Pattern::Path

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

NAME

VERSION

SYNOPSIS

DESCRIPTION

PATTERNS

HOMEPAGE

SOURCE

BUGS

SEE ALSO

AUTHOR

COPYRIGHT AND LICENSE

Module Install Instructions