python (3.11.7)
*e? ( d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl
m Z ddl m
Z
ddlmZ ddlmZmZmZmZmZmZmZmZmZmZmZm Z ddlm Z dd l m Z dd
l m!Z! d d l"m#Z$ erdd
l%m&Z& ddl'm(Z( ddl)m*Z* ej+ Z,ee-ej. f Z/ ed Z0 edd Z1 G d d Z2 d@dee- dee/ dee- fdZ3d@dee-e4ee/ f de-fdZ5dee/ 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- fd/Z?d0e/d1e/de-fd2Z@d3eeeee-eAf e-f de-fd4ZBd5eCdeCfd6ZD d@d7eeEeCf dee/ deee-ee- f fd8ZFdBd:e-dee-eCf fd;ZG G d< d= ZH G d> d?ee0e1f ZIdS )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) Distribution)ConfigDiscovery)DistributionMetadata_K_VT) covariantc d e Zd ZdZdedefdZdeee j
e j
f fdZ d Z dS ) StaticModulez>Proxy to a module object that avoids executing arbitrary code.namespecc t j t j |j }t
| t | ` d S N)
astparsepathlibr origin
read_bytesvarsupdatelocalsself)r, r r! modules Z/BuggyBox/python/3.11.7/bootstrap/lib/python3.11/site-packages/setuptools/config/expand.py__init__zStaticModule.__init__B sP 7< 44??AABB T
&((### III returnc # K | j j D ]gt t j rfdj D E d {V 6t t j rj rj j fV hd S )Nc 3 * K | ]
}|j fV d S r# value).0target statements r. <genexpr>z1StaticModule._find_assignments.<locals>.<genexpr>J s* VV&VY_ 5VVVVVVr0 ) r- body
isinstancer$ Assigntargets AnnAssignr5 r7 )r, r8 s @r. _find_assignmentsz StaticModule._find_assignmentsG s ) : :I)SZ00
:VVVVIDUVVVVVVVVVVVIs}55
:)/
: ' 9999 : :r0 c t fd| 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 | ]@\ }}t |t j r!|j k *t j | V Ad S r# )r; r$ Nameid literal_eval)r6 r7 r5 attrs r. r9 z+StaticModule.__getattr__.<locals>.<genexpr>Q sa !FE fch// 5;I4E4E ''4E4E4E4E r0 z has no attribute N)nextr? ExceptionAttributeErrorr )r, rE es ` r. __getattr__zStaticModule.__getattr__N s P %)%;%;%=%=
P P P DI!G!G!G!GHHa O Ps ,0
AAAN)
__name__
__module__ __qualname____doc__strr r/ r r r$ ASTr? rJ r0 r. r r ? s~ HHS
:8E#'372B,C#D : : : : P P P P Pr0 r patternsroot_dirr1 c
h d}g }pt j | D ]t fd|D r{t j t j }| t fdt |d D t j
t j d }| | |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 V d S r# rQ )r6 charr5 s r. r9 z glob_relative.<locals>.<genexpr>j s' 99tu}999999r0 c 3 K | ]B}t j | t j d V CdS )/N)ospathrelpathreplacesepr6 r` rS s r. r9 z glob_relative.<locals>.<genexpr>m sY *> *> h//77DD*> *> *> *> *> *>r0 T) recursiver^ )
r_ getcwdanyr` abspathjoinextendsortedr ra rb rc append)rR rS glob_charactersexpanded_values glob_pathr` r5 s ` @r.
glob_relativerp Z s! 544OO&29;;H
)
) 9999 999 9 9
) Xu(E(EFFI " "6 *> *> *> *> !)t < < <*> *> *> $> $>
?
?
?
? 7??5(33;;BFCHHD " "4 ( ( ( ( r0 filepathsc ddl m} t j pt j fd || D }d 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 X K | ]$}t j | V %d S r# )r_ r` ri rd s r. r9 z read_files.<locals>.<genexpr> s3 VV4"',,x..VVVVVVr0
c 3 V K | ]#}t | t | V $d S r# )
_assert_local
_read_filerd s r. r9 z read_files.<locals>.<genexpr> sO x ( (4 r0 ) setuptools.extern.more_itertoolsrs r_ r` rh rf ri _filter_existing_files)rq rS rs
_filepathss ` r.
read_filesr| y s A@@@@@wx 629;;77HVVVV??9;U;UVVVJ 99 *:66 r0 c # K | D ]>}t j | r|V &t j d|d ?d S )NzFile z cannot be found)r_ r` isfilewarningswarn)rq r` s r. rz rz s_ < <
7>>$ <JJJJ M:$::: ; ; ; ; < <r0 filepathc t j | d 5 }| cd d d S # 1 swxY w Y d S )Nzutf-8)encoding)ioopenread)r fs r. rx rx s G , , , vvxx s 8<<c t t j | t t j | j vrd| d|d}t | dS )NzCannot access z (or anything outside )T)r r_ r` rh parentsr )r rS msgs r. rw rw sg BGOOH % %&&d27??83L3L.M.M.UUUNxNNNNN"3''' 4r0 attr_desc package_dirc |pt j }| d }| }d | }|pd}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
.r/ ) r_ rf stripsplitpopri _find_module
_find_specgetattrr rG
_load_spec)
r r rS
attrs_path attr_name module_name _parent_pathr` r! r- s
r. read_attrr s , &29;;H ""((--J I((:&&K +K&2; X&V&V#L$ k4 ( (D*|K66 BBB * * *D+..vy)))))*s B. .*CCr module_pathc t j | | }|p t j | }|t | |S r# ) importlibutilspec_from_file_location find_specModuleNotFoundError)r r r! s r. r r sK > 1 1+{ K KD 89>++K88D |!+... Kr0 r! c t | d| }|t j v rt j | S t j | }|t j |< | j | |S )NrK )r sysmodulesr r module_from_specloader exec_module)r! r r r- s r. r r si 4[ 1 1D s{{4
^
,
,T
2
2F CKKF### Mr0 c |}| d }|r|d |v r||d }| dd }t | dk r/t j ||d }|d }n|}d |g|dd } n*d|v r&t j ||d }t j j |g| d R }t
| dt 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 X K | ]%}t j | !|V &d S r# )r_ r` r~ )r6 xs r. r9 z _find_module.<locals>.<genexpr> s5 CCa 1B1BCCCCCCCr0 ) r rsplitlenr_ r` ri r r rF ) r r rS parent_path module_parts custom_pathparts
parent_module
path_start
candidatesr s r. r r so K $$S))L
B ?k ) )%l1o6K &&sA..E5zzA~~ gll8U1X > > %a
+
((M#EL4D#EFFKK
;
',,xR AAK kCK,=,=c,B,BCCCJ RW\\*m D DE
J CC:CCCTJJK [ 00r0 qualified_class_namec
|pt j }| d }| |dz d }| d| }t ||| \ }}}t t || | } t
| | S )z@Given a qualified class name, return the associated class objectr r N)r_ rf rfindr r r r )
r r rS idx
class_namepkg_namer r` r r- s
r.
resolve_classr s &29;;H
$
$S
)
)C%cAgii0J#DSD)H&28[(&S&S#L$
;55{
C
CF 6: & &&r0 valuesc H fd| D S )zGiven a dictionary mapping command names to strings for qualified class
names, apply :func:`resolve_class` to the dict values.
c : i | ]\ }}|t | S rQ )r )r6 kvr rS s r.
<dictcomp>z cmdclass.<locals>.<dictcomp> s+ R R R41aA}Q X66 R R Rr0 )items)r r rS s ``r. cmdclassr s, S R R R R6<<>> R R RRr0 )
namespacesfill_package_dirrS r c
ddl m} ddlm}m} | rddl m} nddl m} |p t j }| ddg }g } |i n|}t | ||
t
d k r9t
fd
d|fD r |
d
d
D ]}
t ||
} |j | fi |} | | | rX| d |
k s?t j | | s | || |
| 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_everseenrs )PEP420PackageFinder)
PackageFinderwherer Nr c 3 F K | ]}t d | V dS )r N)
_same_path)r6 r searchs r. r9 z find_packages.<locals>.<genexpr>= s4 V VJvay!$<$< < V V V V V Vr0 r )setuptools.discoveryr ry r rs r r r_ curdirr listr all
setdefault
_nest_pathfindrj getr` samefiler* )r r rS kwargsr r rs r r packagesr` package_pathpkgsr s @r.
find_packagesr s 0 ;:::::QQQQQQQQ 7MMMMMMM666666$29H JJw & &E H - 5rr;K
////%"8"899
:
:F
6{{aC V V V VsHo V V V V V##Bq 222 G G!(D11 !}!,99&99 G $ $ , ,w h77
-
# #$9$9$$E$E F F F Or0 parentr` c |dv r| n t j | | }t j | S )N> r r )r_ r` ri normpath)r r` s r. r r M s; Y&&66BGLL,F,FD
7 D ! !!r0 r5 c B t | r
| } t t t t t
f | } t
| t s>t | d r)d t t | } nd| z } | S )z`When getting the version directly from an attribute,
it should be normalised to string.
__iter__r z%s)
callabler r
r rO intr; hasattrri mapr4 s r. versionr R s %S/*E 2 2E eS ! ! ! 5* % % !HHSe__--EE5LE Lr0 package_datac > d| v r| d | d< | S )NrU r )r )r s r. canonic_package_datar d s+
l'++C00 R r0
data_filesc r t | t r| S fd| D S )zFor compatibility with ``setup.py``, ``data_files`` should be a list
of pairs instead of a dict.
This function also expands glob patterns.
c : g | ]\ }}|t | fS rQ )rp )r6 destrR rS s r.
<listcomp>z&canonic_data_files.<locals>.<listcomp>u s< D(
}Xx001 r0 )r; r r )r rS s `r. canonic_data_filesr j sT *d## ( . . 0 0 r0 entry-pointstextc t dd }t |_ | | | d | D }| |j d |S )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
delimitersc X i | ]'\ }}|t | (S rQ )dictr )r6 r r s r. r z entry_points.<locals>.<dictcomp> s,
<
<
<TQaaggii
<
<
<r0 )r rO optionxform read_stringr r r )r text_sourceparsergroupss r. entry_pointsr { sk $6
B
B
BF F
t[)))
<
<V\\^^
<
<
<F
JJv%t,,, Mr0 c t e Zd ZdZd dZd Zd Zd Zdee e f fd Z
e dee e f fd
Z d S )
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.
distributionr c " || _ d| _ d S )NF)_dist_called)r, r s r. r/ z!EnsurePackagesDiscovered.__init__ s !
r0 c \ | j s$d| _ | j d dS dS )zBTrigger the automatic package discovery, if it is still necessary.TF)r N)r r set_defaultsr, s r. __call__z!EnsurePackagesDiscovered.__call__ s< | 0 DL J # # # / / / / / 0 0r0 c | S r# rQ r s r. __enter__z"EnsurePackagesDiscovered.__enter__ s r0 c T | j r | j j d S d S r# )r r r analyse_name)r, _exc_type
_exc_value
_tracebacks r. __exit__z!EnsurePackagesDiscovered.__exit__ s3 < 3 J # 0 0 2 2 2 2 2 3 3r0 r1 c : | | j j }|i n|S r# )r r )r, pkg_dirs r. _get_package_dirz)EnsurePackagesDiscovered._get_package_dir s% *( _rr'1r0 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 5666r0 N)r r )
rK rL rM rN r/ r r r r
rO r propertyr rQ r0 r. r r s 0 0 0 3 3 32'#s("3 2 2 2 2
7WS#X . 7 7 7 X7 7 7r0 r c e Zd ZdZdeg eeef f fdZdeeef fdZ dedefdZ
de fdZ de
e fd Zd
S ) 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 | _ d S r# )_obtain_value)r, r s r. r/ zLazyMappingProxy.__init__ s + 15 r0 r1 c P | j | | _ | j S r# )r r r s r. _targetzLazyMappingProxy._target s! ; ,,..DK{r0 keyc 6 | | S r# )r )r, r s r. __getitem__z LazyMappingProxy.__getitem__ s ||~~c""r0 c D t | S r# )r r r s r. __len__zLazyMappingProxy.__len__ s 4<<>>"""r0 c D t | S r# )iterr r s r. r zLazyMappingProxy.__iter__ s DLLNN###r0 N)rK rL rM rN r r
r r r/ r r! r r# r r rQ r0 r. r r s 6Xb'"b&/6I-J 6 6 6 6R
#r #b # # # ## # # # #$(2, $ $ $ $ $ $r0 r r# )NN)r )JrN r$ r 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 setuptools.distr r r distutils.distr
from_iterable
chain_iterrO PathLike_Pathr r r rp bytesr| rz rx rw r r r r r r r r r r r r r r r r r rQ r0 r. <module>r5 s &
% % % % % % * * * * * *
1 1 1 1 1 1 + + + + + + 4,,,,,,444444333333
c2; WT]] WTT"""P P P P P P P P8 :> sm '/ #Y > %UHUO ;< PS $<huo <(5/ < < < <ue|,
E S 04 $#* #*#*'#s(+,#* uo#* #* #* #*LC huo * Z c j 1 1#+GCH,=#> 1JO 1
5(3- $% 1 1 1 1H 04 $
'
'
''#s(+,
' uo
'
'
'
'
'$ 04 $S S cNS'#s(+,S uoS
#x- S S S S 15 $ 3 3 3 tCH~.3 uo 3
#Y
3 3 3 3l"u "E "c " " " "
58E#s(O#<cAB s $t @D dDj!-5e_ %T#Y
" s 4T ? #7 #7 #7 #7 #7 #7 #7 #7L $ $ $ $ $wr2v $ $ $ $ $r0 
Browse
Usage
Versions