Ae dZddlmZddlmZddlmZddlm Z m Z mZm Z m Z m Z mZmZmZddlmZddlmZdd lmZmZmZmZmZed d Z Gd d eZy)zR This module provides an object oriented interface for pattern matching of files. ) Collection) zip_longest)PathLike) AnyStrCallablerIterableIteratorOptionalTypeTypeVarUnion)util)Pattern) TreeEntry_filter_patterns _is_iterable match_filenormalize_fileSelfPathSpec)boundc eZdZdZdeeddfdZdedefdZ de fdZ d e ddde fd Z d e ddde fd Zed ee d eeeegeffdeede fdZ ddeedeeedeefdZeeZ ddeeefdeeedefdZ ddeeeefdeeedeeeeffdZ ddeeefdeedeedeefdZ ddeeefdeedeedeefdZ!e!Z"y)rzd The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. patternsreturnNcTt|tr||_yt||_y)z Initializes the :class:`PathSpec` instance. *patterns* (:class:`~collections.abc.Collection` or :class:`~collections.abc.Iterable`) yields each compiled pattern (:class:`.Pattern`). N) isinstanceCollectionTypelistr)selfrs 1lib/python3.12/site-packages/pathspec/pathspec.py__init__zPathSpec.__init__.s-)>B($-IMX$-otherct|tr2t|j|j}t d|DSt S)z Tests the equality of this path-spec with *other* (:class:`PathSpec`) by comparing their :attr:`~PathSpec.patterns` attributes. c3,K|] \}}||k(ywN).0abs r! z"PathSpec.__eq__..Cs 1Aa1f 1s)rrrrallNotImplemented)r r$paired_patternss r!__eq__zPathSpec.__eq__<s9 x  ?? 1 1 11 r#c,t|jS)zW Returns the number of compiled patterns this path-spec contains (:class:`int`). )lenr)r s r!__len__zPathSpec.__len__Gs T]] r#r c~t|tr(|j|j|jzStS)z] Combines the :attr:`Pathspec.patterns` patterns from two :class:`PathSpec` instances. )rr __class__rr.r r$s r!__add__zPathSpec.__add__Ns0 x ..7 88 r#cpt|tr!|xj|jz c_|StS)zi Adds the :attr:`Pathspec.patterns` patterns from one :class:`PathSpec` instance to this instance. )rrrr.r6s r!__iadd__zPathSpec.__iadd__Xs+ x ==ENN"= ; r#clspattern_factorylinesct|trtj|}t |st d|dt |st d|d|Dcgc] }|s||}}||Scc}w)ad 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 it can be a :class:`io.TextIOBase` (e.g., from :func:`open` or :class:`io.StringIO`) or the result from :meth:`str.splitlines`. Returns the :class:`PathSpec` instance. zpattern_factory:z is not callable.zlines: is not an iterable.)rstrrlookup_patterncallable TypeErrorr)r:r;r<liners r! from_lineszPathSpec.from_linescs*%((9? / " %o%88IJ KK e  VE9$89 ::05 >od# >( > X?s A:& A:entries separatorsc#Kt|std|dt|j}|D]/}t |j |}|j ||s,|1yw)a  Matches the entries to this path-spec. *entries* (:class:`~collections.abc.Iterable` of :class:`~util.TreeEntry`) contains the entries to be matched against :attr:`self.patterns `. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`~pathspec.util.normalize_file` for more information. Returns the matched entries (:class:`~collections.abc.Iterator` of :class:`~util.TreeEntry`). zentries:r>N)rrBrrrpath _match_file)r rErF use_patternsentry norm_files r! match_entrieszPathSpec.match_entriessg& g  Xg[(<= >>!$--0,eejj*59 |Y/ Ks AA' A'filechtj||}|j|j|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 `. *separators* (:class:`~collections.abc.Collection` of :class:`str`) optionally contains the path separators to normalize. See :func:`~pathspec.util.normalize_file` for more information. Returns :data:`True` if *file* matched; otherwise, :data:`False`. )rF)rrrIr)r rNrFrLs r!rzPathSpec.match_files-"!!$:>)  $-- 33r#filesc#Kt|std|dt|j}|D]%}t ||}|j ||s"|'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 `. *separators* (:class:`~collections.abc.Collection` of :class:`str`; or :data:`None`) optionally contains the path separators to normalize. See :func:`~pathspec.util.normalize_file` for more information. Returns the matched files (:class:`~collections.abc.Iterator` of :class:`str` or :class:`os.PathLike`). zfiles:r>N)rrBrrrrI)r rPrFrJ orig_filerLs r! match_fileszPathSpec.match_filessc( e  VE9$89 ::!$--0,ii49 |Y/ Os AAArooton_error follow_linksc#rKtj|||}|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. See :func:`~pathspec.util.iter_tree_entries` for more information. *follow_links* (:class:`bool` or :data:`None`) optionally is whether to walk symbolic links that resolve to directories. See :func:`~pathspec.util.iter_tree_files` for more information. Returns the matched files (:class:`~collections.abc.Iterator` of :class:`.TreeEntry`). rUrVN)riter_tree_entriesrM)r rTrUrVrEs r!match_tree_entrieszPathSpec.match_tree_entriess00  " "4( V'    ((( -757c#rKtj|||}|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. See :func:`~pathspec.util.iter_tree_files` for more information. *follow_links* (:class:`bool` or :data:`None`) optionally is whether to walk symbolic links that resolve to directories. See :func:`~pathspec.util.iter_tree_files` for more information. Returns the matched files (:class:`~collections.abc.Iterable` of :class:`str`). rXN)riter_tree_filesrS)r rTrUrVrPs r!match_tree_fileszPathSpec.match_tree_filess00   th\ R%   e $$$r[r')NN)#__name__ __module__ __qualname____doc__rrr"objectboolr0intr3rr7r9 classmethodr r r?rrrDrr rr rM staticmethodrrIrrSrZr^ match_treer(r#r!rr(s- hw/ D   D c4 t D    Dzhx'899: &  F+/ I z#'y >J' +/4 c8m4z#'4 4.+/ %X & 'z#'uS(]#$ @"&!% ) c8m) X ) ) y )<"&!% % c8m% X % % sm %:r#N)rbcollections.abcrr itertoolsrosrtypingrrrr r r r r rpatternrrrrrrrrcrr(r#r!ros]      vZ( fvfr#