\jAdZddlmZddlmZmZmZmZddlm Z ddl m Z m Z m Z mZmZmZmZmZeddZ dd lmZdd lmZmZmZdd lmZdd lmZdd lmZddl m!Z!m"Z"ddl#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+Gdde e'Z,y)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_fileceZdZdZddd ddZddZddZddZddZdd Z d d!d Z d d"d Z d# d$d Z e eddd d%d Ze eddd d&dZe eddd d'dZe eddd d(dZeddd d)dZe d*dZ d dd d+dZ d d,dZ d dd d-dZ d#dd d.dZedd/dZ d#dd d0dZy)1rzd The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. Nbackend_test_backend_factoryct|tr|}n 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) isinstancerlistrr _make_backend_backend _backend_namepatterns)selfr1r(r) use_patterns backend_name use_backends ;/root/env/lib/python3.12/site-packages/pathspec/pathspec.py__init__zPathSpec.__init__=s~&(#<x.< _ 7&0,&&|4;##L,?;'$- *6$*6$-ch|jjd|jd|jdS)z7 Returns a debug representation of this path-spec. z (patterns=z , backend=)) __class____name__r1r0r2s r6__repr__zPathSpec.__repr__os5 NN # # $Jt}}.?z$J\J\I__` aar8ct|tr5|jg|j|j|jSt S)zn Combines the :attr:`self.patterns <.PathSpec.patterns>` patterns from two :class:`PathSpec` instances. )r()r,rr;r1r0NotImplementedr2others r6__add__zPathSpec.__add__us@ x ..:4==:5>>:DDVDV. WW r8ct|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 r6 z"PathSpec.__eq__..s 1Aa1f 1s)r,rrr1allr@)r2rBpaired_patternss r6__eq__zPathSpec.__eq__s9 x  ?? 1 1 11 r8ct|trLg|j|j|_|j|j|j|_|St S)zn Adds the :attr:`self.patterns <.PathSpec.patterns>` from *other* (:class:`PathSpec`) to this instance. )r,rr1r.r0r/r@rAs r6__iadd__zPathSpec.__iadd__sP x 4T]]4U^^44=%%d&8&8$--H4= ; r8c,t|jS)zp Returns the number of :attr:`self.patterns <.PathSpec.patterns>` this path-spec contains (:class:`int`). )lenr1r=s r6__len__zPathSpec.__len__s T]] r8cpt||}|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`). )r%r/ match_filer)r2file separators norm_fileincludeindexs r6 check_filezPathSpec.check_files7"T:.)==++I6.'5 T7E **r8c#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$ TypeErrorr%r/rUr)r2filesrW orig_filerXrYrZs r6 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_filesrb)r2rootrerfr`s r6check_tree_fileszPathSpec.check_tree_filess0<   th\ R%   e $$$s -757cyrFrGclspattern_factorylinesr(r)s r6 from_lineszPathSpec.from_linesr8cyrFrGrks r6rozPathSpec.from_linesrpr8cyrFrGrks r6rozPathSpec.from_linesrpr8cyrFrGrks r6rozPathSpec.from_linesrpr8ct|trtj|}nt |r|}nt 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:r^r')r,strrlookup_patterncallabler_r$) rlrmrnr(r) use_factory_PathSpec__liner1r2s r6rozPathSpec.from_liness<%$$_5;  ; %o%88IJ KK e  VE9$89 ::05 @fk&! @( @ Xw>S T$ +As "B* Bct||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)namer1s r6r.zPathSpec._make_backendJs$ tX ..r8negatec#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:r^N)r$r_r%pathr/rU)r2entriesrWr}entryrXrY_indexs r6 match_entrieszPathSpec.match_entries^sn2 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`. )r%r/rUbool)r2rVrWrXrYrs r6rUzPathSpec.match_files2"T:.)MM,,Y7/'6 gr8c#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`). r]r^N)r$r_r%r/rU)r2r`rWr}rarXrYrs r6 match_fileszPathSpec.match_filessj4 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`). rdr|N)riter_tree_entriesr)r2rhrerfr}rs r6match_tree_entrieszPathSpec.match_tree_entriess6@  " "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)r2argskws r6 match_treezPathSpec.match_trees    + ++r8c#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`). rdr|N)rrgr)r2rhrerfr}r`s r6rzPathSpec.match_tree_filess5>   th\ R%   eF  333r)r1z3Union[Sequence[TPattern_co], Iterable[TPattern_co]]r("Union[BackendNamesHint, str, None]r)rreturnNone)rru)r2rrBrrr)rBobjectrr)rintrF)rVr"rWOptional[Collection[str]]rzCheckResult[TStrPath])r`Iterable[TStrPath]rWrrzIterator[CheckResult[TStrPath]])NN)rhrre#Optional[Callable[[OSError], None]]rfOptional[bool]rzIterator[CheckResult[str]]) rltype[PathSpec]rmzLiteral['gitignore']rnIterable[AnyStr]r(rr)rrzPathSpec[GitIgnoreBasicPattern]) rlrrmrurnrr(rr)rrzPathSpec[Pattern]) rlrrmztype[TPattern]rnrr(rr)rrPathSpec[TPattern]) rlrrmzCallable[[AnyStr], TPattern]rnrr(rr)rrr) rlz type[Self]rmz6Union[str, type[Pattern], Callable[[AnyStr], Pattern]]rnrr(rr)rrr)r{rr1zSequence[Pattern]rr)rzIterable[TreeEntry]rWrr}rrIterator[TreeEntry])rVrrWrrr)r`rrWrr}rrzIterator[TStrPath]) rhrrerrfrr}rrr)r Iterator[str]) rhrrerrfrr}rrr)r< __module__ __qualname____doc__r7r>rCrNrPrSr[rbrir classmethodro staticmethodr.rrUrrrrrrGr8r6rr7s1537 0 ?0 . 0 1 0  0db   +/++(+ +0+/0 0(0& 0<37!% %% 0% % ! %B  1537 '  .  1 &   1537   .  1    1537 !  .  1    1537 /  .  1   1537 ))I) ) . ) 1 ) ))V// ///,+/$  $ $($  $  $R+/( 0+/%  % %(%  %  %T37!% !8  !8!8 0!8 !8  !8!8H I,,37!% 4  4 4 0 4 4  4 4r8N)-r __future__rcollections.abcrrrr itertoolsrtypingr r r r r rrrrpathspecrpathspec.backendrrrpathspec._backends.aggrpathspec.patternr!pathspec.patterns.gitignore.basicrpathspec._typingrr pathspec.utilrrr r!r"r#r$r%rrGr8r6rs#     vZ(   X4w{#X4r8