vKg>SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKJ r J r J r SSK J r SSKJr SSKJrJr SSKJr SS KJr SS KJrJr SS KJrJrJrJr S S KJrJ r! S SK"J#r# S SK$J%r% SSK&J'r' \(a SSK(J)r) SSK*J+r+ \"S5r,\"SSS9r-"SS5r.S/S0Sjjr/S/S1Sjjr0S2Sjr1S3Sjr2S4Sjr3S5S6Sjjr4S7Sjr5S8S jr6S9S!jr7S5S:S"jjr8S5S;S#jjr9SSSS$.SS'jrSASBS*jjr?"S+S,5r@"S-S.\ \,\-45rAg)CaiUtility functions to expand configuration directives or special values (such glob patterns). We can split the process of interpreting configuration files into 2 steps: 1. The parsing the file contents from strings to value objects that can be understand by Python (for example a string with a comma separated list of keywords into an actual Python list of strings). 2. The expansion (or post-processing) of these values according to the semantics ``setuptools`` assign to them (for example a configuration field with the ``file:`` directive should be expanded from a list of file paths to a single string with the contents of those files concatenated) This module focus on the second step, and therefore allow sharing the expansion functions among several configuration file formats. **PRIVATE MODULE**: API reserved for setuptools internal usage only. ) annotationsN)IterableIteratorMapping) ConfigParser)iglob) ModuleSpec all_suffixes)chain)Path) ModuleType TracebackType) TYPE_CHECKINGAnyCallableTypeVar)StrPath same_path)find_package_path)SetuptoolsWarning)DistutilsOptionError)Self) Distribution_K_V_coT) covariantc6\rSrSrSrSSjrS SjrS SjrSrg) StaticModule4z>Proxy to a module object that avoids executing arbitrary code.c[R"[R"UR5R 55n[ U5R[55 U? gN) astparsepathlibr origin read_bytesvarsupdatelocalsself)r+namespecmodules X/var/www/highfloat_scraper/venv/lib/python3.13/site-packages/setuptools/config/expand.py__init__StaticModule.__init__7s?7<< 4??AB T &(# Ic#f^# URRHm[T[R5(a U4SjTR 5ShvN MB[T[R 5(dMcTR(dMvTRTR4v M gNY7f)Nc3<># UHoTR4v M g7fr")value).0target statements r/ 1StaticModule._find_assignments..?sVDU&Y__5DUs) r.body isinstancer#Assigntargets AnnAssignr5r7)r+r8s @r/_find_assignmentsStaticModule._find_assignments<sp))I)SZZ00VIDUDUVVVIs}}55)/// ''99 *VsAB1B/#B1=B1 B1c^[U4SjUR555$![a n[URST35UeSnAff=f)zHAttempt to load an attribute "statically", via :func:`ast.literal_eval`.c3># UHPup[U[R5(dM&URT:XdM8[R"U5v MR g7fr")r<r#Nameid literal_eval)r6r7r5attrs r/r9+StaticModule.__getattr__..FsI%=MFfchh/(4:II4E(  ''%=s$AAAz has no attribute N)nextr@ ExceptionAttributeErrorr,)r+rGes ` r/ __getattr__StaticModule.__getattr__Cs] P%)%;%;%=   P DII;.@!GHa O Ps"& AA  AN)r,strr-r returnNone)rQz!Iterator[tuple[ast.AST, ast.AST]])rGrP) __name__ __module__ __qualname____firstlineno____doc__r0r@rM__static_attributes__rOr2r/rr4sH : Pr2rc  ^^1Skn/nT=(d [R"5mUHm[U4SjU55(ak[RR [RR TT55nUR [U4Sj[USS9555 M[RRTT5R[RS5nURU5 M U$)zExpand the list of glob patterns, but preserving relative paths. :param list[str] patterns: List of glob patterns :param str root_dir: Path to which globs should be relative (current directory by default) :rtype: list >*?[]{}c3*># UH oT;v M g7fr"rO)r6charr5s r/r9 glob_relative..^s9u}sc3># UHCn[RRUT5R[RS5v ME g7f)/N)ospathrelpathreplacesepr6rfroot_dirs r/r9rbbs; @GGOOD(3;;BFFCHH @sA A T) recursiverd) regetcwdanyrfabspathjoinextendsortedrrgrhriappend)patternsrkglob_charactersexpanded_values glob_pathrfr5s ` @r/ glob_relativerxOs5OO&299;H 99 9 9 Xu(EFI  " " %i4 @ 77??5(3;;BFFCHD  " "4 (" r2c^SSKJn [RR T=(d [R "55mU4SjU"U55nSR U4Sj[U555$)zReturn the content of the files concatenated using `` `` as str This function is sandboxed and won't reach anything outside ``root_dir`` (By default ``root_dir`` is the current directory). r)always_iterablec3b># UH%n[RRTU5v M' g7fr"rerfrprjs r/r9read_files..|s%V;U4"'',,x..;Us,/ c3^># UH#n[UT5(dM[U5v M% g7fr") _assert_local _read_filerjs r/r9r}}s,6D x (  46s--)more_itertoolsrzrerfrormrp_filter_existing_files) filepathsrkrz _filepathss ` r/ read_filesrpsW/wwx6299;7HV?9;UVJ 99*:6 r2c## UHHn[RRU5(aUv M-[R"SU<S35 MJ g7f)NzFile z cannot be found)rerfisfileremit)rrfs r/rrs? 77>>$  J  " "U4(2B#C D sAAcl[USS9nUR5sSSS5 $!,(df  g=f)Nzutf-8)encoding)openread)filepathfs r/rrs# h )Qvvx * ) )s% 3c[[RRU55[[RRU55R;aSU<SU<S3n[ U5eg)NzCannot access z (or anything outside )T)r rerfroparentsr)rrkmsgs r/rrsW BGGOOH %&d277??83L.M.U.UUxl*@ AN"3'' r2czU=(d [R"5nUR5RS5nUR 5nSR U5nU=(d Sn[ XQU5n[XV5n[[XW5U5$![a [Xu5n[X5s$f=f)aReads the value of an attribute from a module. This function will try to read the attributed statically first (via :func:`ast.literal_eval`), and only evaluate the module if it fails. Examples: read_attr("package.attr") read_attr("package.module.attr") :param str attr_desc: Dot-separated string describing how to reach the attribute (see examples above) :param dict[str, str] package_dir: Mapping of package names to their location in disk (represented by paths relative to ``root_dir``). :param str root_dir: Path to directory containing all the packages in ``package_dir`` (current directory by default). :rtype: str .r0) rermstripsplitpoprp _find_module _find_specgetattrrrJ _load_spec) attr_desc package_dirrk attrs_path attr_name module_namerfr-r.s r/ read_attrrs,&299;H"((-J I((:&K+K  ( ;D k (D*|K6 BB *D.v))*sB B:9B:c[RRX5nU=(d [RRU5nUc [ U5eU$r") importlibutilspec_from_file_location find_specModuleNotFoundError)r module_pathr-s r/rrsD >> 1 1+ KD  89>>++K8D |!+.. Kr2c&[USU5nU[R;a[RU$[RR U5nU[RU'UR ceUR RU5 U$)NrS)rsysmodulesrrmodule_from_specloader exec_module)r-rr,r.s r/rrst 4[ 1D s{{{{4  ^^ , ,T 2FCKK ;; "" "KKF# Mr2c^[X=(d 0U5m[R"U4Sj[555n[ SU5S5$)aFind the path to the module named ``module_name``, considering the ``package_dir`` in the build configuration and ``root_dir``. >>> tmp = getfixture('tmpdir') >>> _ = tmp.ensure("a/b/c.py") >>> _ = tmp.ensure("a/b/d/__init__.py") >>> r = lambda x: x.replace(str(tmp), "tmp").replace(os.sep, "/") >>> r(_find_module("a.b.c", None, tmp)) 'tmp/a/b/c.py' >>> r(_find_module("f.g.h", {"": "1", "f": "2", "f.g": "3", "f.g.h": "a/b/d"}, tmp)) 'tmp/a/b/d/__init__.py' c3t># UH.nTU3[RRTSU354v M0 g7f)r0Nr|)r6ext path_starts r/r9_find_module..s<%!C <u rww||J(3%8HIJ!s58c3p# UH-n[RRU5(dM)Uv M/ g7fr")rerfr)r6xs r/r9rs!%J  R>41A}QX6 6> RR Rs0) namespacesfill_package_dirrkc ^ SSKJnJn SSKJn U(dSSKJn OSSKJn U=(d [RnURSS/5n/n Uc0OUn[U"U"U555m [T 5S:Xa1[U 4S jSU455(aURS T S5 T Hn [X*5n UR"U 40UD6n U R!U 5 U (dM;UR#S 5U :XaMR[R$R'X5(aMxUR)U"X55 M U $) aWorks similarly to :func:`setuptools.find_packages`, but with all arguments given as keyword arguments. Moreover, ``where`` can be given as a list (the results will be simply concatenated). When the additional keyword argument ``namespaces`` is ``True``, it will behave like :func:`setuptools.find_namespace_packages`` (i.e. include implicit namespaces as per :pep:`420`). The ``where`` argument will be considered relative to ``root_dir`` (or the current working directory when ``root_dir`` is not given). If the ``fill_package_dir`` argument is passed, this function will consider it as a similar data structure to the ``package_dir`` configuration parameter add fill-in any missing package location. :rtype: list r)rzunique_everseen)construct_package_dir) PackageFinder)PEP420PackageFinderwhererrc3J># UHn[TSU5(+v M g7f)rN) _same_path)r6rsearchs r/r9 find_packages...s"VoJvay!$< < rr)rerfrpnormpath)parentrfs r/rr=s2Y&6BGGLL,FD 77  D !!r2c[U5(aU"5OUn[U[5(aU$[US5(aSR [ [U55$SU-$)zXWhen getting the version directly from an attribute, it should be normalised to string. __iter__rz%s)callabler<rPhasattrrpmap)r5_values r/versionrBsT!UWUF&# vz""xxC()) &=r2c:SU;aURS5US'U$)NrZr)r) package_datas r/canonic_package_datarOs% l'++C0 R r2c [U[5(aU$UR5VVs/sHup#U[X154PM snn$s snnf)zFor compatibility with ``setup.py``, ``data_files`` should be a list of pairs instead of a dict. This function also expands glob patterns. )r<rrrx) data_filesrkdestrts r/canonic_data_filesrUsS*d##)..0 0ND }X010  sAc  [SSS9n[UlURX5 UR 5VVs0sHup4U[ UR 55_M! nnnUR URS5 U$s snnf)a+Given the contents of entry-points file, process it into a 2-level dictionary (``dict[str, dict[str, str]]``). The first level keys are entry-point groups, the second level keys are entry-point names, and the second level values are references to objects (that correspond to the entry-point value). N)=)default_section delimiters)rrP optionxform read_stringrdictrr)text text_sourceparserrrgroupss r/ entry_pointsrfso$6 BFF t)-3\\^ <^TQaaggi ^F < JJv%%t, M=s%Bcf\rSrSrSrS SjrSrS SjrS SjrSSjr \ SSj5r S r g )EnsurePackagesDiscoveredixaSome expand functions require all the packages to already be discovered before they run, e.g. :func:`read_attr`, :func:`resolve_class`, :func:`cmdclass`. Therefore in some cases we will need to run autodiscovery during the evaluation of the configuration. However, it is better to postpone calling package discovery as much as possible, because some parameters can influence it (e.g. ``package_dir``), and those might not have been processed yet. cXlSUlg)NF)_dist_called)r+ distributions r/r0!EnsurePackagesDiscovered.__init__s!  r2chUR(d!SUlURRSS9 gg)zBTrigger the automatic package discovery, if it is still necessary.TF)r,N)rr set_defaultsr+s r/__call__!EnsurePackagesDiscovered.__call__s*||DL JJ # # # /r2cU$r"rOr s r/ __enter__"EnsurePackagesDiscovered.__enter__s r2cpUR(a%URRR5 ggr")rrr analyse_name)r+exc_type exc_value tracebacks r/__exit__!EnsurePackagesDiscovered.__exit__s& << JJ # # 0 0 2 r2cJU"5 URRnUc0$U$r")rr)r+pkg_dirs r/_get_package_dir)EnsurePackagesDiscovered._get_package_dirs% **((_r1'1r2c,[UR5$)zCProxy to ``package_dir`` that may trigger auto-discovery when used.)LazyMappingProxyrr s r/r$EnsurePackagesDiscovered.package_dirs  5 566r2)rrN)rrrQrR)rQr)rztype[BaseException] | NonerzBaseException | NonerzTracebackType | None)rQzMapping[str, str]) rSrTrUrVrWr0r r rrpropertyrrXrOr2r/rrxsP0 3,3(3( 32 77r2rcJ\rSrSrSrS SjrS SjrS SjrS SjrSSjr Sr g )ria]Mapping proxy that delays resolving the target object, until really needed. >>> def obtain_mapping(): ... print("Running expensive function!") ... return {"key": "value", "other key": "other value"} >>> mapping = LazyMappingProxy(obtain_mapping) >>> mapping["key"] Running expensive function! 'value' >>> mapping["other key"] 'other value' cXlSUlgr"_obtainr)r+obtain_mapping_values r/r0LazyMappingProxy.__init__s+ 15 r2c^URcUR5UlUR$r")rr!r s r/_targetLazyMappingProxy._targets# ;; ,,.DK{{r2c(UR5U$r")r%)r+keys r/ __getitem__LazyMappingProxy.__getitem__s||~c""r2c4[UR55$r")rr%r s r/__len__LazyMappingProxy.__len__s4<<>""r2c4[UR55$r")iterr%r s r/rLazyMappingProxy.__iter__sDLLN##r2r N)r"z Callable[[], Mapping[_K, _V_co]]rQrR)rQzMapping[_K, _V_co])r(rrQr)rQint)rQz Iterator[_K]) rSrTrUrVrWr0r%r)r,rrXrOr2r/rrs  6 ##$r2rr")rtz Iterable[str]rkStrPath | NonerQ list[str])rzStrPath | Iterable[StrPath]rkr2rQrP)rzIterable[StrPath]rQzIterator[StrPath])rzbytes | StrPathrQrP)rrrkrP)NN)rrPrMapping[str, str] | Nonerkr2rQr)rrPrr2rQr )r-r rrPrQr )rrPrr4rkrrQz str | None)rrPrr4rkr2rQr)rzdict[str, str]rr4rkr2rQzdict[str, Callable])rzdict[str, str] | Nonerkr2rQr3)rrrfrrQrP)r5z$Callable | Iterable[str | int] | strrQrP)rrrQr)rz list | dictrkr2rQzlist[tuple[str, list[str]]])z entry-points)rrPrrPrQzdict[str, dict[str, str]])BrW __future__rr#rrer%rcollections.abcrrr configparserrglobrimportlib.machineryr r itertoolsr r typesr rtypingrrrr_pathrrr discoveryrwarningsrdistutils.errorsrtyping_extensionsrsetuptools.distrrrrrxrrrrrrrrrrrrrrrrrrrOr2r/rCs8(#   77%8+884)(1&, T]4(PP89='5DHL*6D(E -1##*#*)#*#* #*LDD#;DGNDD2-1# ' ') ' ' '$-1#S S)SS S.2# 4,4 4  4n" 9='5 $#1 $(7(7V$wr5y)$r2