B Khh:%@sdZddlmZddlmZddlmZmZmZm Z m Z m Z m Z m Z mZddlmZddlmZddlmZmZmZmZmZmZe d d d ZGd d d eZd S)zR This module provides an object oriented interface for pattern matching of files. ) Collection) zip_longest) AnyStrCallablerIterableIteratorOptionalTypeTypeVarUnion)util)Pattern)StrPath TreeEntry_filter_patterns _is_iterable match_filenormalize_fileSelfPathSpec)Zboundc@s|eZdZdZeeddddZeedddZ e d d d Z e de d d dZ e de d ddZeee eeeegeffeee dddZd#ddeeeeeeeeedddZeeZd$eeeeedddZd%ddeeeeeeeeedddZd&ddeeeeeeeeeddd Z d'ddeeeeeeeeedd!d"Z!e!Z"dS)(rzd The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. N)patternsreturncCst|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)selfrr7/tmp/pip-install-vv81h98y/pathspec/pathspec/pathspec.py__init__,szPathSpec.__init__)otherrcCs2t|tr*t|j|j}tdd|DStSdS)z Tests the equality of this path-spec with *other* (:class:`PathSpec`) by comparing their :attr:`~PathSpec.patterns` attributes. css|]\}}||kVqdS)Nr).0abrrr Asz"PathSpec.__eq__..N)rrrrallNotImplemented)rr Zpaired_patternsrrr__eq__:s zPathSpec.__eq__)rcCs t|jS)zW Returns the number of compiled patterns this path-spec contains (:class:`int`). )lenr)rrrr__len__EszPathSpec.__len__)rr rcCs$t|tr||j|jStSdS)z] Combines the :attr:`Pathspec.patterns` patterns from two :class:`PathSpec` instances. N)rr __class__rr&)rr rrr__add__Ls zPathSpec.__add__cCs&t|tr|j|j7_|StSdS)zi Adds the :attr:`Pathspec.patterns` patterns from one :class:`PathSpec` instance to this instance. N)rrrr&)rr rrr__iadd__Vs zPathSpec.__iadd__)clspattern_factorylinesrcs^ttrtts,tddt|sDtd|dfdd|D}||S)ai 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`. Returns the :class:`PathSpec` instance. zpattern_factory:z is not callable.zlines:z is not an iterable.csg|]}|r|qSrr)r!line)r.rr sz'PathSpec.from_lines..)rstrr Zlookup_patterncallable TypeErrorr)r-r.r/rr)r.r from_linesas  zPathSpec.from_lines)negate)entries separatorsr6rccs`t|std|dt|j}x8|D]0}t|j|}|||}|rN| }|r(|Vq(WdS)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. *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:`~util.TreeEntry`). zentries:z is not an iterable.N)rr4rrrpath _match_file)rr7r8r6 use_patternsentry norm_fileis_matchrrr match_entriess    zPathSpec.match_entries)filer8rcCstj||d}||j|S)a Matches the file to this path-spec. *file* (:class:`str` or :class:`os.PathLike[str]`) 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`. )r8)r rr:r)rr@r8r=rrrrszPathSpec.match_file)filesr8r6rccs^t|std|dt|j}x6|D].}t||}|||}|rL| }|r(|Vq(WdS)a Matches the files to this path-spec. *files* (:class:`~collections.abc.Iterable` of :class:`str` or :class:`os.PathLike[str]`) 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. *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[str]`). zfiles:z is not an iterable.N)rr4rrrr:)rrAr8r6r;Z orig_filer=r>rrr match_filess    zPathSpec.match_files)rooton_error follow_linksr6rccs(tj|||d}|j||dEdHdS)a Walks the specified root path for all files and matches them to this path-spec. *root* (:class:`str` or :class:`os.PathLike[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. 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. *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`). )rDrE)r6N)r Ziter_tree_entriesr?)rrCrDrEr6r7rrrmatch_tree_entriesszPathSpec.match_tree_entriesccs(tj|||d}|j||dEdHdS)a Walks the specified root path for all files and matches them to this path-spec. *root* (:class:`str` or :class:`os.PathLike[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. 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. *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`). )rDrE)r6N)r Ziter_tree_filesrB)rrCrDrEr6rArrrmatch_tree_files szPathSpec.match_tree_files)N)N)N)NN)NN)#__name__ __module__ __qualname____doc__rrrobjectboolr'intr)rr+r, classmethodr r r2rrr5rrrrr? staticmethodrr:rrBrFrGZ match_treerrrrr&s:   $%N)rKcollections.abcrr itertoolsrtypingrrrrrr r r r patternrrrrrrrrrLrrrrrs  ,