o ;i@sdZddlZddlmZddlmZddlmZddlm Z m Z m Z m Z ddl mZGd d d ZGd d d eZGd ddeZededZeedZde e ee egeffde egeffddZdS)aPattern matching library ported from https://github.com/moby/patternmatcher. This is the same pattern-matching logic used by Docker, except it is written in Python rather than Go. Also, the original Go library has a couple deprecated functions that we don't implement in this port. The main way to use this library is by constructing a `FilePatternMatcher` object, then asking it whether file paths match any of its patterns. N)abstractmethod)cached_property)Path)CallableOptionalSequenceUnion)PatterncspeZdZUdZeeed<dddZdddZdeffdd Z e de fd d Z e d e de fd dZZS)_AbstractPatternMatcherN _custom_reprreturncstfddS)a\Invert the filter. Returns a function that returns True if the path does not match any of the patterns. Usage: ```python from pathlib import Path from modal import FilePatternMatcher inverted_matcher = ~FilePatternMatcher("**/*.py") assert not inverted_matcher(Path("foo.py")) ``` cs | SN)pathselfrN/home/ubuntu/.local/lib/python3.10/site-packages/modal/file_pattern_matcher.py%s z4_AbstractPatternMatcher.__invert__..)_CustomPatternMatcherrrrr __invert__s z"_AbstractPatternMatcher.__invert__cCs ||_|Sr)r )r custom_reprrrr _with_repr'sz"_AbstractPatternMatcher._with_reprcs|jr|jStSr)r super__repr__r __class__rrr,s z _AbstractPatternMatcher.__repr__cCdS)aD Returns True if this pattern matcher allows safe early directory pruning. Directory pruning is safe when matching directories can be skipped entirely without missing any files that should be included. An example where pruning is not safe is for inverted patterns, like "!**/*.py". Nrrrrrcan_prune_directories2s z-_AbstractPatternMatcher.can_prune_directoriesrcCsdSrrrrrrr__call__>sz _AbstractPatternMatcher.__call__)r r )__name__ __module__ __qualname__r rstr__annotations__rrrrboolrrr __classcell__rrrrr s    r c@sDeZdZdeegeffddZdefddZdedefdd Zd S) r predicatecCs ||_dSr _predicate)rr(rrr__init__C z_CustomPatternMatcher.__init__r cCr)z Custom pattern matchers (like negated matchers) cannot safely prune directories. Since these are arbitrary predicates, we cannot determine if a directory can be safely skipped without evaluating all files within it. FrrrrrrFsz+_CustomPatternMatcher.can_prune_directoriesrcCs ||Srr)rrrrr Or,z_CustomPatternMatcher.__call__N) r!r"r#rrr&r+rr rrrrrBs rc@seZdZUdZeeeefed<ee eed<de ede e fddZ dedd fd d Z ed eeefddfd dZd edefddZede e fddZdefddZd edefddZd S)FilePatternMatcherax Allows matching file Path objects against a list of patterns. **Usage:** ```python from pathlib import Path from modal import FilePatternMatcher matcher = FilePatternMatcher("*.py") assert matcher(Path("foo.py")) # You can also negate the matcher. negated_matcher = ~matcher assert not negated_matcher(Path("foo.py")) ``` _file_path_pattern_stringspatternsr cCsg}t|D]@}|tjj}|sqtj|}t}|ddkr6t|dkr-tdd|_ |dd}||_ | tjj|_ | |q|S)Nr!r zIllegal exclusion pattern: "!"T)liststriposrsepnormpathr len ValueError exclusioncleaned_patternsplitdirsappend)rr0parsed_patternspattern new_patternrrr_parse_patternsjs       z"FilePatternMatcher._parse_patternsr?NcGs||_d|_dS)zInitialize a new FilePatternMatcher instance. Args: pattern (str): One or more pattern strings. Raises: ValueError: If an illegal exclusion pattern is provided. N)r/r.)rr?rrrr+}s zFilePatternMatcher.__init__ file_pathcCs||}||_d|_|S)aInitialize a new FilePatternMatcher instance from a file. The patterns in the file will be read lazily when the matcher is first used. Args: file_path (Path): The path to the file containing patterns. **Usage:** ```python from modal import FilePatternMatcher matcher = FilePatternMatcher.from_file("/path/to/ignorefile") ``` N)__new__r.r/)clsrBinstancerrr from_files zFilePatternMatcher.from_filec Csd}tj|}|dkrdStj|}|dkrd}|tjj}|jD]8}|j|kr,q$||}|sV|dkrVt t |D]}tjj |d|d}||rUd}nq=|r\|j }q$|S)aCheck if the file path or any of its parent directories match the patterns. This is equivalent to `MatchesOrParentMatches()` in the original Go library. The reason is that `Matches()` in the original library is deprecated due to buggy behavior. F.Nr T) r4rr6dirnamer;r5r0r9matchranger7join) rrBmatched parent_pathparent_path_dirsr?rJidir_pathrrr_matchess.       zFilePatternMatcher._matchescCs4|jdurt|jd}nt|j}||S)z1Get the patterns, loading from file if necessary.Nutf8)r.r read_text splitlinesr2r/rA)rpattern_stringsrrrr0s   zFilePatternMatcher.patternscCstdd|jD S)aQ Returns True if this pattern matcher allows safe early directory pruning. Directory pruning is safe when matching directories can be skipped entirely without missing any files that should be included. This is for example not safe when we have inverted/negated ignore patterns (e.g. "!**/*.py"). css|]}|jVqdSr)r9).0r?rrr sz;FilePatternMatcher.can_prune_directories..)anyr0rrrrrsz(FilePatternMatcher.can_prune_directoriescCs|t|Sr)rRr$)rrBrrrr szFilePatternMatcher.__call__)r!r"r#__doc__rrr$rr%rr2r rAr+ classmethodrFr&rRrr0rr rrrrr-Ss  %  r-z**/*.pyz.NON_PYTHON_FILESz ._NOTHINGignorer cCst|r|St|Sr)callabler-)r\rrr _ignore_fnsr^)rZr4abcr functoolsrpathlibrtypingrrrr_utils.pattern_utilsr r rr-rr!NON_PYTHON_FILES_NOTHINGr$r&r^rrrrs    -6