o bp@sdZzddlmZmZmZmZmZmZmZm Z Wn e y!Ynwzddl m Z ddlm Z Wn e y9YnwddlmZddlmZmZmZmZddlmZdd lmZGd d d eZd S) zR This module provides an object oriented interface for pattern matching of files. )AnyAnyStrCallableIterableIteratorOptionalTextUnion)PathLike) Collection)util)CollectionTypeiterkeys izip_longest string_types)Pattern) TreeEntryc@szeZdZdZddZddZddZdd Zd d Ze d d Z dddZ dddZ dddZ dddZdddZeZdS)PathSpeczd The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. cCs"t|tr ||_dSt||_dS)z Initializes the :class:`PathSpec` instance. *patterns* (:class:`~collections.abc.Collection` or :class:`~collections.abc.Iterable`) yields each compiled pattern (:class:`.Pattern`). N) isinstancerlistpatterns)selfrrP/var/www/secure340b-portal/env/lib/python3.10/site-packages/pathspec/pathspec.py__init__+s  zPathSpec.__init__cCs.t|trt|j|j}tdd|DStS)z Tests the equality of this path-spec with *other* (:class:`PathSpec`) by comparing their :attr:`~PathSpec.patterns` attributes. css|] \}}||kVqdSNr).0abrrr Bsz"PathSpec.__eq__..)rrrrallNotImplemented)rotherZpaired_patternsrrr__eq__:s zPathSpec.__eq__cCs t|jS)zW Returns the number of compiled patterns this path-spec contains (:class:`int`). )lenr)rrrr__len__Fs zPathSpec.__len__cCst|tr t|j|jStS)z] Combines the :attr:`Pathspec.patterns` patterns from two :class:`PathSpec` instances. rrrr"rr#rrr__add__Ms zPathSpec.__add__cCs"t|tr|j|j7_|StS)zi Adds the :attr:`Pathspec.patterns` patterns from one :class:`PathSpec` instance to this instance. r'r(rrr__iadd__Xs zPathSpec.__iadd__cs\ttr ttstdt|s!td|fdd|D}||S)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 it can be a :class:`file` (e.g., from :func:`open` or :class:`io.StringIO`) or the result from :meth:`str.splitlines`. Returns the :class:`PathSpec` instance. z%pattern_factory:{!r} is not callable.zlines:{!r} is not an iterable.csg|]}|r|qSrr)rlinepattern_factoryrr ~sz'PathSpec.from_lines..)rrr Zlookup_patterncallable TypeErrorformat _is_iterable)clsr-linesrrr,r from_linesds   zPathSpec.from_linesNcCstj||d}t|j|S)a Matches the file to this path-spec. *file* (:class:`str` or :class:`~pathlib.PurePath`) 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`.  separators)r Znormalize_file match_filer)rfiler7 norm_filerrrr8szPathSpec.match_fileccsRt|s td|tj||d}t|jt|}|D]}||VqdS)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`). z entries:{!r} is not an iterable.r6N)r r2r0r1Z_normalize_entries match_filesrr)rentriesr7Z entry_mapZ match_pathspathrrr match_entriess  zPathSpec.match_entriesccs\t|s td|tj||d}t|jt|}|D] }||D]}|Vq%qdS)a* Matches the files to this path-spec. *files* (:class:`~collections.abc.Iterable` of :class:`str; or :class:`pathlib.PurePath`) 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:`pathlib.PurePath`). zfiles:{!r} is not an iterable.r6N)r r2r0r1Znormalize_filesr;rr)rfilesr7Zfile_mapZ matched_filesr:Z orig_filerrrr;s  zPathSpec.match_filescCtj|||d}||S)a Walks the specified root path for all files and matches them to this path-spec. *root* (:class:`str`; or :class:`pathlib.PurePath`) 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`). on_error follow_links)r Ziter_tree_entriesr>)rrootrBrCr<rrrmatch_tree_entries zPathSpec.match_tree_entriescCr@)a Walks the specified root path for all files and matches them to this path-spec. *root* (:class:`str`; or :class:`pathlib.PurePath`) 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`). rA)r Ziter_tree_filesr;)rrDrBrCr?rrrmatch_tree_filesrFzPathSpec.match_tree_filesr)NN)__name__ __module__ __qualname____doc__rr$r&r)r* classmethodr5r8r>r;rErGZ match_treerrrrr%s        rN)rKtypingrrrrrrrr ImportErrorosr r r compatrrrrpatternrrobjectrrrrrs",