+ h;csRt^RIHt^RIt^RIt^RIt^RIt^RIHt^RI H t H t ^RI H t ^RIHtHt^RIHt!RR 4tR t!R R ]4t]P.3R RlltRtRRltR#)zsdistutils.filelist Provides the FileList class, used for poking about the filesystem and building lists of files. ) annotationsN)Iterable)Literaloverload)log)DistutilsInternalErrorDistutilsTemplateError) convert_pathcs^]tRt^tRtR'RRlltRRlt]P3RRllt R R lt R R lt R Rlt RRlt RRltRtRRlt]R(RRll4t]R)RRll4t]RRl4tR(RRllt]R(RRll4t]R)R R!ll4t]R"R#l4tR(R$R%lltR&tR#)*FileListaA list of files built by on exploring the filesystem and filtered by applying various patterns to what we find there. Instance attributes: dir directory from which files will be taken -- only used if 'allfiles' not supplied to constructor files list of filenames currently being built/filtered/manipulated allfiles complete list of files under consideration (ie. without any filtering applied) Ncs$V^8dQhRRRRRR/#)warnobject debug_printreturnNoneformat"C/usr/lib/python3.14/site-packages/setuptools/_distutils/filelist.py __annotate__FileList.__annotate__$s!##V##4#c s"RVn.VnR#Nallfilesfiles)selfr r s&&&r__init__ZFileList.__init__$s/3 " rc V^8dQhRRRR/#)r r Iterable[str]r rrrrrrr*s!!]!t!rc sWnR#r)r)rr&&r set_allfilesZFileList.set_allfiles*s rcr)r dirstr | os.PathLike[str]r rrrrrrr-s%%1%$%rc s&\V4VnR#r)findallr)rr!rrr#ZFileList.findall-s   rcr)r msgr r rrrrrrr0sv$rc s<^RIHpV'd\V4R#R#)znPrint 'msg' to stdout if the global DEBUG (taken from the DISTUTILS_DEBUG environment variable) flag is true. )DEBUGN)Zdistutils.debugr%Zprint)rr$r%s&& rr ZFileList.debug_print0s *  #J rcr)r itemstrr rrrrrrr;s  3 4 rc <VPPV4R#r)rappend)rr&rrr)ZFileList.append;s $rcr)r itemsrr rrrrrrr>s!!M!d!rc r(r)rextend)rr*rrr+ZFileList.extend>s % rcV^8dQhRR/#r r rrrrrrrAs99d9rc s\\\PPVP 44p.VnVF:pVP P \PP!V!4K< R#r)Zsortedmapospathsplitrr)join)rZsortable_filesZ sort_tuple& rsortZ FileList.sortAsOBGGMM4:: >? (J JJ  bggllJ7 8)rcr,r-rrrrrrJs""4"rc s\\VP4^, ^R4FBpVPV,VPV^, ,8XgK5VPVKD R#)N)rangelenr)ris& rremove_duplicatesZFileList.remove_duplicatesJsJs4::*Ar2Azz!} 1q5 11JJqM3rc s.VP4pV^,pR;p;rVVR 9dB\V4^8d\RV R24hVR,Uu.uFp\V4NK ppMVR 9dT\V4^8d\RV R24h\V^,4pVR,Uu.uFp\V4NK ppMHVR 9d3\V4^8wd\RV R24h\V^,4pM\RV R24hW4WV3#uupiuupi) iN'z#' expects ...:r5NNz)' expects ...:r NNz ' expects a single zunknown action ')includeexcludeglobal-includeglobal-exclude)recursive-includerecursive-exclude)graftprune)r1r8rr)rlineZwordsactionpatternsr! dir_patternZw&& r_parse_template_lineZFileList._parse_template_lineRs5 q'+++3 O O5zA~,xBC27r;A QH;H A A5zA~,xHIuQx(C16r;A QH;H ) )5zQ,x?@'uQx0K(+;F81)EF F#33#<zglobal-include Fz>warning: no files found matching '%s' anywhere in distributionr?zglobal-exclude zRwarning: no previously-included files matching '%s' found anywhere in distributionr@zrecursive-include {} {})prefixz:warning: no files found matching '%s' under directory '%s'rAzrecursive-exclude {} {}zNwarning: no previously-included files matching '%s' found under directory '%s'rBzgraft Nz+warning: no directories found matching '%s'rCzprune z6no previously-included directories found matching '%s'z$this cannot happen: invalid action 'r;) rIr r2include_patternrZwarningexclude_patternrr)rrDrErFr!rGpatternr$rHrprocess_template_lineZFileList.process_template_lineps 04/H/H/N,3 Y    Z#((8*<< =#++GD+AAKK GQ$y   Z#((8*<< =#++GD+AAKKS$' '   .(1CC D#++GE+BBKK7 $' '   .(1CC D#++GE+BBKKB $* *   6==c388HCUV W#++G+@@VCKKc2$ * *   6==c388HCUV W#++G+@@KK>  $w    X 3 4''['AA I;WBw    X 3 4''['AA MB )6vha@ rc ,V^8dQhRRRRRRRRR R/# r rNr'rJboolrK str | Noneis_regexzLiteral[False]r rrrrrr<  !   rc R#rrrrNrJrKrT&&&&&rrLFileList.include_patternrc rP r rNzstr | re.Pattern[str]rJrRrKrSrTz Literal[True]r rrrrrr<&    rc rVrrrW&&&&$rrLrYrc rPr[rrrrrr<&     rc rVrrrWrXrrLrYrZrc ,V^8dQhRRRRRRRRRR/# r rNzstr | re.PatternrJrRrKrSrTr rrrrrrs<--!-- -  -  -rc s^Rp\WW44pVPRVP R24VPfVP 4VPFQpVP V4'gKVPRV,4VP PV4RpKS V#)aSelect strings (presumably filenames) from 'self.files' that match 'pattern', a Unix-style wildcard (glob) pattern. Patterns are not quite the same as implemented by the 'fnmatch' module: '*' and '?' match non-special characters, where "special" is platform- dependent: slash on Unix; colon, slash, and backslash on DOS/Windows; and colon on Mac OS. If 'anchor' is true (the default), then the pattern match is more stringent: "*.py" will match "foo.py" but not "foo/bar.py". If 'anchor' is false, both of these will match. If 'prefix' is supplied, then only filenames starting with 'prefix' (itself a pattern) and ending with 'pattern', with anything in between them, will match. 'anchor' is ignored in this case. If 'is_regex' is true, 'anchor' and 'prefix' are ignored, and 'pattern' is assumed to be either a string containing a regex or a regex object -- no translation is done, the regex is just compiled and used as-is. Selected strings will be added to self.files. Return True if files are found, False otherwise. Fz"include_pattern: applying regex r'r;z adding T)translate_patternr rNrr#searchrr))rrNrJrKrT files_found pattern_reZname&&&&& rrLrYs@ &wI  =j>P>P=QQRST == LLNMMD  &&  d!23 !!$'" " rc rPrQrrrrrrrUrc rVrrrWrXrrMFileList.exclude_patternrZrc rPr[rrrrrrr\rc rVrrrWr]rrMrgr^rc rPr[rrrrrr"r_rc rVrrrWrXrrMrg!rZrc r`rarrrrrr)s<!     rc sRp\WW44pVPRVP R24\\ VP 4^, RR4FepVP VP V,4'gK-VPRVP V,,4VP VRpKg V#)zRemove strings (presumably filenames) from 'files' that match 'pattern'. Other parameters are the same as for 'include_pattern()', above. The list 'self.files' is modified in place. Return True if files are found, False otherwise. Fz"exclude_pattern: applying regex r'r;z removing Tr6)rbr rNr7r8rrc)rrNrJrKrTrdrer9rfrrMrg)s &wI  =j>P>P=QQRSTs4::*B3A  A//   1 !=>JJqM" 4 rr)NNTNF)TN)__name__ __module__ __qualname____firstlineno____doc__rr r/curdirr#r r)r+r4r:rIrOrrLrM__static_attributes__rrrrrs # !57II% !9"4Z#_find_all_simple..Is3:D%6TQV T  QV *s79) _UniqueDirsfilterr/Zwalkr0Zisfile)r0Z all_uniqueZresultsr3r_find_all_simplertDsE##BGGDd$CDJ:DG "''..' **rcs0]tRtRtRtRt]R4tRtR#)rriOzv Exclude previously-seen dirs from walk results, avoiding infinite recursion. Ref https://bugs.python.org/issue44497. c sVwr#p\P!V4pVPVP3pW`9pV'dVRVP V4V'*#)z Given an item from an os.walk result, determine if the item represents a unique dir for this instance and if not, prevent further traversal. :NNN)r/statZst_devZst_inoZadd)rZ walk_itemrprqrruZ candidateZfoundrHr__call__Z_UniqueDirs.__call__VsS &Ewwt}KK, ! Q yrc s$\V!4V4#r)rs)Zclsr*rrrsZ_UniqueDirs.filteresceU##rrN) rirjrkrlrmrvZ classmethodrsrorrrrrrrOs  $$rrrcr,)r r!r"rrrrrrjs  ' rcs\V4pV\P8Xd<\P!\P P VR7p\W!4p\V4#)z Find all files under 'dir' and return the list of full filenames. Unless dir is '.', return full filenames with dir prepended. )start) rtr/rn functoolsZpartialr0Zrelpathr.Zlist)r!rZmake_relr3rr#r#jsH S !E bii$$RWW__C@H$ ;rcs\P!V4p\Pp\PR8XdRpRV R2p\P !RW14pV#)zTranslate a shell-like glob pattern to a regular expression; return a string containing the regex. Differs from 'fnmatch.translate()' in that '*' does not match "special characters" (which are platform-specific). \z\\\\z\1[^Z]z((?CH+DE ff 66T>CE S_s3x-GH r)SEJ<uE "G2jU&>%?@J ::j !!rrh)rmZ __future__rrzrxr/r|Zcollections.abcrZtypingrrZ_logrZerrorsrrZutilrrrtZsetrrrnr#r}rbrrrrs` # $$Bii^ +$#$6+-)) .""r