_i@ . d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z ddl
m Z ddl m
Z
ddlmZmZmZmZmZmZmZmZmZmZmZmZ ddlmZ dd l m Z dd
l m Z d d l m!Z" d d
l#m$Z$ erddl%m&Z& ddl'm(Z( ddl)m*Z* e
jV Z,ee-ej\ f Z/ ed Z0 edd Z1 G d d Z2 d@dee- dee/ dee- fdZ3d@dee-e4ee/ f de-fd Z5dee/ dee/ fd Z6d ee4e/f de-fd Z7d e/de-fd Z8 dAd!e-d"eee-e-f dee/ fd#Z9d$e-d%ee/ de fd&Z:d'e d$e-de fd(Z;d$e-d"eee-e-f de/dee/ee- e-f fd)Z< dAd*e-d"eee-e-f dee/ defd+Z= dAd,ee-e-f d"eee-e-f dee/ dee-ef fd-Z>dddd.d/eee-e-f dee/ dee- fd0Z?d1e/d2e/de-fd3Z@d4eeeee-eAf e-f de-fd5ZBd6eCdeCfd7ZD d@d8eeEeCf dee/ deee-ee- f fd9ZFdBd:e-dee-eCf fd;ZG G d< d= ZH G d> d?ee0e1f ZIy)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 j e Zd ZdZdedefdZdeee j e j f fdZ d Z y) StaticModulez>Proxy to a module object that avoids executing arbitrary code.namespecc t j t j |j j }t
| j t | ` y N)
astparsepathlibr origin
read_bytesvarsupdatelocalsself)r- r! r" modules /builddir/build/BUILDROOT/alt-python312-setuptools-69.0.2-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/setuptools/config/expand.py__init__zStaticModule.__init__A s? 7<< 4??AB T
&(# I returnc # < K | j j D ]| t t j r fdj
D E d { ;t t j sVj scj j f ~ y 7 Jw)Nc 3 : K | ] }|j f y wr$ value).0target statements r/ z1StaticModule._find_assignments..I s VDU&VY__ 5DUs ) r. body
isinstancer% Assigntargets AnnAssignr6 r8 )r- r9 s @r/ _find_assignmentsz StaticModule._find_assignmentsF si ))I)SZZ0VIDUDUVVVIs}}5)// '' 99 *Vs A B B B 0 B = B c t fd| j D S # t $ r }t | j d |d}~ww xY w)zHAttempt to load an attribute "statically", via :func:`ast.literal_eval`.c 3 K | ]E \ }}t |t j r&|j k( rt j | G y wr$ )r< r% Nameid literal_eval)r7 r8 r6 attrs r/ r: z+StaticModule.__getattr__..P sA %=MFE fchh/FII4E '%=s A Az has no attribute N)nextr@ ExceptionAttributeErrorr! )r- rF es ` r/ __getattr__zStaticModule.__getattr__M s] P %)%;%;%=
P DII;.@!GHa O Ps !% AA AN)
__name__
__module__ __qualname____doc__strr r0 r r r% ASTr@ rK r1 r/ r r > sA HS
:8E#''3772B,C#D : Pr1 r patternsroot_dirr2 c
h d}g }xs t j | D ] t fd|D rlt j j t j j }|j
t fdt |d D t j j j t j d }|j | |S )a Expand 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 & K | ] }|v
y wr$ rR )r7 charr6 s r/ r: z glob_relative..h s 9 tu} s c 3 K | ]B }t j j | j t j d D yw)/N)ospathrelpathreplacesepr7 ra rT s r/ r: z glob_relative..l s9 @ GGOOD(3;;BFFCH @s AA T) recursiver_ )
r` getcwdanyra abspathjoinextendsortedr rb rc rd append)rS rT glob_charactersexpanded_values glob_pathra r6 s ` @r/
glob_relativerq Y s 5OO&299;H 9 9 9 Xu(EFI " " %i4 @
77??5(3;;BFFCHD " "4 ( " r1 filepathsc ddl m} t j j xs t j
fd || D }dj
fdt | D S )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 ^ K | ]$ }t j j | & y wr$ )r` ra rj re s r/ r: z read_files.. s# V;U4"'',,x.;Us *-
c 3 L K | ] }t | r
t | y wr$ )
_assert_local
_read_filere s r/ r: z read_files.. s( 6D x ( 46s !$) setuptools.extern.more_itertoolsrt r` ra ri rg rj _filter_existing_files)rr rT rt
_filepathss ` r/
read_filesr} z sX Awwx 6299;7HV?9;UVJ 99 *:6 r1 c # K | D ]? }t j j | r| 't j d|d A y w)NzFile z cannot be found)r` ra isfiler emit)rr ra s r/ r{ r{ s=
77>>$ J " "U4(2B#C D s AAfilepathc h t | d 5 }|j cd d d S # 1 sw Y y xY w)Nzutf-8)encoding)openread)r fs r/ ry ry s#
h )Qvvx
* ) )s (1c t t j j | t t j j | j vrd| d|d}t | y)NzCannot access z (or anything outside )T)r r` ra ri parentsr )r rT msgs r/ rx rx sW BGGOOH %&d277??83L.M.U.UU xl*@ AN"3'' r1 attr_desc package_dirc t |xs t j }| j j d }|j }dj | }|xs d}t
||| \ }}}t || } t t || | S # t $ r t || } t | | cY S w xY w)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
.r0 ) r` rg stripsplitpoprj _find_module
_find_specgetattrr rH
_load_spec)
r r rT
attrs_path attr_name module_name _parent_pathra r" r. s
r/ read_attrr s , &299;H "((-J I((:&K +K&2; X&V#L$ k4 (D*|K6 BB *D+.vy))*s =B !B76B7r module_pathc t j j | | }|xs t j j | }| t | |S r$ ) importlibutilspec_from_file_location find_specModuleNotFoundError)r r r" s r/ r r sF >> 1 1+{ KD 89>>++K8D |!+.. Kr1 r" c t | d| }|t j v rt j | S t j j | }|t j |< | j j | |S )NrL )r sysmodulesr r module_from_specloader exec_module)r" r r! r. s r/ r r sd 4[ 1D s{{{{4
^^
,
,T
2F CKKKKF# Mr1 c b |}| j d }|r|d |v rk||d }|j dd }t | dkD r)t j j ||d }|d }n|}dj |g|dd } n'd|v r#t j j ||d }t j j
|g| j d }t
| dt j j |d ft | d } t d
| D d }
||
| fS ) a0 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 r_ N z.pyz __init__.pyz.*c 3 ` K | ]& }t j j | s#| ( y wr$ )r` ra r )r7 xs r/ r: z _find_module.. s C:a 1B:s $..) r rsplitlenr` ra rj r r rG ) r r rT parent_path module_parts custom_pathparts
parent_module
path_start
candidatesr s r/ r r s0 K $$S)L ?k )%l1o6K &&sA.E5zA~ ggll8U1X > %a
+
((M#EL4D#EFK
;
'',,xR AK kCK,=,=c,BCJ R>41aA}Q X6 6> RR Rs 0)
namespacesfill_package_dirrT r c P
ddl m} ddlm}m} | rddl m} nddl m} |xs t j }|j ddg }g } |i n|}t | ||
t
dk( r+t
fd d|fD r|j d
d
D ] }
t ||
} |j | fi |} | j! | | s6|j# d
|
k( rKt j$ j' | | rl|j) || |
| S ) 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_everseenrt )PEP420PackageFinder)
PackageFinderwherer r c 3 > K | ] }t d | yw)r N)
_same_path)r7 r searchs r/ r: z find_packages..> s VoJvay!$< r r )r` ra rj normpath)r ra s r/ r r M s4 Y&6BGGLL,FD
77 D !!r1 r6 c t | r | } t t t t t
f | } t
| t s2t | d r!dj t t | } | S d| z } | S )z`When getting the version directly from an attribute,
it should be normalised to string.
__iter__r z%s)
callabler r
r rP intr< hasattrrj mapr5 s r/ versionr R sj %S/*E 2E eS ! 5* %HHSe_-E L 5LE Lr1 package_datac 6 d| v r| j d | d< | S )NrV r )r )r s r/ canonic_package_datar d s%
l'++C0 R r1
data_filesc t | t r| S | j D cg c] \ }}|t || f c}}S c c}}w )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 rq )r rT destrS s r/ canonic_data_filesr j sT *d# ) . . 0 0ND(
}Xx01 0 s Atextc t dd }t |_ |j | | |j D ci c] \ }}|t |j ! }}}|j
|j d |S c c}}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)r rP optionxform read_stringr dictr r )r text_sourceparserr r groupss r/ entry_pointsr { ss $6
BF F
t[)-3\\^
<^TQaaggi ^F
<
JJv%%t, M =s $Bc ` e Zd ZdZd
dZd Zd Zd Zdee e f fdZ
e dee e f fd Z y ) EnsurePackagesDiscovereda 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 || _ d| _ y )NF)_dist_called)r- distributions r/ r0 z!EnsurePackagesDiscovered.__init__ s !
r1 c d | j s$d| _ | j j d yy)zBTrigger the automatic package discovery, if it is still necessary.TF)r! N)r r set_defaultsr- s r/ __call__z!EnsurePackagesDiscovered.__call__ s* || DL JJ # # # / r1 c | S r$ rR r s r/ __enter__z"EnsurePackagesDiscovered.__enter__ s r1 c f | j r%| j j j y y r$ )r r r analyse_name)r- _exc_type
_exc_value
_tracebacks r/ __exit__z!EnsurePackagesDiscovered.__exit__ s$ << JJ # # 0 0 2 r1 r2 c H | | j j }|i S |S r$ )r r )r- pkg_dirs r/ _get_package_dirz)EnsurePackagesDiscovered._get_package_dir s% **(( _r1'1r1 c , t | j S )zCProxy to ``package_dir`` that may trigger auto-discovery when used.)LazyMappingProxyr
r s r/ r z$EnsurePackagesDiscovered.package_dir s 5 566r1 N)r r )
rL rM rN rO r0 r r r
r
rP r
propertyr rR r1 r/ r r sT 0 32'#s("3 2
7WS#X . 7 7r1 r c t e Zd ZdZdeg eeef f fdZdeeef fdZ dedefdZ
de fdZ de
e fd Zy
) r 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 || _ d | _ y r$ )_obtain_value)r- r s r/ r0 zLazyMappingProxy.__init__ s + 15 r1 r2 c \ | j | j | _ | j S r$ )r r r s r/ _targetzLazyMappingProxy._target s# ;; ,,.DK{{r1 keyc ( | j | S r$ )r )r- r s r/ __getitem__z LazyMappingProxy.__getitem__ s ||~c""r1 c 4 t | j S r$ )r r r s r/ __len__zLazyMappingProxy.__len__ s 4<<>""r1 c 4 t | j S r$ )iterr r s r/ r zLazyMappingProxy.__iter__ s DLLN##r1 N)rL rM rN rO r r
r r r0 r r r r r r rR r1 r/ r r sh 6Xb'"b&/6I-J 6R
#r #b ## #$(2, $r1 r r$ )NN)z entry-points)JrO r% r r` 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_iterrP PathLike_Pathr r r rq bytesr} r{ ry rx r r r r r r r r r r r r r r r r r rR r1 r/ r/ 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#