[d dZddlmZddlmZddlmZddlm Z m Z mZm Z m Z m Z mZmZmZddlmZddlmZdd lmZmZmZmZmZed d Z Gd d eZdS)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"dS)rzd The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. patternsreturnNc\t|tr|nt||_dS)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.11/site-packages/pathspec/pathspec.py__init__zPathSpec.__init__.s.)>BBV((X$-otherct|tr3t|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|] \}}||kVdSN).0abs r! z"PathSpec.__eq__..Cs* 1 1Aa1f 1 1 1 1 1 1r#)rrrrallNotImplemented)r r$paired_patternss r!__eq__zPathSpec.__eq__<sL x   ??? 1 1 1 1 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|jzStS)z] Combines the :attr:`Pathspec.patterns` patterns from two :class:`PathSpec` instances. )rr __class__rr.r r$s r!__add__zPathSpec.__add__Ns7 x   ..7 8 88 r#cht|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__Xs3 x  ==EN"== ; r#clspattern_factorylinescttrtjt st ddt |st d|dfd|D}||S)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.c*g|]}||Sr(r()r)liner;s r! z'PathSpec.from_lines..s( > > > >ood## > > >r#)rstrrlookup_patterncallable TypeErrorr)r:r;r<rs ` r! from_lineszPathSpec.from_linescs*%%:(99? / " "L JoJJJ K KK e  ; 9E999 : :: > > > > > > >( Xr#entries separatorsc#Kt|std|dt|j}|D]1}t |j|}|||r|V2dS)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)rrErrrpath _match_file)r rGrH use_patternsentry norm_files r! match_entrieszPathSpec.match_entriess& g  ? =g=== > >>!$-00,eej*559 |Y// KKKr#filecdtj||}||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`. )rH)rrrKr)r rPrHrNs r!rzPathSpec.match_files1"!$:>>>)  $- 3 33r#filesc#Kt|std|dt|j}|D],}t ||}|||r|V-dS)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)rrErrrrK)r rRrHrL orig_filerNs r! match_fileszPathSpec.match_filess( e  ; 9E999 : ::!$-00,ii449 |Y// OOOr#rooton_error follow_linksc#nKtj|||}||Ed{VdS)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`). rWrXN)riter_tree_entriesrO)r rVrWrXrGs r!match_tree_entrieszPathSpec.match_tree_entriessK0  "4( V V V'    ( ((((((((((r#c#nKtj|||}||Ed{VdS)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`). rZN)riter_tree_filesrU)r rVrWrXrRs r!match_tree_fileszPathSpec.match_tree_filessK0  th\ R R R%   e $ $$$$$$$$$$r#r')NN)#__name__ __module__ __qualname____doc__rrr"objectboolr0intr3rr7r9 classmethodr r rBrrrFrr rr rO staticmethodrrKrrUr\r_ match_treer(r#r!rr(s hw/ D      D    c4 t D       Dzhx'899: &  +F+/ I z#'y >|J'' +/44 c8m4z#'4 4444.+/ %X & 'z#'uS(]#$ @"&!% )) c8m) X ) ) y ))))<"&!% %% c8m% X % % sm %%%%:r#N)rccollections.abcrr itertoolsrosrtypingrrrr r r r r rpatternrrrrrrrrdrr(r#r!rps                                   wvZ((( fffffvfffffr#