+ Hjca0t$Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RI H t H t H t H t ^RIHt^RIHtHtHtHtHtHtHt^RIHt^RIHtHt]]]P<],3,t]!R]R 7t ]!R ]R R 7t!]!R ]R 7t"]PF]PH3Uu.uF)pV'gK V]PF8wgK ]!]V4NK+ upt%/t&R]'R&RRlt(R=RRllt)R=RRllt*RRlt+RRlt,]!R4R>Rl4t-R>RRllt.RRlt/R>R R!llt0R"R#lt1R$R%lt2R&R'lt3]!R(4R)R*l4t4R=R+R,llt5]!R-4R=R.R/ll4t6R=R0R1llt7!R2R3]84t9!R4R5]84t:]!R R67!R7R8]]",44t;!R9R:]<4t=!R;R<]<4t>R#uupi)?zC This module provides utility methods for dealing with path-specs. ) annotationsN) CollectionIterableIteratorSequence) dataclass)AnyCallableGenericOptionalTypeVarUnioncast)Pattern)AnyStr deprecatedTPattern)bound TPattern_coT)r covariantTStrPathz1dict[str, Callable[[Union[str, bytes]], Pattern]]_registered_patternsc V^8dQhRRRR/#)pathz pathlib.Pathreturnstr)formats"ڏ/home/ubuntu/.hermes/installs/5f0a1ff4045d044e/environments/50f6b671e3f94b538e344231dfcb664f/venv/lib/python3.14/site-packages/pathspec/util.py __annotate__r Gs#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'Gs+ IKKMM bff(r!c(V^8dQhRRRRRRRR/#) rpatternszIterable[tuple[int, Pattern]]filer is_reversedOptional[bool]rz$tuple[Optional[bool], Optional[int]]r)rs"rr r Xs0) ) ()  ) ) * ) r!cV'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_filer6Xs.!ne oo!g&8&8&>&J ??E !!! !%+!) ne oo!g&8&8&>&J//KI!  r!c(V^8dQhRRRRRRRR/#) rr)Iterable[Pattern]files Iterable[str] all_matchesr,rzdict[str, MatchDetail]r)rs"rr r s0,, ,,, ,r!c\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`). ) isinstancerlistr0matchr)append MatchDetail) r)r9r; all_files return_filesr3 result_files result_filer*s &&& rdetailed_match_filesrFs,! 33Ue(*W __ -- *< ooo# #  ))009/6K ))!,"-wi"8l$  #( r!c V^8dQhRRRR/#)rr)r8rzlist[tuple[int, Pattern]]r)rs"rr r s r!cn\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`). ) enumerater0)r)__index__pats& r_filter_check_patternsrLs<"(+ +ng ]]7+  s11c V^8dQhRRRR/#)rvaluerrboolr)rs"rr r sLLLLr!ch\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)rNs&r _is_iterablerRs' 5(#KKJusEl,K(KKr!zGpathspec.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_filesrootrTrUs&&&r iter_treerYs lKKr!c(V^8dQhRRRRRRRR/#) rrXStrPathrT#Optional[Callable[[OSError], None]]rUr,rIterator['TreeEntry']r)rs"rr r s6[[[ .[[ [r!c#"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_nextr$rabspathrWs&&&riter_tree_entriesrfsX0 (!3!3Ih\):;<<, #BGGOOD$92r8 ZZZAA%A#A%c 0V^8dQhRRRRRRRRRR R R /#) r root_fullrdir_relmemodict[str, str]rTr\rUrOrr]r)rs"rr r sLLL L LL / L  L  Lr!c #"\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)r$rjoinrealpathRecursionErrorscandirnamestatOSError is_symlinkr# TreeEntryrdis_file) rirjrkrTrUdir_fulldir_real scan_iternode_entnode_rel node_lstate node_stats &&&&& rrdrds4 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^8dQhRRRRRRRR/#) rrXr[rTr\rUr,r Iterator[str]r)rs"rr r Ms6YYY .YY Yr!c#"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*. Nr_r`Tra)rbrc_iter_tree_files_nextr$rrerWs&&&rrVrVMsX2 (!3!3Ih\):;<<, !"''//$"7R XXXrgc 0V^8dQhRRRRRRRRRR R R /#) rrirrjrkrlrTr\rUrOrrr)rs"rr r osD;; ; ;; / ;  ;  ;r!c #"\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`). rnrrN) r$rrtrurvrwrxr#rr}r{) rirjrkrTrUr~rrrrs &&&&& rrros4 GGLL , GG  X & x.8nRYZZjjihggll7MM28oolo33%Y$,WWW N LX0022 N. ^XsCAAD0D. D02 D0D0D0" E.D00 E ;Ec V^8dQhRRRR/#)rrxrrzCallable[[AnyStr], Pattern]r)rs"rr r s # # #!< #r!c\V,#)z Looks up 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`. )r)rxs&rlookup_patternrs T""r!c$V^8dQhRRRRRR/#)rr)r8r*rrrOr)rs"rr r s"*#$r!c~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*matchedr3s&& rr1r1s= W __ W%7%7%=%I __7 r!z[pathspec.util.match_files() is deprecated. Use match_file() with a loop for better results.c$V^8dQhRRRRRR/#)rr)r8r9r:rzset[str]r)rs"rr r s& r!cVUu.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`). )r0setr1add)r)r9rK use_patternsrCr*s&& r match_filesrsV.%-JH5 HJ T ##D Ks AAc$V^8dQhRRRRRR/#)rr*r[ separatorsOptional[Collection[str]]rrr)rs"rr r s&''' &' 'r!c2Vf\pVfQV4h\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_SEPSr$fspathreplace posixpathr% startswith)r*r norm_filer%s&& rnormalize_filers("** *))D/ SY]]3) m)  4  m)r!zcpathspec.util.normalize_files() is deprecated. Use normalize_file() with a loop for better results.c$V^8dQhRRRRRR/#)rr9zIterable[StrPath]rrrzdict[str, list[StrPath]]r)rs"rr r s& &r!c|/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@)r9r norm_filesrrs&& rnormalize_filesrsF4)+ TT9) % 6:  r!c(V^8dQhRRRRRRRR/#) rrxrpattern_factoryzVP: RVP: R2#)0 *message* (:class:`str`) is the error message. z+ is already registered for pattern factory=.)rxrrs&rmessageAlreadyRegisteredError.messageqs(  ii]= Q r!cV^8dQhRR/#rr)rs"rr r|s3r!c (VP^,#)z> *name* (:class:`str`) is the name of the registered pattern. argsrs&rrxAlreadyRegisteredError.name{s 1r!cV^8dQhRR/#)rrrr)rs"rr rsDr!c (VP^,#)z[ *pattern_factory* (:class:`~collections.abc.Callable`) is the registered pattern factory. rrs&rr&AlreadyRegisteredError.pattern_factory 1r!r) __name__ __module__ __qualname____firstlineno____doc__rpropertyrrxr__static_attributes__ __classcell__rs@rrr\sN * *       r!rca]tRtRtRtRV3Rllt]RRl4t]RRl4t]R R l4t ]R R l4t R t V;t #)rvizK The :exc:`RecursionError` exception is raised when recursion is detected. c(V^8dQhRRRRRRRR/#)rrorrprqrrr)rs"rr RecursionError.__annotate__s277 77 7  7r!c (<\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)rrorprqrs&&&&rrRecursionError.__init__s '9+6r!cV^8dQhRR/#rr)rs"rr rsr!c (VP^,#)zr *first_path* (:class:`str`) is the first path encountered for :attr:`self.real_path `. rrs&rrpRecursionError.first_pathrr!cV^8dQhRR/#rr)rs"rr rrr!c \RVP: RVP: RVP: R2#)rz Real path z was encountered at z and then rrnrs&rrRecursionError.messages: !!5doo5HI"!%r!cV^8dQhRR/#rr)rs"rr rsr!c (VP^,#)zP *real_path* (:class:`str`) is the real path that recursion was encountered on. rrs&rroRecursionError.real_pathrr!cV^8dQhRR/#rr)rs"rr rs#r!c (VP^,#)zt *second_path* (:class:`str`) is the second path encountered for :attr:`self.real_path `. rrs&rrqRecursionError.second_pathrr!r) rrrrrrrrprrorqrrrs@rrvrvsb77$        r!rv)frozencB]tRtRt$RtR tR]R&R]R&R]R&R tR #) CheckResultizb The :class:`CheckResult` class contains information about the file and which pattern matched it. r*r0r2rr,z Optional[int]rN)r*r0r2)rrrrr __slots____annotations__rrr!rrrs4    r!rc*]tRtRtRtRtRRltRtR#)rAiz< The :class:`.MatchDetail` class contains information about c V^8dQhRRRR/#)rr)zSequence[Pattern]rrr)rs"rr MatchDetail.__annotate__s  / D r!c 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-r!rN)rrrrrrrrrr!rrArAs   r!rAcf]tRtRtRtRtRRltRRRlltRRR lltR R lt RR R llt Rt R#)r|izN The :class:`TreeEntry` class contains information about a file-system entry. c ,V^8dQhRRRRRRRRRR/#) rrxrrlstatos.stat_resultryrrr)rs"rr TreeEntry.__annotate__s<&& & &  &  &  &r!c <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_lstatrxr_stat)rrxrrrys&&&&&rrTreeEntry.__init__s2(!&+)) $*r!Nc V^8dQhRRRR/#rrUr,rrOr)rs"rr r-s)))$)r!c 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)rrryS_ISDIRst_moderrUrs&& rr#TreeEntry.is_dir-5<(djjdkk) i'' ((r!c V^8dQhRRRR/#rr)rs"rr r=s)))4)r!c 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)rrryS_ISREGrrs&& rr}TreeEntry.is_file=rr!cV^8dQhRR/#)rrrOr)rs"rr rMs+++r!c V\P!VPP4#)z? Returns whether the entry is a symbolic link (:class:`bool`). )ryS_ISLNKrrrs&rr{TreeEntry.is_symlinkMs dkk)) **r!c V^8dQhRRRR/#)rrUr,rrr)rs"rr rSs 5 5n 5 5r!c 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)rrUs&&rryTreeEntry.statSs$<#44r!)rrrxrrN) rrrrrrrr#r}r{ryrrr!rr|r|s- 1&P) ) + 5 5r!r|rr.)?__conditional_annotations__r __future__rr$os.pathpathlibrrycollections.abcrrrr dataclassesrtypingrr r r r r rr3r_typingrrrPathLiker[rrrr%altseprrrr'r6rFrLrRrYrfrdrVrrr1rrrr ExceptionrrvrobjectrAr|)__seprs0@rrs#        R[[%% & :W - m7dC  :W - vvryy!!U y}}$c5! KMGL ") X,^(L JLL[BL^YD;| #(  :'T  B.>,Y,^7Y7t $'(#>&0c5c5Ss+ G:G G