ˆh3SrSSKJr SSKJr SSKJrJrJrJ r J r J r J r J r Jr SSKJr SSKJr SSKJrJrJrJrJrJrJr \ "S S S 9r"S S \5rg )zR This module provides an object oriented interface for pattern matching of files. ) Collection) zip_longest) AnyStrCallablerIterableIteratorOptionalTypeTypeVarUnion)util)Pattern) CheckResultStrPathTStrPath TreeEntry_filter_check_patterns _is_iterablenormalize_fileSelfPathSpec)boundc \rSrSrSrS\\SS4SjrS\S\ 4Sjr S\ 4S jr S \ SSS\ 4S jrS \ SSS\ 4S jrS#S \S\\\S\\4SjjrS#S\\S\\\S\\\4SjjrS$S\S\\\/S4S\\ S\\\4Sjjr\S\\ S\\\\/\44S\\S\ 4Sj5r S#SS.S\\!S\\\S\\ S\\!4Sjjjr"\#"\$RJ5r&S#S \S\\\S\ 4Sjjr'S#SS.S\\S\\\S\\ S\\4Sjjjr(S$SS.S\S\\\/S4S\\ S\\ S\\!4 S jjjr)S$SS.S\S\\\/S4S\\ S\\ S\\4 S!jjjr*\*r+S"r,g)%r'za The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. patternsreturnNcP[U[5(d [U5nXlg)z Initializes the :class:`PathSpec` instance. *patterns* (:class:`~collections.abc.Collection` or :class:`~collections.abc.Iterable`) yields each compiled pattern (:class:`.Pattern`). N) isinstanceCollectionTypelistr)selfrs I/opt/services/DDDS/venv/lib/python3.13/site-packages/pathspec/pathspec.py__init__PathSpec.__init__-s$ Hn - -8n8'/-otherc[U[5(a2[URUR5n[ SU55$[ $)z Tests the equality of this path-spec with *other* (:class:`PathSpec`) by comparing their :attr:`~PathSpec.patterns` attributes. c3.# UH upX:Hv M g7fN).0abs r# "PathSpec.__eq__..Ds 1afs)rrrrallNotImplemented)r"r'paired_patternss r#__eq__PathSpec.__eq__=s< x   ?? 1 1 11 r&c,[UR5$)zQ Returns the number of compiled patterns this path-spec contains (:class:`int`). )lenr)r"s r#__len__PathSpec.__len__Hs T]] r&r"c[U[5(a(URURUR-5$[$)zW Combines the :attr:`Pathspec.patterns` patterns from two :class:`PathSpec` instances. )rr __class__rr2r"r's r#__add__PathSpec.__add__Os3 x  ..7 88 r&cz[U[5(a!U=RUR- slU$[$)zc Adds the :attr:`Pathspec.patterns` patterns from one :class:`PathSpec` instance to this instance. )rrrr2r<s r#__iadd__PathSpec.__iadd__Ys. x  ==ENN"= ; r&file separatorsc~[X5nUR[UR5U5upE[ XU5$)a Check the files against this path-spec. *file* (:class:`str` or :class:`os.PathLike`) is the file path to be matched against :attr:`self.patterns `. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`~pathspec.util.normalize_file` for more information. Returns the file check result (:class:`~pathspec.util.CheckResult`). )r _match_file enumeraterr)r"rBrC norm_fileincludeindexs r# check_filePathSpec.check_fileds8"T.)##Idmm$`. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`~pathspec.util.normalize_file` for more information. Returns an :class:`~collections.abc.Iterator` yielding each file check result (:class:`~pathspec.util.CheckResult`). files: is not an iterable.N)r TypeErrorrrrrEr)r"rLrC use_patterns orig_filerGrHrIs r# check_filesPathSpec.check_filesysh& e   VE9$89 ::' 6,ii49$$\=>7 Y //sA,A.rooton_error follow_linksc#l# [R"XUS9nURU5ShvN gN7f)a Walks the specified root path for all files and checks them against this path-spec. *root* (:class:`str` or :class:`os.PathLike`) is the root directory to search for files. *on_error* (:class:`~collections.abc.Callable` or :data:`None`) optionally is the error handler for file-system exceptions. It will be called with the exception (:exc:`OSError`). Reraise the exception to abort the walk. Default is :data:`None` to ignore file-system exceptions. *follow_links* (:class:`bool` or :data:`None`) optionally is whether to walk symbolic links that resolve to directories. Default is :data:`None` for :data:`True`. *negate* (:class:`bool` or :data:`None`) is whether to negate the match results of the patterns. If :data:`True`, a pattern matching a file will exclude the file rather than include it. Default is :data:`None` for :data:`False`. Returns an :class:`~collections.abc.Iterator` yielding each file check result (:class:`~pathspec.util.CheckResult`). rVrWN)riter_tree_filesrS)r"rUrVrWrLs r#check_tree_filesPathSpec.check_tree_filess-<   t\ R%   e $$$s *424clspattern_factorylinesc2[U[5(a[R"U5n[ U5(d[ SU<S35e[ U5(d[ SU<S35eUVs/sHo3(dM U"U5PM nnU"U5$s snf)aS Compiles the pattern lines. *pattern_factory* can be either the name of a registered pattern factory (:class:`str`), or a :class:`~collections.abc.Callable` used to compile patterns. It must accept an uncompiled pattern (:class:`str`) and return the compiled pattern (:class:`.Pattern`). *lines* (:class:`~collections.abc.Iterable`) yields each uncompiled pattern (:class:`str`). This simply has to yield each line so that it can be a :class:`io.TextIOBase` (e.g., from :func:`open` or :class:`io.StringIO`) or the result from :meth:`str.splitlines`. Returns the :class:`PathSpec` instance. zpattern_factory:z is not callable.zlines:rO)rstrrlookup_patterncallablerPr)r]r^r_liners r# from_linesPathSpec.from_liness*%%((9? / " " %o%88IJ KK e   VE9$89 ::05 >#od#( > X?s 0 B> Bnegateentriesrhc## [U5(d[SU<S35e[UR5nUHGn[ UR U5nUR XF5upxU(aU(+nU(dMCUv MI g7f)a Matches the entries to this path-spec. *entries* (:class:`~collections.abc.Iterable` of :class:`~pathspec.util.TreeEntry`) contains the entries to be matched against :attr:`self.patterns `. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`~pathspec.util.normalize_file` for more information. *negate* (:class:`bool` or :data:`None`) is whether to negate the match results of the patterns. If :data:`True`, a pattern matching a file will exclude the file rather than include it. Default is :data:`None` for :data:`False`. Returns the matched entries (:class:`~collections.abc.Iterator` of :class:`~pathspec.util.TreeEntry`). zentries:rON)rrPrrrpathrE) r"rirCrhrQentryrGrH_indexs r# match_entriesPathSpec.match_entriessu2 g   Xg[(<= >>' 6,eejj*59%%l>?7 kG g Ks A7B= Bc|[X5nUR[UR5U5upE[ U5$)a Matches the file to this path-spec. *file* (:class:`str` or :class:`os.PathLike`) is the file path to be matched against :attr:`self.patterns `. *separators* (:class:`~collections.abc.Collection` of :class:`str`) optionally contains the path separators to normalize. See :func:`~pathspec.util.normalize_file` for more information. Returns :data:`True` if *file* matched; otherwise, :data:`False`. )rrErFrbool)r"rBrCrGrHrms r# match_filePathSpec.match_files5"T.)$$Yt}}%=yI/' gr&c## [U5(d[SU<S35e[UR5nUH<n[ XR5nUR XF5upxU(aU(+nU(dM8Uv M> g7f)a Matches the files to this path-spec. *files* (:class:`~collections.abc.Iterable` of :class:`str` or :class:`os.PathLike`) contains the file paths to be matched against :attr:`self.patterns `. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`~pathspec.util.normalize_file` for more information. *negate* (:class:`bool` or :data:`None`) is whether to negate the match results of the patterns. If :data:`True`, a pattern matching a file will exclude the file rather than include it. Default is :data:`None` for :data:`False`. Returns the matched files (:class:`~collections.abc.Iterator` of :class:`str` or :class:`os.PathLike`). rNrON)rrPrrrrE) r"rLrCrhrQrRrGrHrms r# match_filesPathSpec.match_filesso4 e   VE9$89 ::' 6,ii49%%l>?7 kG g Os A,A;2 A;c#h# [R"XUS9nURXTS9ShvN gN7f)a Walks the specified root path for all files and matches them to this path-spec. *root* (:class:`str` or :class:`os.PathLike`) is the root directory to search. *on_error* (:class:`~collections.abc.Callable` or :data:`None`) optionally is the error handler for file-system exceptions. It will be called with the exception (:exc:`OSError`). Reraise the exception to abort the walk. Default is :data:`None` to ignore file-system exceptions. *follow_links* (:class:`bool` or :data:`None`) optionally is whether to walk symbolic links that resolve to directories. Default is :data:`None` for :data:`True`. *negate* (:class:`bool` or :data:`None`) is whether to negate the match results of the patterns. If :data:`True`, a pattern matching a file will exclude the file rather than include it. Default is :data:`None` for :data:`False`. Returns the matched files (:class:`~collections.abc.Iterator` of :class:`.TreeEntry`). rYrgN)riter_tree_entriesrn)r"rUrVrWrhris r#match_tree_entriesPathSpec.match_tree_entriesBs1@  " "4 V'     777 (202c#h# [R"XUS9nURXTS9ShvN gN7f)a Walks the specified root path for all files and matches them to this path-spec. *root* (:class:`str` or :class:`os.PathLike`) is the root directory to search for files. *on_error* (:class:`~collections.abc.Callable` or :data:`None`) optionally is the error handler for file-system exceptions. It will be called with the exception (:exc:`OSError`). Reraise the exception to abort the walk. Default is :data:`None` to ignore file-system exceptions. *follow_links* (:class:`bool` or :data:`None`) optionally is whether to walk symbolic links that resolve to directories. Default is :data:`None` for :data:`True`. *negate* (:class:`bool` or :data:`None`) is whether to negate the match results of the patterns. If :data:`True`, a pattern matching a file will exclude the file rather than include it. Default is :data:`None` for :data:`False`. Returns the matched files (:class:`~collections.abc.Iterable` of :class:`str`). rYrgN)rrZru)r"rUrVrWrhrLs r#match_tree_filesPathSpec.match_tree_fileses1@   t\ R%   e  333r{)rr*)NN)-__name__ __module__ __qualname____firstlineno____doc__rrr$objectrqr4intr8rr=r@rr rrarrJrrSrrOSErrorr[ classmethodr r rrerrn staticmethodrcheck_match_filerErrruryr} match_tree__static_attributes__r+r&r#rr'sH hw/D  D c4 t D   +/++z#'+( +0+/0 ( 0z#'0{8$% 0>37!% %% Xwio. /% % {3 %B Dzhx'899: &  F+/%  % I %z#'% 4. % y %ND112+/z#' 0+/&  & ' &z#'& 4. & w &V37!% !8  !8!8 Xwio. /!8 !8 4. !8y!8L37!% !4  !4!4 Xwio. /!4 !4 4. !4sm!4Jr&N)rcollections.abcrr itertoolsrtypingrrrrr r r r rpatternrrrrrrrrrrrr+r&r#rs]    vZ( cvcr&