AedZddlZddlZddlZddlmZmZmZmZm Z m Z m Z mZmZGddeZ Gdde Zej$Gdd eZy) z8 This module provides the base definition for patterns. N) AnyAnyStrIterableIteratorMatchOptionalPatternTupleUnionc\eZdZdZdZdeeddfdZdee de e fdZ d e dee fd Z y) r zG The :class:`Pattern` class is the abstract definition of a pattern. includerreturnNc||_y)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.12/site-packages/pathspec/pattern.py__init__zPattern.__init__s$,filesc#Ktjdj|jtd|D]}|j ||yw)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,sS -- F4>>.1 > d ood' Js A AArcJtdj|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 sW 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. )regexNpatternrrc|t|ttfrE|Jdj|||j |\}}|\t j |}nF|t|dr|}n5||1Jdj||tdj|tt|/||_ y)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& /> VGW))'2>5' JJu Eww8 5 /: VGW GNNwW XX d$W-!$*rotherct|tr4|j|jk(xr|j|jk(StS)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 |$ ,,%-- ' EDJJ%++,EE rrRegexMatchResultcl|j(|jj|}| t|Sy)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_files6 \\ ::  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  !4 $ %4 D>4 4l  D CH-?$@"CE#t),<rr,c eZdZUdZdZeed<y)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<s  rr<)r& dataclassesr3rtypingrrrrrrDrr r@r r objectr, dataclassr<r*rrrJsf    ;f;|j7jZvr