0yi/;dZddlmZddlmZmZmZmZddlm Z ddl m Z m Z m Z mZmZe ddZ dd lmZdd lmZmZdd lmZdd lmZdd lmZmZddlmZmZm Z m!Z!m"Z"m#Z#Gdde$Z%y)zn This module provides :class:`.PathSpec` which is an object-oriented interface for pattern matching of files. ) annotations) CollectionIterableIteratorSequence) zip_longest)CallableOptionalTypeVarUnioncastSelfPathSpec)bound)util)_BackendBackendNamesHintmake_pathspec_backend)Pattern)AnyStr deprecated) CheckResultStrPathTStrPath TreeEntry _is_iterablenormalize_fileceZdZdZddd ddZddZddZddZddZ d dd Z d dd Z d dd Z e ddd dd Z e d d Z ddd d!dZ d d"dZ ddd d#dZ ddd d$dZedd%dZ ddd d&dZy)'rzd The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. Nbackend_test_backend_factoryct|ts t|}|d}tt|}| ||}n|j ||}||_ ||_ ||_y)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) isinstancerlistr r _make_backend_backend _backend_namepatterns)selfr*r!r" use_backends S/var/www/html/content_weaver/venv/lib/python3.12/site-packages/pathspec/pathspec.py__init__zPathSpec.__init__5sy& Hh '8n8 _ 7 !7 +'&&x0;##GX6;'$- *1$&.$-ct|tr4|j|j|jz|jSt S)zn Combines the :attr:`self.patterns <.PathSpec.patterns>` patterns from two :class:`PathSpec` instances. )r!)r%r __class__r*r)NotImplementedr+others r-__add__zPathSpec.__add__es: x ..7ASAS. TT r/ct|tr2t|j|j}t d|DSt S)z Tests the equality of this path-spec with *other* (:class:`PathSpec`) by comparing their :attr:`self.patterns <.PathSpec.patterns>` attributes. c3,K|] \}}||k(ywN).0abs r- z"PathSpec.__eq__..vs 1Aa1f 1s)r%rrr*allr2)r+r4paired_patternss r-__eq__zPathSpec.__eq__os9 x  ?? 1 1 11 r/ct|trL|xj|jz c_|j|j|j|_|St S)zn Adds the :attr:`self.patterns <.PathSpec.patterns>` from *other* (:class:`PathSpec`) to this instance. )r%rr*r'r)r(r2r3s r-__iadd__zPathSpec.__iadd__zsI x ==ENN"=%%d&8&8$--H4= ; r/c,t|jS)zp Returns the number of :attr:`self.patterns <.PathSpec.patterns>` this path-spec contains (:class:`int`). )lenr*)r+s r-__len__zPathSpec.__len__s T]] r/cpt||}|jj|\}}t|||S)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`). )rr( match_filer)r+file separators norm_fileincludeindexs r- check_filezPathSpec.check_files7"T:.)==++I6.'5 T7E **r/c#Kt|std|d|D];}t||}|jj |\}}t |||=yw)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 TypeErrorrr(rGr)r+filesrI orig_filerJrKrLs r- check_fileszPathSpec.check_filessg& e  VE9$89 ::0ii49MM,,Y7>7E Y //0sAAc#rKtj|||}|j|Ed{y7w)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`). on_error follow_linksN)riter_tree_filesrT)r+rootrWrXrRs r-check_tree_fileszPathSpec.check_tree_filess0<   th\ R%   e $$$s -757ct|trtj|}t |st d|dt |st d|d|Dcgc] }|s||}}||||Scc}w)a 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:rPr )r%strrlookup_patterncallablerQr)clspattern_factorylinesr!r"liner*s r- from_lineszPathSpec.from_liness:%((9? / " %o%88IJ KK e  VE9$89 ::05 >od# >( > Xw>S TT?s A=& A=ct||S)aM .. 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)namer*s r-r'zPathSpec._make_backends$ tX ..r/negatec#Kt|std|d|D]B}t|j|}|jj |\}}|r| }|s?|Dyw)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:rPN)rrQrpathr(rG)r+entriesrIrhentryrJrK_indexs r- match_entrieszPathSpec.match_entriessn2 g  Xg[(<= >>eejj*59]]--i8?7F kG Ks AA%A%clt||}|jj|\}}t|S)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`. )rr(rGbool)r+rHrIrJrKrms r-rGzPathSpec.match_fileAs2"T:.)MM,,Y7/'6 gr/c#Kt|std|d|D]8}t||}|jj |\}}|r| }|s5|:yw)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`). rOrPN)rrQrr(rG)r+rRrIrhrSrJrKrms r- match_fileszPathSpec.match_filesVsj4 e  VE9$89 ::ii49]]--i8?7F kG Os AAAc#vKtj|||}|j||Ed{y7w)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`). rVrgN)riter_tree_entriesrn)r+rZrWrXrhrks r-match_tree_entrieszPathSpec.match_tree_entries}s6@  " "4( V'     777 /979zEPathSpec.match_tree() is deprecated. Use .match_tree_files() instead.c&|j|i|S)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 r- match_treezPathSpec.match_trees    + ++r/c#vKtj|||}|j||Ed{y7w)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`). rVrgN)rrYrr)r+rZrWrXrhrRs r-rxzPathSpec.match_tree_filess5>   th\ R%   eF  333rv)r*z+Union[Sequence[Pattern], Iterable[Pattern]]r!"Union[BackendNamesHint, str, None]r"1Optional[Callable[[Sequence[Pattern]], _Backend]]returnNone)r+rr4rrr)r4objectrrp)rintr8)rHrrIOptional[Collection[str]]rzCheckResult[TStrPath])rRzIterable[TStrPath]rIrrzIterator[CheckResult[TStrPath]])NN)rZrrW#Optional[Callable[[OSError], None]]rXOptional[bool]rzIterator[CheckResult[str]]) r`z type[Self]raz'Union[str, Callable[[AnyStr], Pattern]]rbzIterable[AnyStr]r!r}r"r~rr)rfrr*zSequence[Pattern]rr)rkzIterable[TreeEntry]rIrrhrrIterator[TreeEntry])rHrrIrrrp)rRzIterable[StrPath]rIrrhrrzIterator[StrPath]) rZrrWrrXrrhrrr)r Iterator[str]) rZrrWrrXrrhrrr)__name__ __module__ __qualname____doc__r.r5r@rBrErMrTr[ classmethodrd staticmethodr'rnrGrrrurr{rxr9r/r-rr/s15MQ . 7. . . K .  .`  +/++(+ +0+/0 0(0& 0<37!% %% 0% % ! %B 15MQ &U&U:&U &U . &U K &U &U&UP// ///,+/$  $ $($  $  $R+/( 0+/%  % %(%  %  %T37!% !8  !8!8 0!8 !8  !8!8H I,,37!% 4  4 4 0 4 4  4 4r/N)&r __future__rcollections.abcrrrr itertoolsrtypingr r r r r rpathspecrpathspec.backendrrpathspec._backends.aggrpathspec.patternrpathspec._typingrr pathspec.utilrrrrrrrrr9r/r-rsl#  vZ(   ]4v]4r/