a e g3@sdZddlmZddlmZddlmZmZmZm Z m Z m Z m Z m Z mZddlmZddlmZddlmZmZmZmZmZmZmZe 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) CheckResultStrPathTStrPath TreeEntry_filter_check_patterns _is_iterablenormalize_fileSelfPathSpec)boundc@s eZdZdZeeddddZeedddZ e d d d Z e de d d dZ e de d ddZd+eeeeeedddZd,eeeeeeeedddZd-eeeegdfeeeeedddZeee eeeegeffeee dddZd.ddee eeeeeee ddd Z!e"e#j$Z%d/eeeeedd!d"Z&d0ddeeeeeeeeed#d$d%Z'd1ddeeeegdfeeeeee d&d'd(Z(d2ddeeeegdfeeeeeed&d)d*Z)e)Z*dS)3rzd The :class:`PathSpec` class is a wrapper around a list of compiled :class:`.Pattern` instances. N)patternsreturncCst|tst|}||_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)selfrrT/var/www/html/llm_bihealth/app/venv/lib/python3.9/site-packages/pathspec/pathspec.py__init__-s zPathSpec.__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 Dz"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__HszPathSpec.__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__Os 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)r.rrr __iadd__Ys zPathSpec.__iadd__)file separatorsrcCs,t||}|t|j|\}}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 `. *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 file check result (:class:`~pathspec.util.CheckResult`). )r _match_file enumeraterr)rr1r2 norm_fileincludeindexrrr check_fileds zPathSpec.check_file)filesr2rccsXt|std|dt|j}|D],}t||}|||\}}t|||Vq&dS)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 `. *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 an :class:`~collections.abc.Iterator` yielding each file check result (:class:`~pathspec.util.CheckResult`). files: is not an iterable.N)r TypeErrorrrrr3r)rr9r2 use_patterns orig_filer5r6r7rrr check_filesys  zPathSpec.check_files)rooton_error follow_linksrccs$tj|||d}||EdHdS)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:`~pathspec.util.CheckResult`). rArBN)r iter_tree_filesr?)rr@rArBr9rrr check_tree_filesszPathSpec.check_tree_files)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:r;csg|]}|r|qSrr)r#linerGrr r'z'PathSpec.from_lines..)rstrr Zlookup_patterncallabler<r)rFrGrHrrrJr from_liness  zPathSpec.from_linesnegate)entriesr2rPrc cs`t|std|dt|j}|D]4}t|j|}|||\}}|rP| }|r&|Vq&dS)a Matches the entries to this path-spec. *entries* (:class:`~collections.abc.Iterable` of :class:`~pathspec.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:`~pathspec.util.TreeEntry`). zentries:r;N)rr<rrrpathr3) rrQr2rPr=entryr5r6_indexrrr match_entriess  zPathSpec.match_entriescCs(t||}|t|j|\}}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 `. *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`. )rr3r4rbool)rr1r2r5r6rTrrr match_files zPathSpec.match_file)r9r2rPrc cs^t|std|dt|j}|D]2}t||}|||\}}|rN| }|r&|Vq&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. *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)rr<rrrr3) rr9r2rPr=r>r5r6rTrrr match_filess  zPathSpec.match_files)r@rArBrPrccs(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`) 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`). rCrON)r Ziter_tree_entriesrU)rr@rArBrPrQrrr match_tree_entriesBs zPathSpec.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`) 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`). rCrON)r rDrX)rr@rArBrPr9rrr match_tree_fileses zPathSpec.match_tree_files)N)N)NN)N)N)N)NN)NN)+__name__ __module__ __qualname____doc__rrr!objectrVr*intr,rr/r0rrrrLrr8rr?rrOSErrorrE classmethodr r rrNrrU staticmethodr Zcheck_match_filer3rWrXrYrZZ match_treerrrr r's       !#  '     + & %N)r^collections.abcrr itertoolsrtypingrrrrrr r r r patternrrrrrrrrrr_rrrrr s  ,  $