[ddZddlZddlZddlZddlmZmZmZmZm Z m Z m Z mZmZGddeZ Gdde ZejGdd eZdS) z8 This module provides the base definition for patterns. N) AnyAnyStrIterableIteratorMatchOptionalPatternTupleUnioncveZdZdZdZdeeddfdZdee de e fdZ d e dee fd Z dS) r zG The :class:`Pattern` class is the abstract definition of a pattern. includerreturnNc||_dS)z Initializes the :class:`Pattern` instance. *include* (:class:`bool` or :data:`None`) is whether the matched files should be included (:data:`True`), excluded (:data:`False`), or is a null-operation (:data:`None`). Nr )selfrs 0lib/python3.11/site-packages/pathspec/pattern.py__init__zPattern.__init__s$,filesc#Ktjd|jtd|D]}|||VdS)a DEPRECATED: This method is no longer used and has been replaced by :meth:`.match_file`. Use the :meth:`.match_file` method with a loop for similar results. Matches this pattern against the specified files. *files* (:class:`~collections.abc.Iterable` of :class:`str`) contains each file relative to the root directory (e.g., :data:`"relative/path/to/file"`). Returns an :class:`~collections.abc.Iterable` yielding each matched file path (:class:`str`). z{0.__module__}.{0.__qualname__}.match() is deprecated. Use {0.__module__}.{0.__qualname__}.match_file() with a loop for similar results.) stacklevelN)warningswarnformat __class__DeprecationWarning match_file)rrfiles rmatchz Pattern.match,su - F4>.1 >>>> d ood JJJrrcPtd|j)z Matches this pattern against the specified file. *file* (:class:`str`) is the normalized file path to match against. Returns the match result if *file* matched; otherwise, :data:`None`. z;{0.__module__}.{0.__qualname__} must override match_file().)NotImplementedErrorrr)rrs rrzPattern.match_fileEs( @ F4>  r)__name__ __module__ __qualname____doc__ __slots__rboolrrstrrr rrrrr r s Xd^  (3-2 C HSM      rr ceZdZdZdZ ddeeefdee ddffd Z ddde fd Z d e ded fd Z ede dee e ffd ZxZS) RegexPatternza The :class:`RegexPattern` class is an implementation of a pattern using regular expressions. )regexNpatternrrct|ttfrO|Jd||||\}}|t j|}nZ|t|dr|}nE|!|Jd||n"td|tt| |||_ dS)a0 Initializes the :class:`RegexPattern` instance. *pattern* (:class:`str`, :class:`bytes`, :class:`re.Pattern`, or :data:`None`) is the pattern to compile into a regular expression. *include* (:class:`bool` or :data:`None`) must be :data:`None` unless *pattern* is a precompiled regular expression (:class:`re.Pattern`) in which case it is whether matched files should be included (:data:`True`), excluded (:data:`False`), or is a null operation (:data:`None`). .. NOTE:: Subclasses do not need to support the *include* parameter. Nz8include:{!r} must be null when pattern:{!r} is a string.r z4include:{!r} must be null when pattern:{!r} is null.z2pattern:{!r} is not a string, re.Pattern, or None.) isinstancer)bytesrpattern_to_regexrecompilehasattr TypeErrorsuperr,rr-)rr.rr-rs rrzRegexPattern.__init__[s-*#u&&Y > VGW))'22>5' Ju  E Yww88 Y 55Y : VGW GNNwWW X XX d$$W---!$*rotherczt|tr |j|jko|j|jkStS)z Tests the equality of this regex pattern with *other* (:class:`RegexPattern`) by comparing their :attr:`~Pattern.include` and :attr:`~RegexPattern.regex` attributes. )r0r,rr-NotImplemented)rr8s r__eq__zRegexPattern.__eq__s9 |$$ ,%- ' EDJ%+,EE rrRegexMatchResultcj|j+|j|}|t|SdS)a  Matches this pattern against the specified file. *file* (:class:`str`) contains each file relative to the root directory (e.g., "relative/path/to/file"). Returns the match result (:class:`RegexMatchResult`) if *file* matched; otherwise, :data:`None`. N)rr-r r<)rrr s rrzRegexPattern.match_files> \# :  D ! !5 # E " "" rc |dfS)a Convert the pattern into an uncompiled regular expression. *pattern* (:class:`str`) is the pattern to convert into a regular expression. Returns the uncompiled regular expression (:class:`str` or :data:`None`), and whether matched files should be included (:data:`True`), excluded (:data:`False`), or is a null-operation (:data:`None`). .. NOTE:: The default implementation simply returns *pattern* and :data:`True`. Tr*)clsr.s rr2zRegexPattern.pattern_to_regexs $r)N)r#r$r%r&r'r r PatternHintrr(rr;r)r classmethodr r2 __classcell__)rs@rr,r,Rs  !44 $ %4 D>4 444444l  D    CH-?$@"CE#t),<+rr,c"eZdZUdZdZeed<dS)r<zq The :class:`RegexMatchResult` data class is used to return information about the matched regular expression. )r r N)r#r$r%r&r' MatchHint__annotations__r*rrr<r<s5  rr<)r& dataclassesr3rtypingrrrrrrDrr r@r r objectr, dataclassr<r*rrrJsG                       ;;;;;f;;;|jjjjj7jjjZvr