&SSrSSKJr SSKrSSKrSSKJrJrJr SSK J r SSK J r SSK J r SSKJrJr SSKrS S KJr SS KJr SS KJr \(aSS KJr \R6R8rS%Sjr"SS5r"SS5r "SS\ 5r!"SS\!5r""SS\ 5r#"SS\"5r$"SS\#5r%S&Sjr&"SS5r'S'S jr(S'S!jr)S(S"jr*S)S#jr+S*S$jr,g)+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\[RRU5R5$N)ospathbasename isidentifier)rs Oplatform/bundledpythonunix/lib/python3.13/site-packages/setuptools/discovery.py _valid_namer?s 77  D ! . . 00c6\rSrSrSrSSjrS SjrS SjrSrg) _FilterDzw Given a list of patterns, create a callable that will be true only if the input matches at least one of the patterns. c8[RU5Ulgr)dictfromkeys _patterns)selfpatternss r__init___Filter.__init__Jsx0rcB^[U4SjUR55$)Nc3<># UHn[TU5v M g7frr).0patitems r #_Filter.__call__..NsD^c;tS))^s)anyr!r"r*s `r__call___Filter.__call__MsDT^^DDDrcXR;$rr!r.s r __contains___Filter.__contains__Ps~~%%rr2N)r#strreturnNone)r*r5r6bool) __name__ __module__ __qualname____firstlineno____doc__r$r/r3__static_attributes__rrrrDs 1E&rrc\rSrSr%SrSrS\S'SrS\S'\S S Sjj5r \S Sj5r Sr g ) _FinderTz@Base class that exposes functionality for module/package findersr?zClassVar[tuple[str, ...]]ALWAYS_EXCLUDEDEFAULT_EXCLUDEc U=(d URn[UR[[ U55[ /UR QUQ76[ U655$)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``. )rDlist _find_iterrr5rrCclswhereexcludeincludes rfind _Finder.findZsW40S00 NNSZ(6++6g6!   rc[er)NotImplementedErrorrHs rrG_Finder._find_iter}s "!rN).r?)*)rJrrK Iterable[str]rLrTr6 list[str]rJrrKrrLrr6z Iterator[str]) r9r:r;r<r=rC__annotations__rD classmethodrMrGr>r?rrrArATsJ02N-213O.3!#!'            D""&-"8?" ""rrAcT\rSrSrSrSr\SSj5r\S Sj5r Sr g) PackageFinderzA Generate a list of all Python packages found within a directory )ez_setupz *__pycache__c## [R"[U5SS9HupEnUSSn/USS&UHn[RR XH5n [RR X5n U R [RRS5n SU;dURX5(dMU"U 5(aU"U 5(dU v U S3U;d U S3U;aMURU5 M M g7f)za All the packages found in 'where' that pass the 'include' filter, but not the 'exclude' filter. T) followlinksNrRrS.*) rwalkr5rjoinrelpathreplacesep_looks_like_packageappend) rIrJrKrLrootdirsfilesall_dirsdir full_pathrel_pathpackages rrGPackageFinder._find_iters"$U!F DAwHDGGGLL3 77??9<"**277;;<#:S%<%r?rrrZrZsW2N!!&-!8?! !!BAArrZc(\rSrSr\SSj5rSrg)PEP420PackageFindercg)NTr?)_pathrss rre'PEP420PackageFinder._looks_like_packagesrr?N)rzrrsr5r6r8)r9r:r;r<rurer>r?rrrwrwsrrwcL\rSrSrSr\SSj5r\"\5r Sr g) ModuleFinderzQFind isolated Python modules. This function will **not** recurse subdirectories. c#\# [[RRUS55H{n[RR [RR U55upVUR U5(dMYU"U5(dMhU"U5(aMwUv M} g7f)Nz*.py)r rrrasplitextr_looks_like_module)rIrJrKrLfilemodule_exts rrGModuleFinder._find_itersteV45D77++BGG,<,r?rrr}r}sH  &- 8?    &k2rr}cX\rSrSrSr\"\"S\555r\SSj5r Sr g)FlatLayoutPackageFinder)#cibindebiandocdocs documentationmanpagesnews newsfragments changelogtesttests unit_test unit_testsexampleexamplesscriptstoolsutilutilspythonbuilddistvenvenv requirementstasksfabfile site_scons benchmark benchmarksexercise exerciseshtmlcov[._]*c#.# UH oUS34v M g7f)r_Nr?)r(ps rr+!FlatLayoutPackageFinder.s&GhaS8}hscURS5nUSR5=(d USRS5nU=(a [SUSS55$)NrRr-stubsc3@# UHoR5v M g7fr)r)r(names rr+>FlatLayoutPackageFinder._looks_like_package..s(S):):)<)<sr )splitrendswithall)rz package_namenamesroot_pkg_is_valids rre+FlatLayoutPackageFinder._looks_like_packagesU""3'!!H113RuQx7H7H7R SS(Sqr(S%SSrr?N)rzrrr5r6r8) r9r:r;r<_EXCLUDEtuple chain_iterrDrurer>r?rrrrs8'HRJ&Gh&GGHO TTrrc\rSrSrSrSrg)FlatLayoutModuleFinderi)setupconftestrrrrrtoxfilenoxfilepavementdodorrz[Ss][Cc]onstruct conanfilemanagerrrrrr?N)r9r:r;r<rDr>r?rrrrsO4*rrc[RU5nU/UVs/sHnSRX45PM sn-$s snf)NrR)rwrMra)root_pkgpkg_dirnestedns r_find_packages_withinr%s< % %g .F :&A&Q8-0&A AAAs=c\rSrSrSrSSjrSrSr\SSj5r \SSj5r SSSjjr SS jr SS jr SS jrSS jrSS jrSSjrSSjrSSjrSSjrSSjrSSjrSrg) ConfigDiscoveryi*z}Fill-in metadata and options that can be automatically derived (from other metadata/options, the file system or conventions) c:XlSUlSUlSUlg)NF)r_called _disabled_skip_ext_modules)r" distributions rr$ConfigDiscovery.__init__/s  !&rcSUlg)z+Internal API to disable automatic discoveryTN)rr"s r_disableConfigDiscovery._disable5s rcSUlg)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 "&rc\URR=(d [R$r)rsrc_rootrcurdirrs r _root_dirConfigDiscovery._root_dirEsyy!!.RYY.rc`URRc0$URR$r)r package_dirrs r _package_dirConfigDiscovery._package_dirJs' 99 (Iyy$$$rcUSLa#UR(dUR(agURU5 U(aUR5 SUlg)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"forcerignore_ext_moduless rr/ConfigDiscovery.__call__Ps? E>t||t~~  $$%78      rclU=(d URnURRSL=(d U(+nURRSL=(d[ URRSL=(d< U=(d3 [ URS5=(a URR $)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/I43I3I9900D8N# UH1up[U[RRTU55v M3 g7fr)rrrra)r(pkg parent_dirroot_dirs rr+;ConfigDiscovery._analyse_explicit_layout..s3 #6 "#rww||Hj'I J J#6s9<discovered packages -- T) rcopypoprrrritemsrFrr)r"rpkgsrs @rr(ConfigDiscovery._analyse_explicit_layouts'',,. D!>> <[MJK #.#4#4#6  "$Z  +DII,>,>+?@ArcURn[RRURUR SS55n[RR U5(dg[R"SU35 URS[RRU55 XRl [RU5URl[ RU5URl[R"SURR35 [R"SURR"35 g)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)rrrrargetisdirrr setdefaultrrrrwrMrr}r)r"rsrc_dirs rr#ConfigDiscovery._analyse_src_layouts'' '',,t~~{r5/IJww}}W%% 7yABr277#3#3G#<= + 055g> +009  +DII,>,>+?@A -dii.B.B-CDErc[R"SUR35 UR5=(d UR 5$)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 )rrr_analyse_flat_packages_analyse_flat_modulesrs rr$ConfigDiscovery._analyse_flat_layouts: 88HIJ**,L0J0J0LLrcB[RUR5URl[ [ URR55n[R"SURR35 URUS5 [U5$)Nrr) rrMrrrremove_nested_packages remove_stubsrr_ensure_no_accidental_inclusionr8)r" top_levels rr&ConfigDiscovery._analyse_flat_packagesso499$..I *< 8J8J+KL  +DII,>,>+?@A ,,Y CIrcB[RUR5URl[ R "SURR35 URURRS5 [URR5$)Nr modules) rrMrrrrrrr8rs rr%ConfigDiscovery._analyse_flat_modulessk5::4>>J  -dii.B.B-CDE ,,TYY-A-A9MDII(())rcn[U5S:a&SSKJn SSKJn SUSUSUS3nU"U"U55eg) Nr 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. )leninspectrsetuptools.errorsr)r"detectedkindrrmsgs rr/ConfigDiscovery._ensure_no_accidental_inclusionsU x=1  ( ?)$/MhZXM NRF S C( 6 6) rcDURRR(dURR(ag[R"S5 UR 5=(d UR 5nU(aXRRlgg)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)rmetadatarrr#_find_name_single_package_or_module_find_name_from_packages)r"rs rrConfigDiscovery.analyse_nameso 99   " "diinn  KL  4 4 6 /,,.  &*II   # rcSH^n[URUS5=(d /nU(dM,[U5S:XdM=[R"SUS35 USs $ g)zExactly one module or package)rrNr z&Single module/package detected, name: r)getattrrrrr)r"fieldrs rr(3ConfigDiscovery._find_name_single_package_or_modulesX/EDIIud39rEuUq B58*MNQx 0 rclURR(dg[[URR[S95nURR =(d 0n[ XUR5nU(a[R"SU35 U$[R"S5 g)zzlK L  JKr)rrrrN)rrr6r7)r6r)r6dict[str, str])FTF)rr8rr8rr8r6r7)rr8r6r8)r6r8)r"rUr#r5)r6r7)r6 str | None)r9r:r;r<r=r$rrpropertyrrr/rrrrrrrrrr(r)r>r?rrrr*s'  &//%% RW)-JN .   $$2 M* 7.+"rrc^[U[S9nUSSn[U5n[[U55H8unm[ U4SjU55(dM"UR X4- S- 5 M: U$)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'] r0Nc3L># UHnTRUS35v M g7frRN startswith)r(otherrs rr+)remove_nested_packages..s#Ct%{++s!$r )r2r enumeratereversedr-r)rrrsizeirs @rrrse ( $DQI t9DXd^,4 CC C C MM$(Q, '- rcUVs/sH.oRS5SRS5(aM,UPM0 sn$s snf)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'] rRrr)rr)rrs rrr s4 $ P8C99S>!+<+E+Eh+OC8 PP Ps+==cn^[U[S9n/n[U5H8unm[U4SjXS-S55(d OUR T5 M: UHWm[ TX5n[ RRUS5n[ RRU5(dMUTs $ g)z0Find the parent package that is not a namespace.r0c3J># UHoRTS35v M g7fr<r=)r(rrs rr+&find_parent_package..0s#G5F<<4& ++5Fs #r Nrq) r2rrArrffind_package_pathrrrarr)rrrcommon_ancestorsrDpkg_pathinitrs @rr3r3)shC(HX&4GX!eg5FGGG %'!$T;Aww||Hm4 77>>$  K ! rczURS5n[[U5SS5HEnSRUSU5nXQ;dMXn[R R"X&/X4SQ76s $ UR S5=(d Sn[R R"U/URS5QUQ76$)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' rRrNr/)rrangerrarrr )rrrpartsrD partial_nameparents rrIrIAs, JJsOE 3u:q" %xxbq *  & .F77<<=59= = &__R &BF 77<< =6<<#4 =u ==rc [U5n[U5RnUVs0sH'oDSR/UQUR S5Q5_M) sn$s snf)NrOrR)rr rQrar)r package_path parent_pkgsprefixrs rconstruct_package_dirrXcsS(2K ,  % %FAL M#4F4SYYs^45 5 MM Ms.A)rrr6r8)rr5rrr6rU)rrUr6rU)rrUrMapping[str, str]rrr6r8)rr5rrYrrr6r5)rrUrUrr6r7)-r= __future__r itertoolsrcollections.abcrrrfnmatchrr pathlibr typingr r _distutils_hack.override_distutils_hackrzr distutilsrdistutils.utilr setuptoolsrchain from_iterablerrrrArZrwr}rrrrrrr3rIrXr?rrrgs%N# 77*'' __ * * 1 & & -"-"`,AG,A^- 37322T12Tj*\*<B aaH$Q&7CJ0> >->9@>>DNr