FeUdZddlmZddlZddlZddlmZmZddl m Z m Z erddl m Z mZddZ ddZGd d Zed gZiZd ed <ddZddZ d ddZy)z.Pattern-matching utility functions for Sphinx.) annotationsN) TYPE_CHECKINGCallable) canon_pathpath_stabilize)IterableIteratorcdt|}}d}||kr||}|dz }|dk(r||kr||dk(r |dz }|dz}n|dz}n|dk(r|dz}n|d k(r|}||kr ||d k(r|dz }||kr ||d k(r|dz }||kr||d k7r|dz }||kr ||d k7r||k\r|d z}nY|||jd d}|dz}|dd k(r d|ddz}n |ddk(rd |z}|d |d }n|tj|z }||kr|dzS)zTranslate a shell-style glob pattern to a regular expression. Adapted from the fnmatch module, but enhanced so that single stars don't match slashes. r*z.*z[^/]*?z[^/][!]z\[\z\\z^/N^$)lenreplacereescape)patinrescjstuffs 6/usr/lib/python3/dist-packages/sphinx/util/matching.py_translate_patternr!s| c#hqA C a% F Q 81uQ3QDjGm #X,C #XA1uQ3Q1uQ3Qa%CFcMQa%CFcMAvEkAa((v6E8s? 59,E1X_ 5LEQugQ' 299Q< CE a%F 9cx|Dcgc]*}tjt|j,c}Scc}wN)rcompiler!match)patternsrs r compile_matchersr(=s/BJ J#BJJ)#. / 5 5 JJ Js/7c(eZdZdZddZddZddZy)MatcherzA pattern matcher for Multiple shell-style glob patterns. Note: this modifies the patterns to work with copy_asset(). For example, "**/index.rst" matches with "index.rst" c|Dcgc]}|jds|dd}}tt||z|_ycc}w)Nz**/) startswithr(listr')selfexclude_patternsrexpandeds r __init__zMatcher.__init__JsC'7Q3>>%;PCGQQ(.>)?()JK Rs AAc$|j|Sr$)r&r/strings r __call__zMatcher.__call__Nszz&!!r"cVttfd|jDS)Nc3.K|] }|ywr$).0rr5s r z Matcher.match..Ss833v;8s)ranyr'r4s `r r&z Matcher.matchQs"F#8$--888r"N)r0 Iterable[str]returnNone)r5strr>bool)__name__ __module__ __qualname____doc__r2r6r&r9r"r r*r*Cs L"9r"r*z**/.*zdict[str, re.Pattern[str]] _pat_cachec|tvr%tjt|t|<t|j |S)zbReturn if name matches the regular expression (pattern) ``pat```. Adapted from fnmatch module.)rFrr%r!r&)namers r patmatchrI\s9 ***%7%<= 3 c?  &&r"c|tvr%tjt|t|<t|j}t t ||S)zReturn the subset of the list ``names`` that match the regular expression (pattern) ``pat``. Adapted from fnmatch module. )rFrr%r!r&r.filter)namesrr&s r patfilterrMdsE  ***%7%<= 3 sO ! !E ue$ %%r"c# Ktjjtjj|}t |}t |}tj |dD]\}}}tjj ||}|dk(rd}g} t|D]g} ttjj|| } d} |D]} | | s d} n|D]} | | s d} n| sW| j| ig} t|D]M}ttjj||}|D] } | |s <| j|O| |dd| Ed{y7w)acGet all file names in a directory, recursively. Filter file names by the glob-style include_patterns and exclude_patterns. The default values include all files ("**") and exclude nothing (""). Only files matching some pattern in *include_patterns* are included, and exclusions from *exclude_patterns* take priority over inclusions. T) followlinks.r FN) ospathnormpathabspathr(walkrelpathsortedrjoinappend)dirnameinclude_patternsr0exclude_matchersinclude_matchersrootdirsfiles relative_rootincluded_filesentrykeepmatcher filtered_dirsdir_name normaliseds r get_matching_filesripsggrwww78G'(89'(89WWW$?%"dEg6 C ME] -E"277<< u#EFED+ 5>D  , 5> D  %%e, -" t  /H' ]H(MNJ+ /:& / $$X. / Q"!!K%"J "s+C!F$F7F?AF F9F: F)rr@r>r@)r'r=r>z+list[Callable[[str], re.Match[str] | None]])rHr@rr@r>zre.Match[str] | None)rLr=rr@r>z list[str]))z**r9)rZzstr | os.PathLike[str]r[r=r0r=r>z Iterator[str])rE __future__ros.pathrQrtypingrrsphinx.util.osutilrrcollections.abcrr r!r(r*DOTFILESrF__annotations__rIrMrir9r"r rqs4" *92+\KK0K 99& G9 *, &+' &'.&(9" #9"#9"$9" 9"r"