0yi'dZddlmZddlZddlmZmZddlmZddl m Z m Z m Z m Z ddlmZmZmZe d d Z Gd d eZGdd eZeGddeZy)z8 This module provides the base definition for patterns. ) annotationsN)IterableIterator) dataclass)AnyOptionalTypeVarUnion)AnyStr deprecatedoverrideRegexPatternSelf RegexPattern)boundcBeZdZdZdZddZedd dZd dZy) PatternzG The :class:`Pattern` class is the abstract definition of a pattern. includec||_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 R/var/www/html/content_weaver/venv/lib/python3.12/site-packages/pathspec/pattern.py__init__zPattern.__init__'s$,zXPattern.match() is deprecated. Use Pattern.match_file() with a loop for similar results.c#FK|D]}|j||yw)a .. version-deprecated:: 0.10.0 This method is no longer used. Use the :meth:`self.match_file <.Pattern.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. Returns an :class:`~collections.abc.Iterable` yielding each matched file path (:class:`str`). N) match_file)rfilesfiles rmatchz Pattern.match7s+$d ood' Js!!cLtdj|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().)cls)NotImplementedErrorformat __class__)rrs rrzPattern.match_fileMs$ D Ft~~F  rN)rOptional[bool]returnNone)rz Iterable[str]r&z Iterator[str])rstrr&z Optional[Any]) __name__ __module__ __qualname____doc__ __slots__rr rrrrrrs6    $  rrcreZdZdZdZ d d fd Zd dZd dZed dZ e d dZ xZ S)rza The :class:`RegexPattern` class is an implementation of a pattern using regular expressions. )patternregexcXt|ttfr<|Jd|d|d|j|\}}|Kt j |}n5|t |dr|}n$||Jd|d|dd}ntd|dtt|+|||_ ||_ y) 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.rz is null.zpattern:z& is not a string, re.Pattern, or None.) isinstancer(bytespattern_to_regexrecompilehasattr TypeErrorsuperrrr0r1)rr0rr1r$s rrzRegexPattern.__init__fs&#u& /wk4WK}M/))'2>5' JJu Eww8 5 /wk4WKyI/ 5 Xg[(NO PP d$W-29$, &+$*rct|j|j|j}|j|_|S)zZ Performa a shallow copy of the pattern. Returns the copy (:class:`RegexPattern`). )r$r1rr0rothers r__copy__zRegexPattern.__copy__s, ..T\\ 2%,,%- ,rct|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. )r3rrr1NotImplementedr<s r__eq__zRegexPattern.__eq__s9 |$ ,,%-- ' EDJJ%++,EE rcl|j(|jj|}| t|Sy)a Matches this pattern against the specified file. *file* (:class:`str` or :class:`bytes`) is the file path relative to the root directory (e.g., "relative/path/to/file"). Returns the match result (:class:`.RegexMatchResult`) if *file* matched; otherwise, :data:`None`. N)rr1searchRegexMatchResult)rrrs rrzRegexPattern.match_files6 \\ ::  T "5  E "" rc |dfS)aF Convert the pattern into an uncompiled regular expression. *pattern* (:class:`str` or :class:`bytes`) is the pattern to convert into a regular expression. Returns a :class:`tuple` containing: - *pattern* (:class:`str`, :class:`bytes` or :data:`None`) is the uncompiled regular expression . - *include* (:class:`bool` or :data:`None`) is 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.)r!r0s rr5zRegexPattern.pattern_to_regexs. $r)N)r0zUnion[AnyStr, re.Pattern, None]rr%r&r')rrr&r)r=rr&bool)rr r&zOptional[RegexMatchResult])r0r r&z'tuple[Optional[AnyStr], Optional[bool]]) r)r*r+r,r-rr>rArr classmethodr5 __classcell__)r$s@rrrZsz !9 *9 9 9v   " .rc eZdZUdZdZded<y)rDzq The :class:`RegexMatchResult` data class is used to return information about the matched regular expression. )rzre.MatchrN)r)r*r+r,r-__annotations__r.rrrDrDs  rrD)r, __future__rr6collections.abcrr dataclassesrtypingrrr r _typingr r rrobjectrrrDr.rrrQs~#      -^D : f: zE7EP v r