o bM@sdZddlZddlZddlZddlZzddlmZmZmZm Z m Z m Z m Z m Z mZmZmZmZWn ey9YnwzddlmZddlmZWn eyQYnwddlmZmZmZmZddlmZd d ejejfDZ iZ d+d d Z d dZ!d,ddZ"d,ddZ#e#Z$ddZ%ddZ&ddZ'ddZ(d+ddZ)d+ddZ*d+dd Z+d+d!d"Z,Gd#d$d$e-Z.Gd%d&d&e-Z/Gd'd(d(e0Z1Gd)d*d*e0Z2dS)-zC This module provides utility methods for dealing with path-specs. N) AnyAnyStrCallableDictIterableIteratorListOptionalSequenceSetTextUnion)PathLike) Collection)CollectionType IterableType string_typesunicode)PatterncCsg|] }|r|tjkr|qS) posixpathsep).0rrrL/var/www/secure340b-portal/env/lib/python3.10/site-packages/pathspec/util.py (src Cst|tr|nt|}i}|D];}|jdurJ||}|jrB|D] }||vr9|r1||j|q |||jd<q t|g||<q q|D]}||=qDq|S)a Matches the files to the patterns, and returns which patterns matched the files. *patterns* (:class:`~collections.abc.Iterable` of :class:`~pathspec.pattern.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:`boot` 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`). Nr) isinstancerlistincludematchpatternsappend MatchDetail) r filesZ all_matches all_files return_filespattern result_filesZ result_filefilerrrdetailed_match_files7s"   r)cCst|to t|ttf S)z Check whether the value is an iterable (excludes strings). *value* is the value to check, Returns whether *value* is a iterable (:class:`bool`). )rrrbytes)valuerrr _is_iterablebs r,ccsT|durt|std||durd}ttj|di||D]}|Vq"dS)a Walks the specified directory for all files and directories. *root* (:class:`str`) 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*. Non_error:{!r} is not callable.T)callable TypeErrorformat_iter_tree_entries_nextospathabspathrooton_error follow_linksentryrrriter_tree_entriesnsr;ccs`|durt|std||durd}ttj|di||D] }||s-|jVq"dS)a Walks the specified directory for all files. *root* (:class:`str`) 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-Tr.)r/r0r1r2r3r4r5is_dirr6rrriter_tree_filess r=c csxtj||}tj|}||vr|||<n t||||dt|D]}tj||}tj||} zt| } WntyV} z|durL|| WYd} ~ q%d} ~ wwt | j rd} zt| } Wnty} z|durv|| WYd} ~ q%d} ~ wwd} | } t | j r|s| st ||| | Vt |||||D]}|Vqq%t| j s| rt ||| | Vq%||=dS)aq 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_pathNTF)r3r4joinrealpathRecursionErrorlistdirlstatOSErrorstatS_ISLNKst_modeS_ISDIR TreeEntryr2S_ISREG)Z root_fullZdir_relmemor8r9Zdir_fullZdir_realZ node_nameZnode_relZ node_fullZ node_lstateis_link node_statr:rrrr2sL      r2cCst|S)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)namerrrlookup_patterns rScCs2d}|D]}|jdur|||fvr|j}q|S)a7 Matches the file to the patterns. *patterns* (:class:`~collections.abc.Iterable` of :class:`~pathspec.pattern.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`. FN)rr)r r(matchedr&rrr match_files  rUcCsZt|tr|nt|}t}|D]}|jdur*||}|jr%||q||q|S)a^ Matches the files to the patterns. *patterns* (:class:`~collections.abc.Iterable` of :class:`~pathspec.pattern.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`). N)rrrsetrrupdatedifference_update)r r#r$r%r&r'rrr match_files#s     rYcCs$i}|D] }||t|j|d<q|S)a Normalizes the entry paths to use the POSIX path separator. *entries* (:class:`~collections.abc.Iterable` of :class:`.TreeEntry`) contains the entries 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 the each normalized file path (:class:`str`) to the entry (:class:`.TreeEntry`)  separators)normalize_filer4)entriesr[ norm_filesr:rrr_normalize_entries<sr_cCs`|durt}t|}|D] }||tj}q |dr#|dd}|S|dr.|dd}|S)a Normalizes the file path to use the POSIX path separator (i.e., ``'/'``), and make the paths relative (remove leading ``'/'``). *file* (:class:`str` or :class:`pathlib.PurePath`) 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 :data:`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`). N/rz./)NORMALIZE_PATH_SEPSstrreplacerr startswith)r(r[ norm_filerrrrr\Qs   r\cCs@i}|D]}t||d}||vr|||q|g||<q|S)a/ Normalizes the file paths to use the POSIX path separator. *files* (:class:`~collections.abc.Iterable` of :class:`str` or :class:`pathlib.PurePath`) 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 the each normalized file path (:class:`str`) to the original file paths (:class:`list` of :class:`str` or :class:`pathlib.PurePath`). rZ)r\r!)r#r[r^r4rfrrrnormalize_filesws  rgcCsTt|ts td|t|std||tvr$|s$t|t||t|<dS)aE 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:{!r} is not a string.z%pattern_factory:{!r} is not callable.N)rrr0r1r/rQAlreadyRegisteredError)rRpattern_factoryoverriderrrregister_patterns   rkcsDeZdZdZfddZeddZeddZedd ZZ S) rhz| The :exc:`AlreadyRegisteredError` exception is raised when a pattern factory is registered under a name already in use. cstt|||dS)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. N)superrh__init__)selfrRri __class__rrrms zAlreadyRegisteredError.__init__cCsdj|j|jdS)4 *message* (:class:`str`) is the error message. zG{name!r} is already registered for pattern factory:{pattern_factory!r}.)rRri)r1rRrirnrrrmessageszAlreadyRegisteredError.messagecC |jdS)zB *name* (:class:`str`) is the name of the registered pattern. rargsrrrrrrRs zAlreadyRegisteredError.namecCrt)za *pattern_factory* (:class:`~collections.abc.Callable`) is the registered pattern factory. rrurrrrrri z&AlreadyRegisteredError.pattern_factory) __name__ __module__ __qualname____doc__rmpropertyrsrRri __classcell__rrrorrhs   rhcsPeZdZdZfddZeddZeddZedd Zed d Z Z S) rCzN The :exc:`RecursionError` exception is raised when recursion is detected. cstt||||dS)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*. N)rlrCrm)rnr>r?r@rorrrmszRecursionError.__init__cCrt)zx *first_path* (:class:`str`) is the first path encountered for :attr:`self.real_path `. rrurrrrrr?rwzRecursionError.first_pathcCsdj|j|j|jdS)rqzDReal path {real!r} was encountered at {first!r} and then {second!r}.)realfirstsecond)r1r>r?r@rrrrrrss zRecursionError.messagecCrt)zV *real_path* (:class:`str`) is the real path that recursion was encountered on. rrurrrrrr>rwzRecursionError.real_pathcCrt)zz *second_path* (:class:`str`) is the second path encountered for :attr:`self.real_path `. rarurrrrrr@rwzRecursionError.second_path) rxryrzr{rmr|r?rsr>r@r}rrrorrCs    rCc@seZdZdZdZddZdS)r"z> The :class:`.MatchDetail` class contains information about r cCs ||_dS)z Initialize the :class:`.MatchDetail` instance. *patterns* (:class:`~collections.abc.Sequence` of :class:`~pathspec.pattern.Pattern`) contains the patterns that matched the file in the order they were encountered. Nr)rnr rrrrm!s zMatchDetail.__init__N)rxryrzr{ __slots__rmrrrrr"s r"c@sBeZdZdZdZddZdddZddd Zd d Zdd d Z dS)rKzR The :class:`.TreeEntry` class contains information about a file-system entry. _lstatrRr4_statcCs"||_ ||_ ||_ ||_dS)aR 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. Nr)rnrRr4rErGrrrrm<szTreeEntry.__init__NcC(|durd}|r |jn|j}t|jS)a< 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`). NT)rrrGrJrIrnr9rPrrrr<b  zTreeEntry.is_dircCr)aE 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`). NT)rrrGrLrIrrrris_filesrzTreeEntry.is_filecCst|jjS)zC Returns whether the entry is a symbolic link (:class:`bool`). )rGrHrrIrrrrr is_symlinkszTreeEntry.is_symlinkcCs|durd}|r |jS|jS)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`). NT)rr)rnr9rrrrGs zTreeEntry.statN) rxryrzr{rrmr<rrrGrrrrrK3s & rKr)NN)3r{r3os.pathrrGtypingrrrrrrrr r r r r ImportErrorrrcompatrrrrr&rraltseprbrQr)r,r;r=Z iter_treer2rSrUrYr_r\rgrk ExceptionrhrCobjectr"rKrrrrsN<     + "N    & />