@@ -47,9 +47,11 @@ matching:
47
47
- [ ` glob ` ] ( #glob ) , [ ` rglob ` ] ( #rglob ) , and [ ` match ` ] ( #match ) do not enable [ ` GLOBSTAR ` ] ( #globstar )
48
48
or [ ` DOTGLOB ` ] ( #dotglob ) by default. These flags must be passed in to take advantage of this functionality.
49
49
50
- - A [ ` globmatch ` ] ( #globmatch ) function has been added to ` PurePath ` classes (and ` Path ` classes which are
51
- derived from ` PurePath ` ) which is like [ ` match ` ] ( #match ) except without the right to left behavior. See
52
- [ ` match ` ] ( #match ) and [ ` globmatch ` ] ( purepathglobmatch ) for more information.
50
+ - A [ ` globmatch ` ] ( #globmatch ) function has been added to ` PurePath ` classes (and ` Path ` classes which are derived from
51
+ ` PurePath ` ) which is like [ ` match ` ] ( #match ) except performs a "full" match. Python 3.13 added a similar
52
+ function called [ ` full_match ` ] ( #full_match ) which came long after our [ ` globmatch ` ] ( #globmatch ) support was added.
53
+ In recent versions we've also added [ ` full_match ` ] ( #full_match ) as an alias to our [ ` globmatch ` ] ( #globmatch )
54
+ function. See [ ` match ` ] ( #match ) , [ ` globmatch ` ] ( #globmatch ) , and [ ` full_match ` ] ( #full_match ) for more information.
53
55
54
56
- If file searching methods ([ ` glob ` ] ( #glob ) and [ ` rglob ` ] ( #rglob ) ) are given multiple patterns, they will
55
57
ensure duplicate results are filtered out. This only occurs when more than one inclusive pattern is given, or a
@@ -109,7 +111,7 @@ matching:
109
111
110
112
- [`rglob`](#rglob) will exhibit the same *recursive* behavior.
111
113
112
- - [`match`](#match) will exhibit the same right to left behavior .
114
+ - [`match`](#match) will match using the same *recursive* behavior as [`rglob`](#rglob) .
113
115
114
116
## Classes
115
117
@@ -250,9 +252,10 @@ limit](#multi-pattern-limits). Exclusion patterns can be specified via the `excl
250
252
a list of patterns. It will return a boolean indicating whether the object's file path was matched by the
251
253
pattern(s).
252
254
253
- ` match ` mimics Python's ` pathlib ` version of ` match ` . Python's ` match ` uses a right to left evaluation. Wildcard Match
254
- emulates this behavior as well. What this means is that when provided with a path ` some/path/name ` , the patterns ` name ` ,
255
- ` path/name ` and ` some/path/name ` will all match. Essentially, it matches what [ ` rglob ` ] ( #rglob ) returns.
255
+ ` match ` mimics Python's ` pathlib ` version of ` match ` . Python's ` match ` uses a right to left evaluation that behaves
256
+ like [ ` rglob ` ] ( #rglob ) but as a matcher instead of a globbing function. Wildcard Match emulates this behavior as well.
257
+ What this means is that when provided with a path ` some/path/name ` , the patterns ` name ` , ` path/name ` and ` some/path/name `
258
+ will all match. Essentially, it matches what [ ` rglob ` ] ( #rglob ) returns.
256
259
257
260
` match ` does not access the filesystem, but you can force the path to access the filesystem if you give it the
258
261
[ ` REALPATH ` ] ( #realpath ) flag. We do not restrict this, but we do not enable it by default.
0 commit comments