+ =i&SRt^RIHt^RIt^RIt^RIHtHtHt^RI H t ^RI H t ^RI H t ^RIHtHt^RIt^RIHt^R IHt^R IHt]'d^R IHt]P6P8tR R lt!RR4t!RR4t !RR] 4t!!RR]!4t"!RR] 4t#!RR]"4t$!RR]#4t%RRlt&!RR4t'R R!lt(R"R#lt)R$R%lt*R&R'lt+R(R)lt,R#)*u_Automatic discovery of Python modules and packages (for inclusion in the distribution) and other config values. For the purposes of this module, the following nomenclature is used: - "src-layout": a directory representing a Python project that contains a "src" folder. Everything under the "src" folder is meant to be included in the distribution when packaging the project. Example:: . ├── tox.ini ├── pyproject.toml └── src/ └── mypkg/ ├── __init__.py ├── mymodule.py └── my_data_file.txt - "flat-layout": a Python project that does not use "src-layout" but instead have a directory under the project root for each package:: . ├── tox.ini ├── pyproject.toml └── mypkg/ ├── __init__.py ├── mymodule.py └── my_data_file.txt - "single-module": a project that contains a single Python script direct under the project root (no directory used):: . ├── tox.ini ├── pyproject.toml └── mymodule.py ) annotationsN)IterableIteratorMapping fnmatchcase)glob)Path) TYPE_CHECKINGClassVar)StrPath)log) convert_path) Distributionc V^8dQhRRRR/#)pathr returnbool)formats"w/Users/tonyclaw/.openclaw/workspace/scripts/youtube-playlists/venv/lib/python3.14/site-packages/setuptools/discovery.py __annotate__r?s11g1$1c\\PPV4P4#N)osrbasename isidentifier)rs&r _valid_namer?s 77  D ! . . 00rc>]tRt^DtRtRRltRRltRRltRtR #) _Filterzw Given a list of patterns, create a callable that will be true only if the input matches at least one of the patterns. c V^8dQhRRRR/#)rpatternsstrrNoner)rs"rr_Filter.__annotate__Js11#1$1rc :\PV4VnR#r)dictfromkeys _patterns)selfr#s&*r__init___Filter.__init__Jsx0rc V^8dQhRRRR/#ritemr$rrr)rs"rrr&MsEESETErc a\;QJd)V3RlVP4F 'gK R# R#!V3RlVP44#)c3<<"TFp\SV4xK R#5irr).0patr0s& r #_Filter.__call__..NsD^c;tS))^sTF)anyr*r+r0s&fr__call___Filter.__call__Ms4sDT^^DssDsDsDT^^DDDrc V^8dQhRRRR/#r/r)rs"rrr&Ps&&&&rc WP9#rr*r8s&&r __contains___Filter.__contains__Ps~~%%rr=N) __name__ __module__ __qualname____firstlineno____doc__r,r9r>__static_attributes__rrrr!r!Ds 1E&&rr!ch]tRt^Tt$RtR tR]R&R tR]R&]R RRll4t ]RRl4t R t R #) _Finderz@Base class that exposes functionality for module/package finderszClassVar[tuple[str, ...]]ALWAYS_EXCLUDEDEFAULT_EXCLUDEc(V^8dQhRRRRRRRR/#)rwherer excludez Iterable[str]includer list[str]r)rs"rr_Finder.__annotate__[s2           rc  T;'g VPp\VP\\ V44\ .VP OVO5!\ V!44#)aReturn a list of all Python items (packages or modules, depending on the finder implementation) found within directory ``where``. ``where`` is the root directory which will be searched. It should be supplied as a "cross-platform" (i.e. URL-style) path; it will be converted to the appropriate local path syntax. ``exclude`` is a sequence of names to exclude; ``*`` can be used as a wildcard in the names. When finding packages, ``foo.*`` will exclude all subpackages of ``foo`` (but not ``foo`` itself). ``include`` is a sequence of names to include. If it's specified, only the named items will be included. If it's not specified, all found items will be included. ``include`` can contain shell style wildcard patterns just like ``exclude``. )rIlist _find_iterrr$r!rHclsrKrLrMs&&&&rfind _Finder.findZsZ400S00 NNSZ(6++6g6!   rc(V^8dQhRRRRRRRR/#rrKr rLr!rMrz Iterator[str]r)rs"rrrO~s,"""&-"8?" "rc \hr)NotImplementedErrorrSs&&&&rrR_Finder._find_iter}s "!rrN).r)*) r@rArBrCrDrH__annotations__rI classmethodrUrRrErrrrGrGTsBJ02N-213O.3    D""rrGcJ]tRt^tRtRt]RRl4t]RRl4t Rt R#) PackageFinderzA Generate a list of all Python packages found within a directory c(V^8dQhRRRRRRRR/#rXr)rs"rrPackageFinder.__annotate__s,!!!&-!8?! !rc# 0"\P!\V4RR7FwrEpVR,p.VR&VFp\PP WH4p \PP W4p V P \PPR4p RV9gVPW4'gKV!V 4'dV!V 4'gV xV R2V9g V R2V9dKVPV4K K R#5i)za All the packages found in 'where' that pass the 'include' filter, but not the 'exclude' filter. T) followlinksNNNr\r].*N) rwalkr$rjoinrelpathreplacesep_looks_like_packageappend) rTrKrLrMrootdirsfilesall_dirsdir full_pathrel_pathpackages &&&& rrRPackageFinder._find_iters"$U!F DAwHDGGGLL3 77??9<"**277;;<#:S%<%s&GhaS8}hsc$V^8dQhRRRRRR/#)rrr package_namer$rrr)rs"rr$FlatLayoutPackageFinder.__annotate__s&TT7T#T$Trc *VPR4pV^,P4;'gV^,PR4pT;'dC\;QJd#RVR,4F 'dK R# R#!RVR,44#)r\-stubsc3@"TFqP4xK R#5ir)r)r3names& rr5>FlatLayoutPackageFinder._looks_like_package..s(S):):)<)<s:NNFT)splitrendswithall)rrnamesroot_pkg_is_valids&& rrm+FlatLayoutPackageFinder._looks_like_packagesu""3'!!H113RRuQx7H7H7R SSSS(Sr(SSSSSSS(Sr(S%SSrrN)#cibindebiandocdocs documentationmanpagesnews newsfragments changelogtesttests unit_test unit_testsexampleexamplesscriptstoolsutilutilspythonbuilddistvenvenv requirementstasksfabfile site_scons benchmark benchmarksexercise exerciseshtmlcov[._]*) r@rArBrC_EXCLUDEtuple chain_iterrIrrmrErrrrrs8'HRJ&Gh&GGHO TTrrc]tRtRtRtRtR#)FlatLayoutModuleFinderirN)setupconftestrrrrrtoxfilenoxfilepavementdodorrz[Ss][Cc]onstruct conanfilemanagerrrrr)r@rArBrCrIrErrrrrsO4*rrc$V^8dQhRRRRRR/#)rroot_pkgr$pkg_dirr rrNr)rs"rrr%s&BBCB'BiBrc\PV4pV.VUu.uFpRPW34NK up,#uupi)r\)rrUri)rrnestedns&& r_find_packages_withinr%s< % %g .F :&A&Q8-0&A AAAsAc]tRtRtRtRRltRtRt]RRl4t ]R R l4t R%R R llt R Rlt RRlt RRltRRltRRltRRltRRltRRltRRltRR ltR!R"ltR#tR$#)&ConfigDiscoveryi*z}Fill-in metadata and options that can be automatically derived (from other metadata/options, the file system or conventions) c V^8dQhRRRR/#)r distributionrrr%r)rs"rrConfigDiscovery.__annotate__/s''\'d'rc <WnRVnRVnRVnR#)FN)r_called _disabled_skip_ext_modules)r+rs&&rr,ConfigDiscovery.__init__/s  !&rc RVnR#)z+Internal API to disable automatic discoveryTN)rr+s&r_disableConfigDiscovery._disable5s rc RVnR#)aInternal API to disregard ext_modules. Normally auto-discovery would not be triggered if ``ext_modules`` are set (this is done for backward compatibility with existing packages relying on ``setup.py`` or ``setup.cfg``). However, ``setuptools`` can call this function to ignore given ``ext_modules`` and proceed with the auto-discovery if ``packages`` and ``py_modules`` are not given (e.g. when using pyproject.toml metadata). TN)rrs&r_ignore_ext_modules#ConfigDiscovery._ignore_ext_modules9s "&rcV^8dQhRR/#)rrr r)rs"rrrFs//7/rc ^VPP;'g\P#r)rsrc_rootrcurdirrs&r _root_dirConfigDiscovery._root_dirEs yy!!..RYY.rcV^8dQhRR/#)rrdict[str, str]r)rs"rrrKs%%n%rc bVPPf/#VPP#r)r package_dirrs&r _package_dirConfigDiscovery._package_dirJs' 99 (Iyy$$$rc(V^8dQhRRRRRRRR/#)rforcerrignore_ext_modulesrr%r)rs"rrrPs,)-JN rc VRJd'VP'gVP'dR#VPV4V'dVP4RVnR#)ayAutomatically discover missing configuration fields and modifies the given ``distribution`` object in-place. Note that by default this will only have an effect the first time the ``ConfigDiscovery`` object is called. To repeatedly invoke automatic discovery (e.g. when the project directory changes), please use ``force=True`` (or create a new ``ConfigDiscovery`` instance). FNT)rr_analyse_package_layout analyse_name)r+rrrs&&&&rr9ConfigDiscovery.__call__PsC E>t|||t~~~  $$%78      rc V^8dQhRRRR/#rrrrr)rs"rrrgs       rc xT;'g VPpVPPRJ;'gT'*pVPPRJ;'g_VPPRJ;'g?T;'g5\ VPR4;'dVPP #)zF``True`` if the user has specified some form of package/module listingN configuration)rr ext_modulespackages py_moduleshasattrr)r+rrs&& r_explicitly_specified%ConfigDiscovery._explicitly_specifiedgs/II43I3I9900D8NN.s3 #6 "#rww||Hj'I J J#6s9<discovered packages -- T) rcopypoprr r ritemsrQrr)r+rpkgsrs& @rr(ConfigDiscovery._analyse_explicit_layouts'',,. D!>> <[MJK #.#4#4#6  "$Z  +DII,>,>+?@ArcV^8dQhRR/#rr)rs"rrrsTrc VPp\PPVPVP RR44p\PP V4'gR#\P!RV 24VPR\PPV44WPn \PV4VPn\ PV4VPn\P!RVPP 24\P!RVPP" 24R#)avTry to find all packages or modules under the ``src`` directory (or anything pointed by ``package_dir[""]``). The "src-layout" is relatively safe for automatic discovery. We assume that everything within is meant to be included in the distribution. If ``package_dir[""]`` is not given, but the ``src`` directory exists, this function will set ``package_dir[""] = "src"``. rsrcFz#`src-layout` detected -- analysing rdiscovered py_modules -- T)rrrrirgetisdirr r  setdefaultrrrrrUrrr)r+rsrc_dirs& rr#ConfigDiscovery._analyse_src_layouts'' '',,t~~{r5/IJww}}W%% 7yABr277#3#3G#<= + 055g> +009  +DII,>,>+?@A -dii.B.B-CDErcV^8dQhRR/#rr)rs"rrrs M Md Mrc \P!RVP 24VP4;'gVP 4#)aTry to find all packages and modules under the project root. Since the ``flat-layout`` is more dangerous in terms of accidentally including extra files/directories, this function is more conservative and will raise an error if multiple packages or modules are found. This assumes that multi-package dists are uncommon and refuse to support that use case in order to be able to prevent unintended errors. z$`flat-layout` detected -- analysing )r r r_analyse_flat_packages_analyse_flat_modulesrs&rr$ConfigDiscovery._analyse_flat_layouts= 88HIJ**,LL0J0J0LLrcV^8dQhRR/#rr)rs"rrrsrc B\PVP4VPn\ \ VPP44p\P!RVPP 24VPVR4\V4#)rr) rrUrrrremove_nested_packages remove_stubsr r _ensure_no_accidental_inclusionr)r+ top_levels& rr,&ConfigDiscovery._analyse_flat_packagesso499$..I *< 8J8J+KL  +DII,>,>+?@A ,,Y CIrcV^8dQhRR/#rr)rs"rrrs**t*rc B\PVP4VPn\ P !RVPP 24VPVPPR4\VPP4#)r$modules) rrUrrrr r r3rrs&rr-%ConfigDiscovery._analyse_flat_modulessk5::4>>J  -dii.B.B-CDE ,,TYY-A-A9MDII(())rc V^8dQhRRRR/#)rdetectedrNkindr$r)rs"rrrs77 77rc r\V4^8d'^RIHp^RIHpRV RV RV R2pV!V!V44hR#)r)cleandoc)PackageDiscoveryErrorzMultiple top-level z discovered in a flat-layout: z. To avoid accidental inclusion of unwanted files or directories, setuptools will not proceed with this build. If you are trying to create a single distribution with multiple a on purpose, you should not rely on automatic discovery. Instead, consider the following options: 1. set up custom discovery (`find` directive with `include` or `exclude`) 2. use a `src-layout` 3. explicitly set `py_modules` or `packages` with a list of names To find more information, look for "package discovery" on setuptools docs. N)leninspectr>setuptools.errorsr?)r+r;r<r>r?msgs&&& rr3/ConfigDiscovery._ensure_no_accidental_inclusionsU x=1  ( ?)$/MhZXM NRF S C( 6 6) rcV^8dQhRR/#)rrr%r)rs"rrrs++d+rc RVPPP'gVPP'dR#\P!R4VP 4;'gVP 4pV'dWPPnR#R#)zThe packages/modules are the essential contribution of the author. Therefore the name of the distribution can be derived from them. Nz7No `name` configuration, performing automatic discovery)rmetadatarr r #_find_name_single_package_or_module_find_name_from_packages)r+rs& rrConfigDiscovery.analyse_namesy 99   " " "diinnn  KL  4 4 6 / /,,.  &*II   # rcV^8dQhRR/#rr str | Noner)rs"rrrsZrc RFip\VPVR4;'g.pV'gK.\V4^8XgK@\P!RV^, 24V^,u# R#)zExactly one module or packageNz&Single module/package detected, name: )rr)getattrrr@r r )r+fieldrs& rrH3ConfigDiscovery._find_name_single_package_or_modules[/EDIIud399rEuUq B58*MNQx 0 rcV^8dQhRR/#rLr)rs"rrrs*rc |VPP'gR#\\VPP\R74pVPP ;'g/p\ WVP4pV'd\P!RV 24V#\P!R4R#)zzlK L  JKr)rrrrN)FTF)r@rArBrCrDr,rrpropertyrrr9r rrrrr,r-r3rrHrIrErrrrr*s'  &//%% .   $$2 M* 7.+"rrc V^8dQhRRRR/#rrrNrr)rs"rrrsY9rcNa\V\R7pVR,p\V4p\\V44Ffwpo\;QJdV3RlV4F 'gK RM RM!V3RlV44'gKHVP W4, ^, 4Kh V#)zRemove nested packages from a list of packages. >>> remove_nested_packages(["a", "a.b1", "a.b2", "a.b1.c1"]) ['a'] >>> remove_nested_packages(["a", "b", "c.d", "c.d.e.f", "g.h", "a.a1"]) ['a', 'b', 'c.d', 'g.h'] rTrfc3L<"TFpSPV R24xK R#5ir\N startswith)r3otherrs& rr5)remove_nested_packages..s#Ct%{++s!$TF)rVr@ enumeratereversedr7r)rrr4sizeirs& @rr1r1su ( $DQI t9DXd^,4 3CC333CC C C MM$(Q, '- rc V^8dQhRRRR/#r]r)rs"rrr sQQ9QQrcVUu.uF3qPR4^,PR4'dK1VNK5 up#uupi)zRemove type stubs (:pep:`561`) from a list of packages. >>> remove_stubs(["a", "a.b", "a-stubs", "a-stubs.b.c", "b", "c-stubs"]) ['a', 'a.b', 'b'] r\r)rr)rrs& rr2r2 s6 $ P8C99S>!+<+E+Eh+OCC8 PP Ps .AAc(V^8dQhRRRRRRRR/#) rrrNrMapping[str, str]rr rrMr)rs"rrr)s,&7CJrca\V\R7p.p\V4Fkwpo\;QJd(V3RlW^,R4F 'dK RM RM!V3RlW^,R44'gMVP S4Km VFXo\ SW4p\ PPVR4p\ PPV4'gKVSu# R#)z0Find the parent package that is not a namespace.rTc3J<"TFqPS R24xK R#5ir`ra)r3rrs& rr5&find_parent_package..0s#G5F<<4& ++5Fs #NFTr{) rVr@rerrnfind_package_pathrrrir|)rrrcommon_ancestorsrhpkg_pathinitrs&&& @rrWrW)shC(HX&4sGX!eg5FGsssGX!eg5FGGG %'!$T;Aww||Hm4 77>>$  K ! rc(V^8dQhRRRRRRRR/#)rrr$rrlrr rr)rs"rrrAs,>> >->9@>>rcVPR4p\\V4^R4FKpRPVRV4pWQ9gKW,p\P P!W&.W4RO5!u# VP R4;'gRp\P P!V.VPR4OVO5!#)a_Given a package name, return the path where it should be found on disk, considering the ``package_dir`` option. >>> path = find_package_path("my.pkg", {"": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested/my/pkg' >>> path = find_package_path("my.pkg", {"my": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested/pkg' >>> path = find_package_path("my.pkg", {"my.pkg": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested' >>> path = find_package_path("other.pkg", {"my.pkg": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './other/pkg' r\Nr/)rranger@rirrr%)rrrpartsrh partial_nameparents&&& rrprpAs, JJsOE 3u:q" %xxbq *  & .F77<<=59= = &__R & &BF 77<< =6<<#4 =u ==rc$V^8dQhRRRRRR/#)rrrN package_pathr rrr)rs"rrrcs&NNINWNNrc \V4p\V4PpVUu/uF'qDRP.VOVP R4O4bK) up#uupi)rvr\)r1r ryrir)rr} parent_pkgsprefixrs&& rconstruct_package_dirrcsS(2K ,  % %FAL M#4F4SYYs^45 5 MM Ms-A)-rD __future__r itertoolsrcollections.abcrrrfnmatchrrpathlibr typingr r _distutils_hack.override_distutils_hackrr distutilsr distutils.utilr setuptoolsrchain from_iterablerrr!rGrarrrrrrr1r2rWrprrrrrs%N# 77*'' __ * * 1 & & -"-"`,AG,A^- 37322T12Tj*\*<B aaH$Q0>DNr