B Khh@sdZddlZddlZddlZddlmZmZmZmZm Z m Z m Z mZmZGdddeZ Gddde ZeGdd d eZdS) z8 This module provides the base definition for patterns. N) AnyAnyStrIterableIteratorMatchOptionalPatternTupleUnionc@sTeZdZdZdZeeddddZee e e ddd Z e ee d d d Z dS) rzG The :class:`Pattern` class is the abstract definition of a pattern. )includeN)r returncCs ||_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`). N)r )selfr r6/tmp/pip-install-vv81h98y/pathspec/pathspec/pattern.py__init__s zPattern.__init__)filesr ccs>tjd|jtddx |D]}||dk r|VqWdS)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)r rfilerrrmatch,s  z Pattern.match)rr cCstd|jdS)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().N)NotImplementedErrorrr)r rrrrrEszPattern.match_file)__name__ __module__ __qualname____doc__ __slots__rboolrrstrrrrrrrrrrs rcs|eZdZdZdZdeeefee ddfdd Z de ddd Z e ed d d d Z ee ee e fdddZZS) RegexPatternza The :class:`RegexPattern` class is an implementation of a pattern using regular expressions. )regexN)patternr r cst|ttfrH|dks&td||||\}}|dk rt|}nH|dk r`t|dr`|}n0|dkr|dkstd||nt d|t t | |||_ dS)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.rz4include:{!r} must be null when pattern:{!r} is null.z2pattern:{!r} is not a string, re.Pattern, or None.) isinstancer#bytesAssertionErrorrpattern_to_regexrecompilehasattr TypeErrorsuperr$rr%)r r&r r%)rrrr[s"     zRegexPattern.__init__)otherr cCs*t|tr"|j|jko |j|jkStSdS)z Tests the equality of this regex pattern with *other* (:class:`RegexPattern`) by comparing their :attr:`~Pattern.include` and :attr:`~RegexPattern.regex` attributes. N)r'r$r r%NotImplemented)r r0rrr__eq__s zRegexPattern.__eq__RegexMatchResult)rr cCs*|jdk r&|j|}|dk r&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)r r%rr3)r rrrrrrs  zRegexPattern.match_file)r&r cCs|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&rrrr*szRegexPattern.pattern_to_regex)N)rrrr r!r r PatternHintrr"rr2r#r classmethodr r* __classcell__rr)rrr$Rs2 r$c@seZdZUdZdZeed<dS)r3zq The :class:`RegexMatchResult` data class is used to return information about the matched regular expression. )rrN)rrrr r! MatchHint__annotations__rrrrr3s r3)r Z dataclassesr+rtypingrrrrrr8rrr5r r objectr$Z dataclassr3rrrrs, >m