\jedZddlmZddlZddlmZmZddlmZddl 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 :/root/env/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    $  rrceZdZdZdZ d d fd Zd dZd dZd dZddZ e ddZ e dd Z xZS)rza The :class:`RegexPattern` class is an implementation of a pattern using regular expressions. )patternregexcvd}t|ttfrL|Jd|d|d|j|\}}|X|Jd|d|dt j |}n2|t |dr|}n!||Jd|d|d td |d tt|+|||_ ||_ 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.z raw_regex=z must be non-null when include=z is not None.rz is null.zpattern=z& is not a string, re.Pattern, or None.) isinstancer(bytespattern_to_regexrecompilehasattr TypeErrorsuperrrr0r1)rr0rr1 raw_regexr$s rrzRegexPattern.__init__fs$!%%#u& /wl.g\?/--g69g   ~5WL F  JJy !Eww8 5 /wl.g\;/ hg\!GH II d$W-6=$, &+$*rch|jjd|jd|jdS)z; Returns a debug representation of this regex pattern. z (pattern=z , include=))r$r)r0rrs r__repr__zRegexPattern.__repr__s3 NN # # $Idll-=Z GWWX YYrc4t|jxsdS)z Returns a string representation of this regex pattern. Equivalent to uncompiled pattern. The string representation is the uncompiled pattern if it is not :data:`None`; otherwise, an empty string. )r(r0r>s r__str__zRegexPattern.__str__s T\\ R  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. )r3rrr1NotImplementedrDs r__eq__zRegexPattern.__eq__s9 |$ ,,%-- ' EDJJ%++,EE rc\|jx}|j|x} 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)r1searchRegexMatchResult)rrr1rs rrzRegexPattern.match_files5ZZE$d##0 5 !! 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. 4r)N)r0zUnion[AnyStr, re.Pattern, None]rr%r&r')r&r()rrr&r)rEobjectr&bool)rr r&zOptional[RegexMatchResult])r0r r&z'tuple[Optional[AnyStr], Optional[bool]])r)r*r+r,r-rr?rBrFrIrr classmethodr5 __classcell__)r$s@rrrZs !; *; ; ;zZ !   $ .rc eZdZUdZdZded<y)rLzq The :class:`RegexMatchResult` data class is used to return information about the matched regular expression. )rzre.MatchrN)r)r*r+r,r-__annotations__r.rrrLrLs  rrL)r, __future__rr6collections.abcrr dataclassesrtypingrrr r _typingr r rrrNrrrLr.rrrYs~#      -^D : f: zW7Wt v r