wg>dZddlmZddlZddlZddlZddlZddlZddlm Z m Z m Z ddl m Z ddlmZddlmZmZddlmZdd lmZdd lmZmZdd lmZmZmZmZd d lmZm Z!d dl"m#Z#d dl$m%Z%ddl&m'Z'er ddl(m)Z)ddl*m+Z+edZ,eddZ-GddZ. d/ d0dZ/ d/ d1dZ0d2dZ1d3dZ2d4dZ3 d5 d6dZ4d7dZ5d8d Z6 d9d!Z7 d5 d:d"Z8 d5 d;d#Z9dddd$ dd'Z dA dBd*Z?Gd+d,Z@Gd-d.e e,e-fZAy)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) covariantc(eZdZdZddZddZddZy) StaticModulez>Proxy to a module object that avoids executing arbitrary code.ctjtj|jj }t |jt|` yN) astparsepathlibr origin read_bytesvarsupdatelocalsself)r*namespecmodules ]/home/mcse/projects/flask/flask-venv/lib/python3.12/site-packages/setuptools/config/expand.py__init__zStaticModule.__init__7s?7<< 4??AB T &(# Ic#<K|jjD]|ttjrfdj DEd{;ttj sVjscjjf~y7Jw)Nc3:K|]}|jfywr!)value).0target statements r. z1StaticModule._find_assignments..?sV&VY__5Vs) r-body isinstancer"Assigntargets AnnAssignr3r5)r*r6s @r._find_assignmentszStaticModule._find_assignments<sn)) :I)SZZ0VIDUDUVVVIs}}5)// ''99  :VsA BBB0 B=Bc tfd|jDS#t$r }t|jd|d}~wwxYw)zHAttempt to load an attribute "statically", via :func:`ast.literal_eval`.c3K|]E\}}t|tjr&|jk(rtj|Gywr!)r9r"Nameid literal_eval)r4r5r3attrs r.r7z+StaticModule.__getattr__..FsA!FEfchh/FII4E  'sA Az has no attribute N)nextr= ExceptionAttributeErrorr+)r*rCes ` r. __getattr__zStaticModule.__getattr__Cs] P%)%;%;%=   P DII;.@!GHa O Ps!% AA  AN)r+strr,r returnNone)rJz!Iterator[tuple[ast.AST, ast.AST]])rCrI)__name__ __module__ __qualname____doc__r/r=rHr0r.rr4sH : Pr0rc hd}g}xstj|D]tfd|Drltjj tjj }|j tfdt|dDtjjjtjd}|j||S)aExpand 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&K|]}|v ywr!rP)r4charr3s r.r7z glob_relative..^s9tu}9sc3K|]B}tjj|jtjdDyw)/N)ospathrelpathreplacesepr4r]root_dirs r.r7z glob_relative..bs9GGOOD(3;;BFFCHsAA T) recursiver[) r\getcwdanyr]abspathjoinextendsortedrr^r_r`append)patternsrbglob_charactersexpanded_values glob_pathr]r3s ` @r. glob_relativeroOs5OO&299;H) 99 9 Xu(EFI  " " %i4 @ 77??5(3;;BFFCHD  " "4 ()" r0cddlm}tjj xstj fd||D}dj fdt|DS)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_iterablec3^K|]$}tjj|&ywr!r\r]rgras r.r7zread_files..|s V4"'',,x.Vs*- c3LK|]}t|r t|ywr!) _assert_local _read_fileras r.r7zread_files..}s(  x ( 4s!$)more_itertoolsrqr\r]rfrdrg_filter_existing_files) filepathsrbrq _filepathss ` r. read_filesr|psW/wwx6299;7HV?9;UVJ 99*:6 r0c#K|D]?}tjj|r|'tjd|dAyw)NzFile z cannot be found)r\r]isfileremit)rzr]s r.ryrysDE 77>>$ J  " "U4(2B#C D EsAAcht|d5}|jcdddS#1swYyxYw)Nzutf-8)encoding)openread)filepathfs r.rwrws, h )Qvvxs(1cttjj|ttjj|jvrd|d|d}t |y)NzCannot access z (or anything outside )T)r r\r]rfparentsr)rrbmsgs r.rvrvsW BGGOOH %&d277??83L.M.U.UUxl*@ AN"3'' r0cl|xstj}|jjd}|j }dj |}|xsd}t |||}t||} tt|||S#t$rt||}t||cYSwxYw)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 .r/) r\rdstripsplitpoprg _find_module _find_specgetattrrrE _load_spec) attr_desc package_dirrb attrs_path attr_name module_namer]r,r-s r. read_attrrs,&299;H"((-J I((:&K+K  [( ;D k4 (D*|K6 BB *D+.vy))*s9B!B32B3ctjj||}|xstjj|}| t ||Sr!) importlibutilspec_from_file_location find_specModuleNotFoundError)r module_pathr,s r.rrsF >> 1 1+{ KD  89>>++K8D |!+.. Kr0c t|d|}|tjvrtj|Stjj |}|tj|<|j J|j j||S)NrL)rsysmodulesrrmodule_from_specloader exec_module)r,rr+r-s r.rrst 4[ 1D s{{{{4  ^^ , ,T 2FCKK ;; "" "KKF# Mr0ct||xsi|tjfdtD}t d|DdS)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' c3pK|]-}|tjjd|f/yw)r/Nrs)r4ext path_starts r.r7z_find_module..s=%  <u rww||J(3%8HIJ%s36c3`K|]&}tjj|s#|(ywr!)r\r]r~)r4xs r.r7z_find_module..s%J  R41aA}Q X6 6 RR Rs0) namespacesfill_package_dirrbc P ddlm}m}ddlm}|sddlm}nddlm}|xstj}|jddg}g} |in|}t||| t dk(r+t fd d|fDr|jd d D]} t|| } |j| fi|} | j!| | s6|j#d | k(rKtj$j'| |rl|j)|| | | S) 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)rqunique_everseen)construct_package_dir) PackageFinder)PEP420PackageFinderwhererrc3>K|]}td| yw)rN) _same_path)r4rsearchs r.r7z find_packages...sVJvay!$< <Vs)rxrqrsetuptools.discoveryrrrr\curdirrlistlenall setdefault _nest_pathfindrhgetr]samefiler()rrrbkwargsrqrrrrpackagesr] package_pathpkgsrs @r. find_packagesrs0@: 6M$299H JJw &EH-5r;K //%"89 :F 6{aCVsHoVV##Bq 2G!(D1 !}!!,9&9    $ ,0@0@x0X  # #$9$$E FG Or0c|dvr|ntjj||}tjj|S)N>rr)r\r]rgnormpath)parentr]s r.rr=s4Y&6BGGLL,FD 77  D !!r0ct|r|n|}t|tr|St|drdj t t|Sd|zS)z`When getting the version directly from an attribute, it should be normalised to string. __iter__rz%s)callabler9rIhasattrrgmap)r3_values r.versionrBsL!UWUF&# vz"xxC()) &=r0c6d|vr|jd|d<|S)NrRr)r) package_datas r.canonic_package_datarOs% l'++C0 R r0c t|tr|S|jDcgc]\}}|t||fc}}Scc}}w)zFor compatibility with ``setup.py``, ``data_files`` should be a list of pairs instead of a dict. This function also expands glob patterns. )r9rrro) data_filesrbdestrks r.canonic_data_filesrUsO*d#)..0  D( }Xx01  sAc tdd}t|_|j|||j Dcic]\}}|t |j !}}}|j |jd|Scc}}w)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)rrI optionxform read_stringrdictrr)text text_sourceparserrrgroupss r. entry_pointsrfsr$6 BFF t[)-3\\^ >> 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' c ||_d|_yr!)_obtainr)r*obtain_mapping_values r.r/zLazyMappingProxy.__init__s+ 15 r0c\|j|j|_|jSr!)rrrs r._targetzLazyMappingProxy._targets# ;; ,,.DK{{r0c(|j|Sr!)r)r*keys r. __getitem__zLazyMappingProxy.__getitem__s||~c""r0c4t|jSr!)rrrs r.__len__zLazyMappingProxy.__len__s4<<>""r0c4t|jSr!)iterrrs r.rzLazyMappingProxy.__iter__sDLLN##r0N)rz Callable[[], Mapping[_K, _V_co]]rJrK)rJzMapping[_K, _V_co])rrrJr)rJint)rJz Iterator[_K]) rLrMrNrOr/rrrrrPr0r.r r s  6 ##$r0r r!)rkz Iterable[str]rbStrPath | NonerJ list[str])rzzStrPath | Iterable[StrPath]rbrrJrI)rzzIterable[StrPath]rJzIterator[StrPath])rzbytes | StrPathrJrI)rrrbrI)NN)rrIrMapping[str, str] | NonerbrrJr)rrIrrrJr )r,r rrIrJr )rrIrrrbrrJz str | None)rrIrrrbrrJr)rzdict[str, str]rrrbrrJzdict[str, Callable])rzdict[str, str] | NonerbrrJr)rrr]rrJrI)r3z$Callable | Iterable[str | int] | strrJrI)rrrJr)rz list | dictrbrrJzlist[tuple[str, list[str]]])z entry-points)rrIrrIrJzdict[str, dict[str, str]])BrO __future__rr"rr\r$rcollections.abcrrr configparserrglobrimportlib.machineryr r itertoolsr r typesr rtypingrrrr_pathrrr discoveryrwarningsrdistutils.errorsrtyping_extensionsrsetuptools.distrrrrror|ryrwrvrrrrrrrrrrrrrr rPr0r.r+s8(#   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)$r0