W-Ph~dZddlZddlZddlZddlmZmZmZmZm 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 P/var/www/html/test/jupyter/venv/lib/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., ``"relative/path/to/file"``). Returns an :class:`~collections.abc.Iterable` yielding each matched file path (:class:`str`). z{cls.__module__}.{cls.__qualname__}.match() is deprecated. Use {cls.__module__}.{cls.__qualname__}.match_file() with a loop for similar results.cls) stacklevelN)warningswarnformat __class__DeprecationWarning match_file)rrfiles rmatchz Pattern.match.sy - Ft~F 2q BBBB d ood' JJJrr!cRtd|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?{cls.__module__}.{cls.__qualname__} must override match_file().r)NotImplementedErrorrr)rr!s rr zPattern.match_fileFs* D Ft~F   r)__name__ __module__ __qualname____doc__ __slots__rboolrrstrrr"rr rrr r s Xd^  (3-0  C  HSM       rr ceZdZdZdZ ddeeedfdee 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. )patternregexNr/rrct|ttfrB|Jd|d|d||\}}|t j|}n>|t |dr|}n)||Jd|d|dntd|dtt| |||_ ||_ dS) a( 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. Nzinclude:z must be null when pattern:z is a string.r"z is null.zpattern:z& is not a string, re.Pattern, or None.) isinstancer+bytespattern_to_regexrecompilehasattr TypeErrorsuperr.rr/r0)rr/rr0rs rrzRegexPattern.__init___s&#u&&Q //MwMMWMMM //))'22>5' Ju  Eww88 55 //IwIIWIII /// OgOOO P PP d$$W---3:$, "$*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. )r2r.rr0NotImplemented)rr:s r__eq__zRegexPattern.__eq__s9 |$$ ,%- ' EDJ%+,EE rr!RegexMatchResultcj|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)rr0r"r>)rr!r"s rr zRegexPattern.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,)rr/s rr4zRegexPattern.pattern_to_regexs $r)N)r%r&r'r(r)r r PatternHintrr*rr=r+r classmethodr r4 __classcell__)rs@rr.r.Ss !77 d* +7 D>7 777777r  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( dataclassesr5rtypingrrrrrrErr rAr r objectr. dataclassr>r,rrrKsG                       < < < < < f< < < ~ppppp7pppfvr