+ ri`,Rt^RIt^RIt^RIt^RIt^RIt^RIHtHtH t H t ^RI H t ^RI HtHtHtHtHtHt^RIHt^RIHtHt]]]P4],3,t]!R]R7t]P:]P<3Uu.uF"pV'gK V]P:8wgK VNK$ upt/t R R lt!R7R R llt"R7R Rllt#RRlt$RRlt%]!R4R8Rl4t&R8RRllt'RRlt(R8RRllt)RRlt*RRlt+RR lt,]!R!4R"R#l4t-R7R$R%llt.]!R&4R7R'R(ll4t/R7R)R*llt0!R+R,]14t2!R-R.]14t3] !R/R07!R1R2]],44t4!R3R4]54t6!R5R6]54t7R#uupi)9zC This module provides utility methods for dealing with path-specs. N) CollectionIterableIteratorSequence) dataclass)AnyCallableGenericOptionalTypeVarUnion)Pattern)AnyStr deprecatedTStrPath)boundcDV^8dQhR\PR\/#)pathreturn)pathlibPathstr)formats"//usr/lib/python3/dist-packages/pathspec/util.py __annotate__r9s#cv\V4pVP4'dV\P, pV#)a. Appends the path separator to the path if the path is a directory. This can be used to aid in distinguishing between directories and files on the file-system by relying on the presence of a trailing path separator. *path* (:class:`pathlib.Path`) is the path to use. Returns the path (:class:`str`). )ris_dirossep)rstr_paths& rappend_dir_sepr"9s+ IKKMM bff(rc V^8dQhR\\\\3,,R\R\ \ ,R\\ \ ,\ \,3,/#)rpatternsfile is_reversedr)rtupleintr rr bool)rs"rrrJsT) ) E#w,' ()  ) tn)  8D>8C= () ) rcV'dAVF8wr4VPfKVPV4fK*VPV3u# R#RpRpVF8wr4VPfKVPV4fK*VPpTpK: WV3#)a Check the file against the patterns. *patterns* (:class:`~collections.abc.Iterable`) yields each indexed pattern (:class:`tuple`) which contains the pattern index (:class:`int`) and actua pattern (:class:`.Pattern`). *file* (:class:`str`) is the normalized file path to be matched against *patterns*. *is_reversed* (:class:`bool` or :data:`None`) is whether the order of the patterns has been reversed. Default is :data:`None` for :data:`False`. Reversing the order of the patterns is an optimization. Returns a :class:`tuple` containing whether to include *file* (:class:`bool` or :data:`None`), and the index of the last matched pattern (:class:`int` or :data:`None`). NNNinclude match_file)r$r%r&indexpattern out_include out_indexs&&& rcheck_match_filer3Js.!ne oo!g&8&8&>&J ??E !!! !%+!) ne oo!g&8&8&>&J//KI!  rc V^8dQhR\\,R\\,R\\,R\ \R3,/#)rr$files all_matchesr MatchDetail)rr rr r)dict)rs"rrrvsG++ G + +tn+ #}  +rc\V\4'dTM \V4p/pVFpVPfKVP V4pVP'dbVFYpWt9dCV'd$WG,P P V4K4WTV,P ^&KK\V.4WG&K[ KVFpWHK K V#)a Matches the files to the patterns, and returns which patterns matched the files. *patterns* (:class:`~collections.abc.Iterable` of :class:`.Pattern`) contains the patterns to use. *files* (:class:`~collections.abc.Iterable` of :class:`str`) contains the normalized file paths to be matched against *patterns*. *all_matches* (:class:`bool` or :data:`None`) is whether to return all matches patterns (:data:`True`), or only the last matched pattern (:data:`False`). Default is :data:`None` for :data:`False`. Returns the matched files (:class:`dict`) which maps each matched file (:class:`str`) to the patterns that matched in order (:class:`.MatchDetail`). ) isinstancerlistr-matchr$appendr7) r$r5r6 all_files return_filesr0 result_files result_filer%s &&& rdetailed_match_filesrBvs,! 33UeW __ -- *< ooo# #  ))009/6K ))!,"-wi"8l$  !& rc~V^8dQhR\\,R\\\\3,,/#)rr$r)rr r;r'r()rs"rrrs/ G  %W rcn\V4UUu.uFwrVPfKW3NK upp#uuppi)a Filters out null-patterns. *patterns* (:class:`~collections.abc.Iterable` of :class:`.Pattern`) contains the patterns. Returns a :class:`list` containing each indexed pattern (:class:`tuple`) which contains the pattern index (:class:`int`) and the actual pattern (:class:`.Pattern`). ) enumerater-)r$__index__pats& r_filter_check_patternsrHs<"(+ +ng ]]7+  s11c0V^8dQhR\R\/#)rvaluer)rr))rs"rrrsLLLLrch\V\4;'d\V\\34'*#)z Check whether the value is an iterable (excludes strings). *value* is the value to check, Returns whether *value* is an iterable (:class:`bool`). )r:rrbytes)rJs&r _is_iterablerMs' 5(#KKJusEl,K(KKrzGpathspec.util.iter_tree() is deprecated. Use iter_tree_files() instead.c\WVR7#)zd .. version-deprecated:: 0.10.0 This is an alias for the :func:`.iter_tree_files` function. )on_error follow_links)iter_tree_filesrootrOrPs&&&r iter_treerTs lKKrc V^8dQhR\R\\\.R3,,R\\,R\ R,/#)rrSrONrPr TreeEntry)StrPathr rOSErrorr)r)rs"rrrsO[[[ HgY_- .[~[k [rc#"Ve"\V4'g\RV: R24hVfRp\\PP V4R/W4RjxL R#L5i)a Walks the specified directory for all files and directories. *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`. Raises :exc:`.RecursionError` if recursion is detected. Returns an :class:`~collections.abc.Iterator` yielding each file or directory entry (:class:`.TreeEntry`) relative to *root*. N on_error: is not callable.T)callable TypeError_iter_tree_entries_nextrrabspathrRs&&&riter_tree_entriesrasX0 (!3!3Ih\):;<<, #BGGOOD$92r8 ZZZAA%A#A%c V^8dQhR\R\R\\\3,R\\.R3,R\R\ R,/#) r root_fulldir_relmemorONrPrrVrr8rrXr)r)rs"rrrsdLL L L CH~L WItO $ L  L k Lrc #"\PPW4p\PPV4pWb9dWV&M\ WbV,VR7h\P !V4;_uu_4pVFp\PPWP 4p VPRR7p TP4'dTP4p MT p TPTR7'd1\TP YT 4x\Y Y#T4RjxL KTP4'gTP4'gK\TP YT 4xK RRR4W&R# \dp Te T!T 4Rp ? EK&Rp ? ii;i \dp Te T!T 4Rp ? EKLRp ? ii;iL +'giLb;i5i)ad Scan the directory for all descendant files. *root_full* (:class:`str`) the absolute path to the root directory. *dir_rel* (:class:`str`) the path to the directory to scan relative to *root_full*. *memo* (:class:`dict`) keeps track of ancestor directories encountered. Maps each ancestor real path (:class:`str`) to relative path (:class:`str`). *on_error* (:class:`~collections.abc.Callable` or :data:`None`) optionally is the error handler for file-system exceptions. *follow_links* (:class:`bool`) is whether to walk symbolic links that resolve to directories. Yields each entry (:class:`.TreeEntry`).  real_path first_path second_pathFfollow_symlinksN)rrjoinrealpathRecursionErrorscandirnamestatrX is_symlinkrrVr_is_file) rdrerfrOrPdir_fulldir_real scan_iternode_entnode_rel node_lstate node_stats &&&&& rr_r_s4 GGLL , GG  X & x.8nRYZZjjihggll7MM28 u5J Y Ioolo33 HMM8 CC&yDLYYYh1133 HMM8 CC?P ^A   a[   qk Z;sA/G.F GF/'G)G+G ,GG G= G* F,  F' G'F, ,G/ G : G G G G G' "G*c V^8dQhR\R\\\.R3,,R\\,R\ \ ,/#)rrSrONrPr)rWr rrXr)rr)rs"rrr>sNYYY HgY_- .Y~Yc] Yrc#"Ve"\V4'g\RV: R24hVfRp\\PP V4R/W4RjxL R#L5i)a Walks the specified directory for all files. *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`. Raises :exc:`.RecursionError` if recursion is detected. Returns an :class:`~collections.abc.Iterator` yielding the path to each file (:class:`str`) relative to *root*. NrZr[Tr\)r]r^_iter_tree_files_nextrrr`rRs&&&rrQrQ>sX2 (!3!3Ih\):;<<, !"''//$"7R XXXrbc V^8dQhR\R\R\\\3,R\\.R3,R\R\ \,/#)rrdrerfrONrPrrg)rs"rrr`s[;; ; ; CH~; WItO $ ;  ; c] ;rc #"\PPW4p\PPV4pWb9dWV&M\ WbV,VR7h\P !V4;_uu_4pVFp\PPWP 4p VPVR7'd\W W#V4RjxL K[VP4'dV xKwV'dKVP4'gKV xK RRR4W&R#LX +'giL;i5i)aa Scan the directory for all descendant files. *root_full* (:class:`str`) the absolute path to the root directory. *dir_rel* (:class:`str`) the path to the directory to scan relative to *root_full*. *memo* (:class:`dict`) keeps track of ancestor directories encountered. Maps each ancestor real path (:class:`str`) to relative path (:class:`str`). *on_error* (:class:`~collections.abc.Callable` or :data:`None`) optionally is the error handler for file-system exceptions. *follow_links* (:class:`bool`) is whether to walk symbolic links that resolve to directories. Yields each file path (:class:`str`). rirmN) rrrorprqrrrsrrrvru) rdrerfrOrPrwrxryrzr{s &&&&& rrr`s4 GGLL , GG  X & x.8nRYZZjjihggll7MM28oolo33%Y$,WWW N LX0022 N. ^XsCAAD0D. D02 D0D0D0" E.D00 E ;EcTV^8dQhR\R\\.\3,/#)rrsrrrrr )rs"rrrs& # # #6(G*;!< #rc\V,#)z Lookups a registered pattern factory by name. *name* (:class:`str`) is the name of the pattern factory. Returns the registered pattern factory (:class:`~collections.abc.Callable`). If no pattern factory is registered, raises :exc:`KeyError`. )_registered_patterns)rss&rlookup_patternrs T""rcRV^8dQhR\\,R\R\/#)rr$r%r)rr rr))rs"rrrs&'*#$rc~RpVF4pVPfKVPV4fK(VPpK6 V#)a Matches the file to the patterns. *patterns* (:class:`~collections.abc.Iterable` of :class:`.Pattern`) contains the patterns to use. *file* (:class:`str`) is the normalized file path to be matched against *patterns*. Returns :data:`True` if *file* matched; otherwise, :data:`False`. Fr,)r$r%matchedr0s&& rr.r.s= W __ W%7%7%=%I __7 rz[pathspec.util.match_files() is deprecated. Use match_file() with a loop for better results.c~V^8dQhR\\,R\\,R\\,/#)rr$r5r)rr rset)rs"rrrs3 G   XrcVUu.uFq"PfKVNK pp\4pVF'p\W54'gKVPV4K) V#uupi)a .. version-deprecated:: 0.10.0 This function is no longer used. Use the :func:`.match_file` function with a loop for better results. Matches the files to the patterns. *patterns* (:class:`~collections.abc.Iterable` of :class:`.Pattern`) contains the patterns to use. *files* (:class:`~collections.abc.Iterable` of :class:`str`) contains the normalized file paths to be matched against *patterns*. Returns the matched files (:class:`set` of :class:`str`). )r-rr.add)r$r5rG use_patternsr?r%s&& r match_filesrsV.%-JH5 HJ T ##D Ks AAchV^8dQhR\R\\\,,R\/#)rr% separatorsr)rWr rr)rs"rrrs/%%% jo &% %rcVf\p\P!V4pVF#pVPV\P 4pK% VP R4'd VR,pV#VP R4'd VR,pV#)aw Normalizes the file path to use the POSIX path separator (i.e., ``"/"``), and make the paths relative (remove leading ``"/"``). *file* (:class:`str` or :class:`os.PathLike`) is the file path. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. This does not need to include the POSIX path separator (``"/"``), but including it will not affect the results. Default is ``None`` for :data:`.NORMALIZE_PATH_SEPS`. To prevent normalization, pass an empty container (e.g., an empty tuple ``()``). Returns the normalized file path (:class:`str`). /:NNz./:rNN)NORMALIZE_PATH_SEPSrfspathreplace posixpathr startswith)r%r norm_filer s&& rnormalize_filers("*))D/ SY]]3) m)  4  m)rzcpathspec.util.normalize_files() is deprecated. Use normalize_file() with a loop for better results.c V^8dQhR\\,R\\\,,R\ \\ \,3,/#)rr5rr)rrWr rrr8r;)rs"rrr sB jo & #tG} rc|/pVF3p\W1R7pWB9dW$,PV4K.V.W$&K5 V#)a .. version-deprecated:: 0.10.0 This function is no longer used. Use the :func:`.normalize_file` function with a loop for better results. Normalizes the file paths to use the POSIX path separator. *files* (:class:`~collections.abc.Iterable` of :class:`str` or :class:`os.PathLike`) contains the file paths to be normalized. *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 a :class:`dict` mapping each normalized file path (:class:`str`) to the original file paths (:class:`list` of :class:`str` or :class:`os.PathLike`). )r)rr=)r5r norm_filesrrs&& rnormalize_filesrsF4 TT9) % 6:  rczV^8dQhR\R\\.\3,R\\ ,RR/#)rrspattern_factoryoverriderN)rrrr r r))rs"rrr,s@.. .F8W,-. D>. .rc\V\4'g\RV: R24h\V4'g\RV: R24hV\9d V'g\ V\V,4hV\V&R#)a; Registers the specified pattern factory. *name* (:class:`str`) is the name to register the pattern factory under. *pattern_factory* (:class:`~collections.abc.Callable`) is used to compile patterns. It must accept an uncompiled pattern (:class:`str`) and return the compiled pattern (:class:`.Pattern`). *override* (:class:`bool` or :data:`None`) optionally is whether to allow overriding an already registered pattern under the same name (:data:`True`), instead of raising an :exc:`.AlreadyRegisteredError` (:data:`False`). Default is :data:`None` for :data:`False`. zname:z is not a string.zpattern_factory:r[N)r:rr^r]rAlreadyRegisteredError)rsrrs&&&rregister_patternr,sq& 4E$!2344!!$_$77HIJJ  t%9$%?@@-drcaa]tRtRtoRtV3RlV3Rllt]V3RlRl4t]V3RlRl4t]V3R lR l4t R t Vt V;t #) riKzy The :exc:`AlreadyRegisteredError` exception is raised when a pattern factory is registered under a name already in use. cB<V^8dQhRS[RS[S[.S[3,RR/#)rrsrrNr)r __classdict__s"rr#AlreadyRegisteredError.__annotate__Qs5 * *  *VHg-. * *rc &<\SV`W4R#)z Initializes the :exc:`AlreadyRegisteredError` instance. *name* (:class:`str`) is the name of the registered pattern. *pattern_factory* (:class:`~collections.abc.Callable`) is the registered pattern factory. Nsuper__init__)selfrsr __class__s&&&rrAlreadyRegisteredError.__init__Qs'4)rc <V^8dQhRS[/#rrr)rrs"rrracrc >VP: RVP: R2#)0 *message* (:class:`str`) is the error message. z+ is already registered for pattern factory=.)rsrrs&rmessageAlreadyRegisteredError.message`s(  ii]= Q rc <V^8dQhRS[/#rr)rrs"rrrks3rc (VP^,#)z> *name* (:class:`str`) is the name of the registered pattern. argsrs&rrsAlreadyRegisteredError.namejs 1rc8<V^8dQhRS[S[.S[3,/#r)rrr )rrs"rrrrs hx'89rc (VP^,#)z[ *pattern_factory* (:class:`~collections.abc.Callable`) is the registered pattern factory. rrs&rr&AlreadyRegisteredError.pattern_factoryq 1r) __name__ __module__ __qualname____firstlineno____doc__rpropertyrrsr__static_attributes____classdictcell__ __classcell__rrs@@rrrKsU * *       rrcaa]tRtRtoRtV3RlV3Rllt]V3RlRl4t]V3RlRl4t]V3R lR l4t ]V3R lR l4t R t Vt V;t #)rqizzK The :exc:`RecursionError` exception is raised when recursion is detected. c0<V^8dQhRS[RS[RS[RR/#)rrjrkrlrNr)rrs"rrRecursionError.__annotate__s377 77 7  7rc (<\SV`WV4R#)a Initializes the :exc:`RecursionError` instance. *real_path* (:class:`str`) is the real path that recursion was encountered on. *first_path* (:class:`str`) is the first path encountered for *real_path*. *second_path* (:class:`str`) is the second path encountered for *real_path*. Nr)rrjrkrlrs&&&&rrRecursionError.__init__s '9+6rc <V^8dQhRS[/#rr)rrs"rrrsrc (VP^,#)zr *first_path* (:class:`str`) is the first path encountered for :attr:`self.real_path `. rrs&rrkRecursionError.first_pathrrc <V^8dQhRS[/#rr)rrs"rrrrrc \RVP: RVP: RVP: R2#)rz Real path z was encountered at z and then rrirs&rrRecursionError.messages: !!5doo5HI"!%rc <V^8dQhRS[/#rr)rrs"rrrsrc (VP^,#)zP *real_path* (:class:`str`) is the real path that recursion was encountered on. rrs&rrjRecursionError.real_pathrrc <V^8dQhRS[/#rr)rrs"rrrs#rc (VP^,#)zt *second_path* (:class:`str`) is the second path encountered for :attr:`self.real_path `. rrs&rrlRecursionError.second_pathrrr)rrrrrrrrkrrjrlrrrrs@@rrqrqzsi77$        rrqT)frozenc:a]tRtRtoRtRtV3RltRtVtR#) CheckResultizb The :class:`CheckResult` class contains information about the file and which pattern matched it. c^<V^8dQh/S[;R&S[S[,;R&S[S[,;R&#)rr%r-r/)rr r)r()rrs"rrCheckResult.__annotate__s3& 4.'2  3rrN)r%r-r/) rrrrr __slots____annotate_func__rrrs@rrrs'   5rrc:a]tRtRtoRtRtV3RlRltRtVtR#)r7iz< The :class:`.MatchDetail` class contains information about c4<V^8dQhRS[S[,RR/#)rr$rN)rr )rrs"rrMatchDetail.__annotate__s  hw/ D rc WnR#)z Initialize the :class:`.MatchDetail` instance. *patterns* (:class:`~collections.abc.Sequence` of :class:`.Pattern`) contains the patterns that matched the file in the order they were encountered. Nr$)rr$s&&rrMatchDetail.__init__s-rrN) rrrrrrrrrrs@rr7r7s   rr7ca]tRtRtoRtRtV3RlRltRV3RlRlltRV3RlR lltV3R lR lt RV3R lR llt Rt Vt R#)rVizN The :class:`TreeEntry` class contains information about a file-system entry. c ^<V^8dQhRS[RS[RS[PRS[PRR/#)rrsrlstatrtrN)rr stat_result)rrs"rrTreeEntry.__annotate__sE&& & &  &  &  &rc <W0nWnW nW@nR#)a? Initialize the :class:`TreeEntry` instance. *name* (:class:`str`) is the base name of the entry. *path* (:class:`str`) is the relative path of the entry. *lstat* (:class:`os.stat_result`) is the stat result of the direct entry. *stat* (:class:`os.stat_result`) is the stat result of the entry, potentially linked. N_lstatrsr_stat)rrsrrrts&&&&&rrTreeEntry.__init__s2(!&+)) $*rNc6<V^8dQhRS[S[,RS[/#rrPrr r))rrs"rrrs)))$)rc VfRpV'd VPM VPp\P!VP4#)a0 Get whether the entry is a directory. *follow_links* (:class:`bool` or :data:`None`) is whether to follow symbolic links. If this is :data:`True`, a symlink to a directory will result in :data:`True`. Default is :data:`None` for :data:`True`. Returns whether the entry is a directory (:class:`bool`). T)rrrtS_ISDIRst_moderrPr~s&& rrTreeEntry.is_dir5<(djjdkk) i'' ((rc6<V^8dQhRS[S[,RS[/#rr)rrs"rrr,s))$)4)rc VfRpV'd VPM VPp\P!VP4#)a9 Get whether the entry is a regular file. *follow_links* (:class:`bool` or :data:`None`) is whether to follow symbolic links. If this is :data:`True`, a symlink to a regular file will result in :data:`True`. Default is :data:`None` for :data:`True`. Returns whether the entry is a regular file (:class:`bool`). T)rrrtS_ISREGrrs&& rrvTreeEntry.is_file,rrc <V^8dQhRS[/#r)r))rrs"rrr<s+++rc V\P!VPP4#)z? Returns whether the entry is a symbolic link (:class:`bool`). )rtS_ISLNKrrrs&rruTreeEntry.is_symlink<s dkk)) **rcJ<V^8dQhRS[S[,RS[P/#r)r r)rr)rrs"rrrBs# 5 5htn 5 5rc NVfRpV'd VP#VP#)a- Get the cached stat result for the entry. *follow_links* (:class:`bool` or :data:`None`) is whether to follow symbolic links. If this is :data:`True`, the stat result of the linked file will be returned. Default is :data:`None` for :data:`True`. Returns that stat result (:class:`os.stat_result`). T)rr)rrPs&&rrtTreeEntry.statBs$<#44r)rrrsrrN) rrrrrrrrrvrurtrrrs@rrVrVsI 1&&P)) )) ++ 5 5 5rrVrr+)8rros.pathrrrtcollections.abcrrrr dataclassesrtypingrrr r r r r0r _typingrrrPathLikerWrr altseprrr"r3rBrHrMrTrar_rQrrr.rrrr Exceptionrrqrobjectr7rV)__seps0rrs        R[[%% & :W - vvryy!!U y}}$!  ") X+\(L JLL[BL^YD;| #(  :%P  B.>,Y,^7Y7t $'(#>&0c5c5Ms FF*F