+ HjARt^RIHt^RIHtHtHtHt^RIH t ^RI H t H t H t HtHtHtHtHt]!RRR7t^RIHt^R IHtHtHt^R IHt^R IHt^R IHt^R I H!t!H"t"^RI#H$t$H%t%H&t&H't'H(t(H)t)H*t*H+t+!RR] ]',4t,R#)zn This module provides :class:`.PathSpec` which is an object-oriented interface for pattern matching of files. ) annotations) CollectionIterableIteratorSequence) zip_longest)CallableGenericLiteralOptionalTypeVarUnioncastoverloadSelfPathSpec)bound)util)BackendNamesHint_Backend_TestBackendFactoryHintmake_pathspec_backend)Pattern)GitIgnoreBasicPattern)AnyStr deprecated) CheckResultStrPathTPattern TPattern_coTStrPath TreeEntry _is_iterablenormalize_filec]tRt^7tRtRRRR/RRlltRRltR R ltR R ltR Rlt RRlt R2RRllt R2RRllt R3RRllt ]]RRRR/RRll44t]]RRRR/RRll44t]]RRRR/RRll44t]]RRRR/RRll44t]RRRR/RR ll4t]R!R"l4tR2R#R/R$R%llltR2R&R'lltR2R#R/R(R)llltR3R#R/R*R+lllt]!R,4R-R.l4tR3R#R/R/R0llltR1tR#)4rza The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. backendN_test_backend_factoryc(V^8dQhRRRRRRRR/#) patternsz3Union[Sequence[TPattern_co], Iterable[TPattern_co]]r&"Union[BackendNamesHint, str, None]r'rreturnNone)formats"ړ/home/ubuntu/.hermes/installs/5f0a1ff4045d044e/environments/88679baa1dc64374a0cd943b62eeefb9/venv/lib/python3.14/site-packages/pathspec/pathspec.py __annotate__PathSpec.__annotate__=s200 ?0 . 0 1 0  0c \V\4'dTpM \V4pVfRp\\V4pVe V!V4pMVP WT4pW`nWPnW@nR#)a Initializes the :class:`.PathSpec` instance. *patterns* (:class:`~collections.abc.Sequence` or :class:`~collections.abc.Iterable`) contains each compiled pattern (:class:`.Pattern`). If not a sequence, it will be converted to a :class:`list`. *backend* (:class:`str` or :data:`None`) is the pattern (regular expression) matching backend to use. Default is :data:`None` for "best" to use the best available backend. Priority of backends is: "re2", "hyperscan", "simple". The "simple" backend is always available. Nbest) isinstancerlistrr _make_backend_backend _backend_namer*)selfr*r&r' use_patterns backend_name use_backends&&$$ r0__init__PathSpec.__init__=sy&(##<x.< _ 7&0,&&|4;##L?;'- *6*6-r3cV^8dQhRR/#)r)r,strr.)r/s"r0r1r2osbbsbr3c lVPP RVP: RVP: R2#)z3 Returns a debug representation of this path-spec. z (patterns=z , backend=)) __class____name__r*r:r;s&r0__repr__PathSpec.__repr__os5 NN # # $Jt}}.?z$J\J\I__` aar3c$V^8dQhRRRRRR/#r)r;rotherrr,r.)r/s"r0r1r2us!4Tr3c \V\4'd6VP.VPOVPOVPR7#\ #)zh Combines the :attr:`self.patterns <.PathSpec.patterns>` patterns from two :class:`PathSpec` instances. )r&)r6rrEr*r:NotImplementedr;rLs&&r0__add__PathSpec.__add__usC x  ..:4==:5>>:DDVDV. WW r3c V^8dQhRRRR/#)r)rLobjectr,boolr.)r/s"r0r1r2s   D r3c \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:`self.patterns <.PathSpec.patterns>` attributes. c3."TF wrW8HxK R#5iNr.).0abs& r0 "PathSpec.__eq__..s 1afsFT)r6rrr*allrN)r;rLpaired_patternss&& r0__eq__PathSpec.__eq__sT x   ?? # 1 1##1#1# 1 1 11 r3c$V^8dQhRRRRRR/#rKr.)r/s"r0r1r2s!  D  d r3c \V\4'dM.VPOVPOVnVPVPVP4VnV#\ #)zh Adds the :attr:`self.patterns <.PathSpec.patterns>` from *other* (:class:`PathSpec`) to this instance. )r6rr*r8r:r9rNrOs&&r0__iadd__PathSpec.__iadd__sS x  4T]]4U^^44=%%d&8&8$--H4= ; r3cV^8dQhRR/#)r)r,intr.)r/s"r0r1r2scr3c ,\VP4#)zj Returns the number of :attr:`self.patterns <.PathSpec.patterns>` this path-spec contains (:class:`int`). )lenr*rGs&r0__len__PathSpec.__len__s T]] r3c$V^8dQhRRRRRR/#)r)filer! separatorsOptional[Collection[str]]r,zCheckResult[TStrPath]r.)r/s"r0r1r2s(+++(+ +r3c j\W4pVPPV4wrE\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 <.PathSpec.patterns>`. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`.normalize_file` for more information. Returns the file check result (:class:`.CheckResult`). )r$r9 match_filer)r;rlrm norm_fileincludeindexs&&& r0 check_filePathSpec.check_files1"T.)==++I6.' TE **r3c$V^8dQhRRRRRR/#)r)filesIterable[TStrPath]rmrnr,zIterator[CheckResult[TStrPath]]r.)r/s"r0r1r2s(00 0(0& 0r3c# "\V4'g\RV: R24hVF9p\W24pVPP V4wrV\ W5V4xK; R#5i)a Check the files against this path-spec. *files* (:class:`~collections.abc.Iterable` of :class:`str` or :class:`os.PathLike`) contains the file paths to be checked against :attr:`self.patterns <.PathSpec.patterns>`. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`.normalize_file` for more information. Returns an :class:`~collections.abc.Iterator` yielding each file check result (:class:`.CheckResult`). files: is not an iterable.N)r# TypeErrorr$r9rpr)r;rwrm orig_filerqrrrss&&& r0 check_filesPathSpec.check_filess^& e   VE9$89 ::ii49MM,,Y7>7 Y //sA#A%c(V^8dQhRRRRRRRR/#) r)rootron_error#Optional[Callable[[OSError], None]] follow_linksOptional[bool]r,zIterator[CheckResult[str]]r.)r/s"r0r1r2s2%%% 0% % ! %r3c# 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:`.CheckResult`). rrN)riter_tree_filesr~)r;rrrrws&&&& r0check_tree_filesPathSpec.check_tree_filess-<   t\ R%   e $$$s -868c 0V^8dQhRRRRRRRRR R R R /#) r)clstype[PathSpec]pattern_factoryzLiteral['gitignore']linesIterable[AnyStr]r&r+r'rr,zPathSpec[GitIgnoreBasicPattern]r.)r/s"r0r1r2sD'  .  1 &r3c R#rWr.rrrr&r's&&&$$r0 from_linesPathSpec.from_linesr3c 0V^8dQhRRRRRRRRR R R R /#) r)rrrrBrrr&r+r'rr,zPathSpec[Pattern]r.)r/s"r0r1r2sD  .  1 r3c R#rWr.rs&&&$$r0rrrr3c 0V^8dQhRRRRRRRRR R R R /#) r)rrrztype[TPattern]rrr&r+r'rr,PathSpec[TPattern]r.)r/s"r0r1r2sD!  .  1 r3c R#rWr.rs&&&$$r0rrrr3c 0V^8dQhRRRRRRRRR R R R /#) r)rrrzCallable[[AnyStr], TPattern]rrr&r+r'rr,rr.)r/s"r0r1r2sD/  .  1 r3c R#rWr.rs&&&$$r0rrrr3c 0V^8dQhRRRRRRRRR R R R /#) r)rz type[Self]rz6Union[str, type[Pattern], Callable[[AnyStr], Pattern]]rrr&r+r'rr,rr.)r/s"r0r1r2sD)))I) ) . ) 1 ) )r3c H\V\4'd\P!V4pM$\ V4'dTpM\ RV: R24h\ V4'g\ RV: R24hVUu.uFqf'gK V!V4NK ppV!WsVR7pV#uupi)ad 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`. *backend* (:class:`str` or :data:`None`) is the pattern (or regular expression) matching backend to use. Default is :data:`None` for "best" to use the best available backend. Priority of backends is: "re2", "hyperscan", "simple". The "simple" backend is always available. Returns the :class:`PathSpec` instance. zpattern_factory:z is not callable.zlines:r{)r&r')r6rBrlookup_patterncallabler|r#) rrrr&r' use_factory_PathSpec__liner*r;s &&&$$ r0rrs<%%$$_5;   ; %o%88IJ KK e   VE9$89 ::05 @f!k&!( @ X>S T$ +As 7 B Bc$V^8dQhRRRRRR/#)r)namerr*zSequence[Pattern]r,rr.)r/s"r0r1r2Ks&/// //r3c \W4#)aD .. warning:: This method is not part of the public API. It is subject to change. Create the backend for the patterns. *name* (:class:`str`) is the name of the backend. *patterns* (:class:`~collections.abc.Sequence` of :class:`.Pattern`) contains the compiled patterns. Returns the matcher (:class:`._Backend`). r)rr*s&&r0r8PathSpec._make_backendJs$ t ..r3negatec(V^8dQhRRRRRRRR/#) r)entrieszIterable[TreeEntry]rmrnrrr,Iterator[TreeEntry]r.)r/s"r0r1r2^s2$$ $($  $  $r3c# "\V4'g\RV: R24hVFSp\VPV4pVPP V4wrgV'dV'*pV'gKOVxKU R#5i)a Matches the entries to this path-spec. *entries* (:class:`~collections.abc.Iterable` of :class:`.TreeEntry`) contains the entries to be matched against :attr:`self.patterns <.PathSpec.patterns>`. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`.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:`.TreeEntry`). zentries:r{N)r#r|r$pathr9rp)r;rrmrentryrqrr_indexs&&&$ r0 match_entriesPathSpec.match_entries^sk2 g   Xg[(<= >>eejj*59]]--i8?7 kG g Ks A.A?5 A?c$V^8dQhRRRRRR/#)r)rlrrmrnr,rTr.)r/s"r0r1r2s(( r3c h\W4pVPPV4wrE\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 <.PathSpec.patterns>`. *separators* (:class:`~collections.abc.Collection` of :class:`str`) optionally contains the path separators to normalize. See :func:`.normalize_file` for more information. Returns :data:`True` if *file* matched; otherwise, :data:`False`. )r$r9rprT)r;rlrmrqrrrs&&& r0rpPathSpec.match_files."T.)MM,,Y7/' gr3c(V^8dQhRRRRRRRR/#) r)rwrxrmrnrrr,zIterator[TStrPath]r.)r/s"r0r1r2s2%% %(%  %  %r3c# "\V4'g\RV: R24hVFHp\WB4pVPP V4wrgV'dV'*pV'gKDVxKJ 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 <.PathSpec.patterns>`. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`.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`). rzr{N)r#r|r$r9rp)r;rwrmrr}rqrrrs&&&$ r0 match_filesPathSpec.match_filesse4 e   VE9$89 ::ii49]]--i8?7 kG g Os A#A4* A4c ,V^8dQhRRRRRRRRRR /#) r)rrrrrrrr,rr.)r/s"r0r1r2s<!8!8!8 0!8 !8  !8!8r3c# 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`). rrN)riter_tree_entriesr)r;rrrrrs&&&&$ r0match_tree_entriesPathSpec.match_tree_entriess1@  " "4 V'     777 .979zEPathSpec.match_tree() is deprecated. Use .match_tree_files() instead.cV^8dQhRR/#)r)r, Iterator[str]r.)r/s"r0r1r2s,,m,r3c &VP!V/VB#)z .. version-deprecated:: 0.3.2 This is an alias for the :meth:`self.match_tree_files <.PathSpec.match_tree_files>` method. )match_tree_files)r;argskws&*,r0 match_treePathSpec.match_trees    + ++r3c ,V^8dQhRRRRRRRRRR /#) r)rrrrrrrr,rr.)r/s"r0r1r2s< 4 4 4 0 4 4  4 4r3c# 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`). rrN)rrr)r;rrrrrws&&&&$ r0rPathSpec.match_tree_filess0>   t\ R%   e  333r)r9r:r*rW)NN)rF __module__ __qualname____firstlineno____doc__r?rHrPr_rcrirtr~rr classmethodr staticmethodr8rrprrrrr__static_attributes__r.r3r0rr7s 015 0 48 0db   +*06%B   15  48     15  48     15  48     15  48  ) 15 ) 48 ))V//&$  $$L*%  %%N!8  !8!8H I,, 4  4 4r3N)-r __future__rcollections.abcrrrr itertoolsrtypingrr r r r r rrrpathspecrpathspec.backendrrrpathspec._backends.aggrpathspec.patternr!pathspec.patterns.gitignore.basicrpathspec._typingrr pathspec.utilrrrr r!r"r#r$rr.r3r0rs#     vZ(   X4w{#X4r3