+ UBi3Rt^RIHt^RIHt^RIHtHtHtH t H t H t H t H t Ht^RIHt^RIHt^RIHtHtHtHtHtHtHt] !RRR 7t!R R]4tR #) 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)boundca]tRt^'toRtV3RlRltV3RlRltV3RlRltV3RlR ltV3R lR lt R!V3R lRllt R!V3RlRllt R"V3RlRllt ] V3RlRl4tR!RR /V3RlRlllt]!]P$4tR!V3RlRlltR!RR /V3RlRllltR"RR /V3RlRllltR"RR /V3RlRlllt]tR tVtR #)#rza The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. c4<V^8dQhRS[S[,RR/#)patternsreturnN)rr )format __classdict__s"6/usr/lib/python3.14/site-packages/pathspec/pathspec.py __annotate__PathSpec.__annotate__-s hw/Dc T\V\4'g \V4pWnR#)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&&r__init__PathSpec.__init__-s$ Hn - -8n8'/-r"c&<V^8dQhRS[RS[/#)rotherr)objectbool)rrs"rr r!=s   D r"c \V\4'dU\VPVP4p\;QJdRV4F 'dK R# R#!RV44#\ #)z Tests the equality of this path-spec with *other* (:class:`PathSpec`) by comparing their :attr:`~PathSpec.patterns` attributes. c3."TF wrW8HxK R#5iN).0abs& r "PathSpec.__eq__..Ds 1afsFT)r$rrrallNotImplemented)r'r+paired_patternss&& r__eq__PathSpec.__eq__=sT x   ?? # 1 1##1#1# 1 1 11 r"c <V^8dQhRS[/#)rr)int)rrs"rr r!Hscr"c ,\VP4#)zQ Returns the number of compiled patterns this path-spec contains (:class:`int`). )lenr)r's&r__len__PathSpec.__len__Hs T]] r"c*<V^8dQhRS[RRRS[/#rr'r+rrr)rrs"rr r!Os"4 tr"c \V\4'd-VPVPVP,4#\#)zW Combines the :attr:`Pathspec.patterns` patterns from two :class:`PathSpec` instances. )r$r __class__rr8r'r+s&&r__add__PathSpec.__add__Os3 x  ..7 88 r"c*<V^8dQhRS[RRRS[/#rCrD)rrs"rr r!Ys"  D   r"c \V\4'd&V;PVP, unV#\#)zc Adds the :attr:`Pathspec.patterns` patterns from one :class:`PathSpec` instance to this instance. )r$rrr8rGs&&r__iadd__PathSpec.__iadd__Ys. x  ==ENN"= ; r"Nc\<V^8dQhRS[RS[S[S[,,RS[S[,/#rfile separatorsr)rrrstrr)rrs"rr r!ds7+++z#'+( +r"c ~\W4pVP\VP4V4wrE\ WV4#)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'rPrQ 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 TypeErrorrrrrTr)r'r\rQ use_patterns orig_filerVrWrXs&&& r check_filesPathSpec.check_filesysh& e   VE9$89 ::' 6,ii49$$\=>7 Y //sA.A0c <V^8dQhRS[RS[S[S[.R3,,RS[S[,RS[S[S[,,/#)rrooton_errorN follow_linksr)rrrOSErrorr-rrrR)rrs"rr r!sQ%%% Xwio. /% % {3 %r"c# t"\P!WVR7pVPV4RjxL R#L5i)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`). rgrhN)r iter_tree_filesrc)r'rfrgrhr\s&&&& rcheck_tree_filesPathSpec.check_tree_filess-<   t\ R%   e $$$s -868c<V^8dQhRS[S[,RS[S[S[S[.S[3,3,RS[S[,RS[/#)rclspattern_factorylinesr)r rr rRrrr r)rrs"rr r!sP Dzhx'899: &  r"c 8\V\4'd\P!V4p\ V4'g\ RV: R24h\ V4'g\ RV: R24hVUu.uFq3'gK V!V4NK ppV!V4#uupi)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:r_)r$rRr lookup_patterncallabler`r)rprqrrliners&&& r from_linesPathSpec.from_liness*%%((9? / " " %o%88IJ KK e   VE9$89 ::05 >#od#( > X?s 3 B Bnegatec <V^8dQhRS[S[,RS[S[S[,,RS[S[,RS[S[,/#)rentriesrQryr)rrrrrRr-r)rrs"rr r!sJ%% I %z#'% 4. % y %r"c# "\V4'g\RV: R24h\VP4pVFIp\ VP V4pVP WF4wrxV'dV'*pV'gKEVxKK R#5i)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:r_N)rr`rrrpathrT) r'r{rQryraentryrVrW_indexs &&&$ r match_entriesPathSpec.match_entriessu2 g   Xg[(<= >>' 6,eejj*59%%l>?7 kG g Ks A9B  B cL<V^8dQhRS[RS[S[S[,,RS[/#rO)rrrrRr-)rrs"rr r!s2z#' r"c |\W4pVP\VP4V4wrE\ V4#)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`. )rrTrUrr-)r'rPrQrVrWrs&&& r match_filePathSpec.match_files5"T.)$$Yt}}%=yI/' gr"c <V^8dQhRS[S[,RS[S[S[,,RS[S[,RS[S[,/#)rr\rQryr)rrrrrRr-r)rrs"rr r!sJ&& ' &z#'& 4. & w &r"c# "\V4'g\RV: R24h\VP4pVF>p\ WR4pVP WF4wrxV'dV'*pV'gK:VxK@ R#5i)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`). r^r_N)rr`rrrrT) r'r\rQryrarbrVrWrs &&&$ r match_filesPathSpec.match_filesso4 e   VE9$89 ::' 6,ii49%%l>?7 kG g Os A.A?5 A?c <V^8dQhRS[RS[S[S[.R3,,RS[S[,RS[S[,RS[S[,/#rrfrgNrhryr)rrrrir-rr)rrs"rr r!BsZ!8!8!8 Xwio. /!8 !8 4. !8y!8r"c# v"\P!WVR7pVPWTR7RjxL R#L5i)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`). rkryN)r iter_tree_entriesr)r'rfrgrhryr{s&&&&$ rmatch_tree_entriesPathSpec.match_tree_entriesBs1@  " "4 V'     777 .979c <V^8dQhRS[RS[S[S[.R3,,RS[S[,RS[S[,RS[S[,/#r)rrrrir-rrR)rrs"rr r!esY!4!4!4 Xwio. /!4 !4 4. !4sm!4r"c# v"\P!WVR7pVPWTR7RjxL R#L5i)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`). rkrN)r rlr)r'rfrgrhryr\s&&&&$ rmatch_tree_filesPathSpec.match_tree_fileses1@   t\ R%   e  333r)rr0)NN)__name__ __module__ __qualname____firstlineno____doc__r(r:r@rHrLrYrcrm classmethodrwr staticmethodr check_match_filerTrrrr match_tree__static_attributes____classdictcell__)rs@rrr's     ++*008%%B@%  %%ND112 *&  &&P!8  !8!8F!4  !4!4Jr"N)rcollections.abcrr% itertoolsrtypingrrrrrr r r r patternr rrrrrrrrr,rr1r"rrs]    vZ( cvcr"