a0bi@ d S r SSKrSSKrSSKrSSKrSSKrSSKJr SSKJ r SSK
J r SSK J
r
SSKJrJrJrJrJrJrJrJrJrJrJrJr SSKJr SS K J r SS
K J r S S K J!r" S S
K#J$r$ \( a SSK%J&r& SSK'J(r( SSK)J*r* \
RV r,\\-\R\ 4 r/\" S5 r0\" SSS9r1 " S S5 r2 S@S\\- S\\/ S\\- 4S jjr3S@S\\-\4\\/ 4 S\-4S jjr5S\\/ S\\/ 4S jr6S \\4\/4 S\-4S jr7S \/S\-4S jr8 SAS!\-S"\\\-\-4 S\\/ 4S# jjr9S$\-S%\\/ S\ 4S& jr:S'\ S$\-S\ 4S( jr;S$\-S"\\\-\-4 S\/S\\/\\- \-4 4S) jr< SAS*\-S"\\\-\-4 S\\/ S\4S+ jjr= SAS,\\-\-4 S"\\\-\-4 S\\/ S\\-\4 4S- jjr>SSSS..S/\\\-\-4 S\\/ S\\- 4S0 jjr?S1\/S2\/S\-4S3 jr@S4\\\\\-\A4 \-4 S\-4S5 jrBS6\CS\C4S7 jrD S@S8\\E\C4 S\\/ S\\\-\\- 4 4S9 jjrFSBS:\-S\\-\C4 4S; jjrG " S< S=5 rH " S> S?\\0\14 5 rIg)Cai Utility 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.
N)iglob) ConfigParser)
ModuleSpec)chain)
TYPE_CHECKINGCallableDictIterableIteratorListMappingOptionalTupleTypeVarUnioncast)Path)
ModuleType)DistutilsOptionError ) same_path)SetuptoolsWarning) Distribution)ConfigDiscovery)DistributionMetadata_K_VT) covariantc v \ rS rSrSrS\S\4S jrS\\ \
R \
R 4 4S jr S r
S rg
) StaticModule> z>Proxy to a module object that avoids executing arbitrary code.namespecc [ R " [ R " UR 5 R 5 5 n[
U 5 R [ 5 5 U ? g N)
astparsepathlibr origin
read_bytesvarsupdatelocalsself)r. r" r# modules ڑ/builddir/build/BUILDROOT/alt-python313-setuptools-69.0.2-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/setuptools/config/expand.py__init__StaticModule.__init__A s? 7<< 4??AB T
&(# I returnc # f ^# U R R H m[ T[ R 5 ( a U4S jTR
5 S h vN MB [ T[ R 5 ( d Mc TR ( d Mv TR TR 4v M g NY7f)Nc 3 > ># U H oTR 4v M g 7fr% value).0target statements r0 1StaticModule._find_assignments..I s VDU&Y__ 5DUs ) r/ body
isinstancer& Assigntargets AnnAssignr8 r: )r. r; s @r0 _find_assignments StaticModule._find_assignmentsF sp ))I)SZZ00VIDUDUVVVIs}}55)/// '' 99 *Vs AB1B/#B1=B1 B1c ^ [ U4S jU R 5 5 5 $ ! [ a n[ U R ST 35 UeSnAff = f)zHAttempt to load an attribute "statically", via :func:`ast.literal_eval`.c 3 ># U HP u p[ U[ R 5 ( d M& UR T:X d M8 [ R " U5 v MR g 7fr% )r? r& Nameid literal_eval)r9 r: r8 attrs r0 r< +StaticModule.__getattr__..P sI %=MF fchh/ (4:II4E ( ''%=s %AA Az has no attribute N)nextrC ExceptionAttributeErrorr" )r. rJ es ` r0 __getattr__StaticModule.__getattr__M s] P %)%;%;%=
P DII;.@!GHa O Ps "&
AA A N)__name__
__module__ __qualname____firstlineno____doc__strr r1 r r r& ASTrC rP __static_attributes__rR r3 r0 r r > sA HS
:8E#''3772B,C#D : Pr3 r patternsroot_dirr4 c ^^ 1 Skn/ nT=( d [ R " 5 mU H m[ U4S jU 5 5 ( ak [ R R [ R R TT5 5 nUR
[ U4S j[ USS9 5 5 5 M [ R R TT5 R [ R S5 nUR U5 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
> *?[]{}c 3 , ># U H oT; v M g 7fr% rR )r9 charr8 s r0 r< glob_relative..h s 9 u} s c 3 ># U HC n[ R R UT5 R [ R S 5 v ME g7f)/N)ospathrelpathreplacesepr9 rj r\ s r0 r< rf l s; @ GGOOD(3;;BFFCHH @s A AT) recursiverh )
ri getcwdanyrj abspathjoinextendsortedr rk rl rm append)r[ r\ glob_charactersexpanded_values glob_pathrj r8 s ` @r0
glob_relativerz Y s 5OO&299;H 9 9 9 9 Xu(EFI " " %i4 @
77??5(3;;BFFCHD " "4 ( " r3 filepathsc ^ SSK Jn [ R R T=( d [ R
" 5 5 mU4S jU" U 5 5 nSR
U4S j[ U5 5 5 $ )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_iterablec 3 d ># U H% n[ R R TU5 v M' g 7fr% )ri rj rs rn s r0 r< read_files.. s% V;U4"'',,x..;Us -0
c 3 ` ># U H# n[ UT5 ( d M [ U5 v M% g 7fr% )
_assert_local
_read_filern s r0 r< r s, 6D x (
46s ..) setuptools.extern.more_itertoolsr} ri rj rr rp rs _filter_existing_files)r{ r\ r}
_filepathss ` r0
read_filesr z sX Awwx 6299;7HV?9;UVJ 99 *:6 r3 c # # U HH n[ R R U5 ( a Uv M- [ R " SU< S35 MJ g 7f)NzFile z cannot be found)ri rj isfiler emit)r{ rj s r0 r r s?
77>>$ J " "U4(2B#C D s AAfilepathc l [ U SS9 nUR 5 sS S S 5 $ ! , ( d f g = f)Nzutf-8)encoding)openread)r fs r0 r r s#
h )Qvvx
* ) )s %
3c [ [ R R U5 5 [ [ R R U 5 5 R ; a SU < SU< S3n[ U5 eg)NzCannot access z (or anything outside )T)r ri rj rr parentsr )r r\ msgs r0 r r sW BGGOOH %&d277??83L.M.U.UU xl*@ AN"3'' r3 attr_desc package_dirc U=( d [ R " 5 nU R 5 R S5 nUR 5 nSR U5 nU=( d Sn[
XQU5 u pgn[ XW5 n [ [ XX5 U5 $ ! [ a [ X5 n [ X5 s $ f = f)a Reads 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
.r1 ) ri rp stripsplitpoprs _find_module
_find_specgetattrr rM
_load_spec)
r r r\
attrs_path attr_name module_name _parent_pathrj r# r/ s
r0 read_attrr s , &299;H "((-J I((:&K +K&2;X&V#L k (D*|K6 BB *D.v))*s B B=<B=r module_pathc [ R R X5 nU=( d [ R R U 5 nUc [ U 5 eU$ r% ) importlibutilspec_from_file_location find_specModuleNotFoundError)r r r# s r0 r r sD >> 1 1+ KD 89>>++K8D |!+.. Kr3 r# c [ U SU5 nU[ R ; a [ R U $ [ R R U 5 nU[ R U' U R R U5 U$ )NrS )r sysmodulesr r module_from_specloader exec_module)r# r r" r/ s r0 r r sd 4[ 1D s{{{{4
^^
,
,T
2F CKKKKF# Mr3 c p UnU R S5 nU( a US U; aj XS nUR SS5 n[ U5 S: a( [ R R X&S 5 nUS nOUnSR U/USS Q5 n O(SU; a" [ R R X!S 5 n[ R R
" U/U R S5 Q76 n[
U S3[ R R US5 4[ U S 35 5 n [ S
U 5 S5 n
X:U 4$ ) a Given a module (that could normally be imported by ``module_name``
after the build is complete), find the path to the parent directory where
it is contained and the canonical name that could be used to import it
considering the ``package_dir`` in the build configuration and ``root_dir``
r r rh N z.pyz __init__.pyz.*c 3 r # U H- n[ R R U5 ( d M) Uv M/ g 7fr% )ri rj r )r9 xs r0 r< _find_module.. s! C:a 1B:s (7 7) r rsplitlenri rj rs r r rL ) r r r\ parent_path module_parts custom_pathparts
parent_module
path_start
candidatesr s r0 r r s( K $$S)L ?k )%1o6K &&sA.E5zA~ ggll81X > %a
+
((M#EL4D#EFK
;
'',,xR AK kCK,=,=c,BCJ R>41A}QX6 6> RR Rs 1)
namespacesfill_package_dirr\ r c ^
SSK Jn SSKJnJn U ( a SSK Jn OSSK Jn U=( d [ R nUR SS/5 n/ n Uc 0 OUn[ U" U" U5 5 5 m
[ T
5 S:X a1 [ U
4S jSU4 5 5 ( a UR S
T
S 5 T
H n
[ X*5 n UR " U 40 UD6n U R! U 5 U ( d M; UR# S
5 U
:X a MR [ R$ R' X5 ( a Mx UR) U" X5 5 M U $ ) a Works 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 )construct_package_dir)unique_everseenr} )PEP420PackageFinder)
PackageFinderwherer r c 3 L ># U H n[ TS U5 ( + v M g7f)r N)
_same_path)r9 r searchs r0 r< find_packages..> s" VoJvay!$< < r r )ri rj rs normpath)r rj s r0 r r M s2 Y&6BGGLL,FD
77 D !!r3 r8 c [ U 5 ( a U " 5 n [ [ [ [ [
4 U 5 n [
U [ 5 ( d7 [ U S5 ( a! SR [ [ U 5 5 n U $ SU - n U $ )zXWhen getting the version directly from an attribute,
it should be normalised to string.
__iter__r z%s)
callabler r
r rX intr? hasattrrs mapr7 s r0 versionr R sr %S/*E 2E eS ! ! 5* % %HHSe_-E L 5LE Lr3 package_datac : SU ; a U R S5 U S' U $ )Nr^ r )r )r s r0 canonic_package_datar d s%
l'++C0 R r3
data_filesc [ U [ 5 ( a U $ U R 5 VVs/ s H u p#U[ X15 4PM 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? r r rz )r r\ destr[ s r0 canonic_data_filesr j sS *d## ) . . 0 0ND
}X01 0 s Atextc [ SSS9n[ Ul UR X5 UR 5 VVs0 s H u p4U[ UR 5 5 _M! nnnUR
UR S5 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)r rX optionxform read_stringr dictr r )r text_sourceparserr r groupss r0 entry_pointsr { so $6
BF F
t)-3\\^
<^TQaaggi ^F
<
JJv%%t, M =s &Bc n \ rS rSrSrS S jrS rS rS rS\ \
\
4 4S jr \ S\ \
\
4 4S j5 r
S
rg )
EnsurePackagesDiscoveredi a Some 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.
c Xl SU l g )NF)_dist_called)r. distributions r0 r1 !EnsurePackagesDiscovered.__init__ s !
r3 c h U R ( d! SU l U R R SS9 gg)zBTrigger the automatic package discovery, if it is still necessary.TF)r" N)r r set_defaultsr. s r0 __call__!EnsurePackagesDiscovered.__call__ s* || DL JJ # # # / r3 c U $ r% rR r s r0 __enter__"EnsurePackagesDiscovered.__enter__ s r3 c p U R ( a% U R R R 5 g g r% )r r r
analyse_name)r. _exc_type
_exc_value
_tracebacks r0 __exit__!EnsurePackagesDiscovered.__exit__ s$ << JJ # # 0 0 2 r3 r4 c J U " 5 U R R nUc 0 $ U$ r% )r r )r. pkg_dirs r0 _get_package_dir)EnsurePackagesDiscovered._get_package_dir s% **(( _r1'1r3 c , [ U R 5 $ )zCProxy to ``package_dir`` that may trigger auto-discovery when used.)LazyMappingProxyr r s r0 r $EnsurePackagesDiscovered.package_dir s 5 566r3 )r r N)r
r )rS rT rU rV rW r1 r r r r
rX r propertyr rZ rR r3 r0 r r sT 0 32'#s("3 2
7WS#X . 7 7r3 r c \ rS rSrSrS\/ \\\4 4 4S jr S\\\4 4S jr
S\S\4S jr S\ 4S jr
S\\ 4S
jrS rg )
r i a] 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'
obtain_mapping_valuec Xl S U l g r% _obtain_value)r. r$ s r0 r1 LazyMappingProxy.__init__ s + 15 r3 r4 c ^ U R c U R 5 U l U R $ r% )r( r' r s r0 _targetLazyMappingProxy._target s# ;; ,,.DK{{r3 keyc ( U R 5 U $ r% )r+ )r. r- s r0 __getitem__ LazyMappingProxy.__getitem__ s ||~c""r3 c 4 [ U R 5 5 $ r% )r r+ r s r0 __len__LazyMappingProxy.__len__ s 4<<>""r3 c 4 [ U R 5 5 $ r% )iterr+ r s r0 r LazyMappingProxy.__iter__ s DLLN##r3 r& N)rS rT rU rV rW r r
r r r1 r+ r/ r r2 r r rZ rR r3 r0 r r sh 6Xb'"b&/6I-J 6R
#r #b ## #$(2, $r3 r r% )NN)z entry-points)JrW r& r ri r( r globr configparserr importlib.machineryr itertoolsr typingr r r r
r r r
r r r r r r typesr distutils.errorsr _pathr r warningsr setuptools.distr r r distutils.distr
from_iterable
chain_iterrX PathLike_Pathr r r rz bytesr r r r r r r r r r r r r r r r r r r r r rR r3 r0 rG s &
% *
1 + (,43
c2;; T] TT"P P8 :> sm '/ #Y B%UHUO ;< PS $Ehuo E(5/ Eue|,
E S 04 $#*#*'#s(+,#* uo#*LC huo * Z c j 1 1#+GCH,=#> 1JO 1
5(3- $% 1H 04 $
'
''#s(+,
' uo
'
'$ 04 $S cNS'#s(+,S uoS
#x- S 15 $ 2 tCH~.2 uo 2
#Y
2j"u "E "c "
58E#s(O#