o yAf~@sdZddlZddlZddlZddlmZmZmZmZm Z m Z m Z mZmZGdddeZ Gddde ZeGdd d eZdS) z8 This module provides the base definition for patterns. N) AnyAnyStrIterableIteratorMatchOptionalPatternTupleUnionc@sZeZdZdZdZdeeddfddZdee de e fd d Z d e dee fd d Z dS)rzG The :class:`Pattern` class is the abstract definition of a pattern. includer returnNcCs ||_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 )selfr r5/usr/lib/python3.10/site-packages/pathspec/pattern.py__init__s zPattern.__init__filesccs>tjdj|jdtdd|D] }||dur|VqdS)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)rrfilerrrmatch.sz Pattern.matchrcCstdj|jd)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)rrrrrrFszPattern.match_file)__name__ __module__ __qualname____doc__ __slots__rboolrrstrrrrrrrrrrs rcseZdZdZdZ ddeeedfdee ddffdd Z d dde fd d Z d e ded fddZ ede dee e ffddZZS) RegexPatternza The :class:`RegexPattern` class is an implementation of a pattern using regular expressions. )patternregexNr(r r cst|ttfr'|dusJd|d|d||\}}|dur&t|}n(|dur3t|dr3|}n|durG|dusFJd|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.rz is null.zpattern:z& is not a string, re.Pattern, or None.) isinstancer&bytespattern_to_regexrecompilehasattr TypeErrorsuperr'rr(r))rr(r r)rrrr_s(   zRegexPattern.__init__othercCs&t|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. )r*r'r r)NotImplemented)rr3rrr__eq__s zRegexPattern.__eq__rRegexMatchResultcCs*|jdur|j|}|durt|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)r r)rr6)rrrrrrrs zRegexPattern.match_filecCs|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(rrrr,szRegexPattern.pattern_to_regex)N)r r!r"r#r$r r PatternHintrr%rr5r&r classmethodr r, __classcell__rrr2rr'Ss 9 $r'c@seZdZUdZdZeed<dS)r6zq The :class:`RegexMatchResult` data class is used to return information about the matched regular expression. )rrN)r r!r"r#r$ MatchHint__annotations__rrrrr6s r6)r# dataclassesr-rtypingrrrrrr:rrr7r r objectr' dataclassr6rrrrs, ?s