_iH , d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
m Z ddl m
Z
mZmZmZmZ ddlZddlZddlmZ ddlmZ ddlmZ dd l mZ dd
lm Z g d Z ej< d d
j? Z de jC dd v Z" G d de# Z$ G d dejJ jL Z&ejN d Z(d Z)d Z*d Z+ejN d Z,ee
e-ee-ee- df f Z. G d d Z/ G d d e/ Z0 G d d e0 Z1 e0 Z2e2jf Z3e2jh Z4e2jj Z5e2jl Z6e2jn Z7e"s$e2jp Z8e2jr Z9e2jt Z: e1 Z;y) a- A PEP 517 interface to setuptools
Previously, when a user or a command line tool (let's call it a "frontend")
needed to make a request of setuptools to take a certain action, for
example, generating a list of installation requirements, the frontend would
would call "setup.py egg_info" or "setup.py bdist_wheel" on the command line.
PEP 517 defines a different method of interfacing with setuptools. Rather
than calling "setup.py" directly, the frontend should:
1. Set the current directory to the directory with a setup.py file
2. Import this module into a safe python interpreter (one in which
setuptools can potentially set global variables or crash hard).
3. Call one of the functions defined in PEP 517.
What each function does is defined in PEP 517. However, here is a "casual"
definition of the functions (this definition should not be relied on for
bug reports or API stability):
- `build_wheel`: build a wheel in the folder and return the basename
- `get_requires_for_build_wheel`: get the `setup_requires` to build
- `prepare_metadata_for_build_wheel`: get the `install_requires`
- `build_sdist`: build an sdist in the folder and return the basename
- `get_requires_for_build_sdist`: get the `setup_requires` to build
Again, this is not a formal definition! Just a "taste" of the module.
N)Path)DictIteratorListOptionalUnion )errors) same_path)
parse_strings) SetuptoolsDeprecationWarning) strtobool)
get_requires_for_build_sdist get_requires_for_build_wheel prepare_metadata_for_build_wheel build_wheel build_sdist get_requires_for_build_editable#prepare_metadata_for_build_editablebuild_editable
__legacy__SetupRequirementsErrorSETUPTOOLS_ENABLE_FEATURES zlegacy-editable_-c e Zd Zd Zy)r c || _ y N)
specifiers)selfr s /builddir/build/BUILDROOT/alt-python312-setuptools-69.0.2-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/setuptools/build_meta.py__init__z SetupRequirementsError.__init__D s $ N)__name__
__module__ __qualname__r# r$ r" r r C s %r$ r c @ e Zd Zd Zeej d Zy) Distributionc @ t t | }t | r )listr r )r! r specifier_lists r" fetch_build_eggsz Distribution.fetch_build_eggsI s mJ 78$^44r$ c # K t j j }| t j _ d |t j _ y# |t j _ w xY ww)zw
Replace
distutils.dist.Distribution with this class
for the duration of this context.
N) distutilscorer* )clsorigs r" patchzDistribution.patchN sC ~~**&) # / *.INN '$INN 's 0A'A
A'
A$$A'N)r% r& r' r. classmethod
contextlibcontextmanagerr4 r( r$ r" r* r* H s) 5
/ /r$ r* c # K t j } d t _ d | t _ y# | t _ w xY ww)a
Temporarily disable installing setup_requires
Under PEP 517, the backend reports build dependencies to the frontend,
and the frontend is responsible for ensuring they're installed.
So setuptools (acting as a backend) should not try to install them.
c y r r( )attrss r" z+no_install_setup_requires..g s tr$ N)
setuptools_install_setup_requires)r3 s r" no_install_setup_requiresr> ^ s3 - -D);J&2
-1
*T
*s A 0 A
=A c t j | D cg c]B }t j j t j j | | sA|D c}S c c}w r )oslistdirpathisdirjoin)a_dirnames r" _get_immediate_subdirectoriesrG n sL E* *bggmmBGGLLPTz'_file_with_extension..u s J0aAJJy4I0s !!z[No distribution was found. Ensure that `setup.py` is not empty and that it calls `setup()`.)r@ rA
ValueError) directoryrM matchingfiles ` r" _file_with_extensionrS t sL J2::i0JH
K
8
s ' <c t j j | st j d S t t dt | S )Nz%from setuptools import setup; setup()open)r@ rB existsioStringIOgetattrtokenizerU setup_scripts r" _open_setup_scriptr] s8
77>>, '{{CDD *78VT *< 88r$ c # K t j 5 t j dd d d d d y # 1 sw Y y xY ww)Nignorez setup.py install is deprecated)warningscatch_warningsfilterwarningsr( r$ r" suppress_known_deprecationrc s1 " *JK
# " "s A; AA Ac e Zd ZdZdededee fdZdedee fdZ dedee fdZ
dedee fdZ dedee fd Z y
) _ConfigSettingsTranslatorzTranslate ``config_settings`` into distutils-style command arguments.
Only a limited number of options is currently supported.
keyconfig_settingsreturnc |xs i }|j | xs g }t |t rt j | S |S )aA
Get the value of a specific key in ``config_settings`` as a list of strings.
>>> fn = _ConfigSettingsTranslator()._get_config
>>> fn("--global-option", None)
[]
>>> fn("--global-option", {})
[]
>>> fn("--global-option", {'--global-option': 'foo'})
['foo']
>>> fn("--global-option", {'--global-option': ['foo']})
['foo']
>>> fn("--global-option", {'--global-option': 'foo'})
['foo']
>>> fn("--global-option", {'--global-option': 'foo bar'})
['foo', 'bar']
)get
isinstancestrshlexsplit)r! rf rg cfgoptss r" _get_configz%_ConfigSettingsTranslator._get_config s= $ #wws|!r$.tS$9u{{4 CtCr$ c # K |xs i }h d}d|v sd|v rIt |j d xs |j d xs d }|j |v rdnd d|v sd|v rIt |j d xs |j d xs d }|j |v rdnd | j d | E d
{ y
7 w) a
Let the user specify ``verbose`` or ``quiet`` + escape hatch via
``--global-option``.
Note: ``-v``, ``-vv``, ``-vvv`` have similar effects in setuptools,
so we just have to cover the basic scenario ``-v``.
>>> fn = _ConfigSettingsTranslator()._global_args
>>> list(fn(None))
[]
>>> list(fn({"verbose": "False"}))
['-q']
>>> list(fn({"verbose": "1"}))
['-v']
>>> list(fn({"--verbose": None}))
['-v']
>>> list(fn({"verbose": "true", "--global-option": "-q --no-user-cfg"}))
['-v', '-q', '--no-user-cfg']
>>> list(fn({"--quiet": None}))
['-q']
> 0noofffalseverbosez --verbose1z-qz-vquietz--quietz--global-optionN)rl rj lowerrq )r! rg ro falseylevels r" _global_argsz&_ConfigSettingsTranslator._global_args s * #, {c 1 *Icggk.BIcJE ;;=F24 = c>Y# -(ECGGI,>E#FE ;;=F24 =##$5GGGs CC C
C c # K |xs i }d|v r#t t |d xs d }|rdnd d|v rdt |d gE d{ yy7 w)a
The ``dist_info`` command accepts ``tag-date`` and ``tag-build``.
.. warning::
We cannot use this yet as it requires the ``sdist`` and ``bdist_wheel``
commands run in ``build_sdist`` and ``build_wheel`` to reuse the egg-info
directory created in ``prepare_metadata_for_build_wheel``.
>>> fn = _ConfigSettingsTranslator()._ConfigSettingsTranslator__dist_info_args
>>> list(fn(None))
[]
>>> list(fn({"tag-date": "False"}))
['--no-date']
>>> list(fn({"tag-date": None}))
['--no-date']
>>> list(fn({"tag-date": "true", "tag-build": ".a"}))
['--tag-date', '--tag-build', '.a']
ztag-daterv z
--tag-datez --no-datez tag-buildz --tag-buildN)r rl )r! rg ro vals r" __dist_info_argsz*_ConfigSettingsTranslator.__dist_info_args sd & # CJ :7 ;>> fn = _ConfigSettingsTranslator()._editable_args
>>> list(fn(None))
[]
>>> list(fn({"editable-mode": "strict"}))
['--mode', 'strict']
z
editable-mode
editable_modeNz--mode)rj rl )r! rg ro modes r" _editable_argsz(_ConfigSettingsTranslator._editable_args sF #ww'C377?+C c$i(((s >A AAc # D K | j d| E d{ y7 w)av
Users may expect to pass arbitrary lists of arguments to a command
via "--global-option" (example provided in PEP 517 of a "escape hatch").
>>> fn = _ConfigSettingsTranslator()._arbitrary_args
>>> list(fn(None))
[]
>>> list(fn({}))
[]
>>> list(fn({'--build-option': 'foo'}))
['foo']
>>> list(fn({'--build-option': ['foo']}))
['foo']
>>> list(fn({'--build-option': 'foo'}))
['foo']
>>> list(fn({'--build-option': 'foo bar'}))
['foo', 'bar']
>>> list(fn({'--global-option': 'foo'}))
[]
z--build-optionN)rq r! rg s r" _arbitrary_argsz)_ConfigSettingsTranslator._arbitrary_args s * ##$4oFFFs N)
r% r& r' __doc__rl _ConfigSettingsr rq r r} )_ConfigSettingsTranslator__dist_info_argsr r r( r$ r" re re s Ds D_ Dc D, HO H
H@> >HSM >4)o )(3- ) G G8C= Gr$ re c e Zd Zd ZddZddZddZdededefd Zdedede fd
Z
dd Z d Z dd
Z
ddZdee dee fdZes ddZddZ ddZyy)_BuildMetaBackendc * g t j d d | j | dt _ t j 5 | j d d d |S # 1 sw Y |S xY w# t $ r}||j z
}Y d }~|S d }~ww xY w)Nr egg_info)sysargvr} r* r4 run_setupr r )r! rg requirementses r" _get_build_requiresz%_BuildMetaBackend._get_build_requires s
XXbq\
/
) ##% &
&
& ) ALL (L )s5 A/ A"A/ "A,'A/ ,A/ / B8B
Bc f t j j | }d}t | 5 }|j j dd }d d d t
t y # 1 sw Y xY w# t $ r/}|j r t j ddd Y d }~y d }~ww xY w)N__main__z\r\nz\nz6Running `setup.py` directly as CLI tool is deprecated.znPlease avoid using `sys.exit(0)` or similar statements that don't fit in the paradigm of a configuration file.zAhttps://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html)see_url) r@ rB abspathr] readreplaceexeclocals
SystemExitcoder
emit)r! r\ __file__r% rL r r s r" r z_BuildMetaBackend.run_setup- s 77??<0
)Q668##GU3D * vx *
)
vv ( - -HJ+
s# !A,A8 ,A58 B0%B++B0Nc * | j |dg S )Nwheelr r r s r" r z._BuildMetaBackend.get_requires_for_build_wheelD s ''wi'PPr$ c ( | j |g S )Nr r r s r" r z._BuildMetaBackend.get_requires_for_build_sdistG s ''b'IIr$ metadata_directorysuffixrh c | j || }t |j | s t j t | | |j S )z
PEP 517 requires that the .dist-info directory be placed in the
metadata_directory. To comply, we MUST copy the directory to the root.
Returns the basename of the info directory, e.g. `proj-0.0.0.dist-info`.
)_find_info_directoryr parentshutilmoverl rF )r! r r info_dirs r" _bubble_up_info_directoryz+_BuildMetaBackend._bubble_up_info_directoryJ sC ,,-?H *<= KKH
'9 :}} r$ c P t j | D ]m \ }}}|D cg c] }|j | s| }}t | dk7 st | dk7 sEt | dk( s J d| d t ||d c S d| d| }t j | c c}w )Nr r z Multiple z directories foundzNo z directory found in )r@ walkrJ lenr r
InternalError) r! r r r dirsr rL
candidatesmsgs r" r z&_BuildMetaBackend._find_info_directoryW s !ww'9 :OFD!%)@TQZZ-?!TJ@:!#s4yA~:!+Sy@R-SS+FJqM22 ; F8/0B/CD""3'' As
B#B#c g t j d d | j | dd|dt _ t 5 | j d d d | j |d | j |d S # 1 sw Y -xY w)Nr dist_infoz --output-dirz--keep-egg-infoz .egg-infoz
.dist-info)r r r} r> r r r! r rg s r" r z2_BuildMetaBackend.prepare_metadata_for_build_wheelb s
XXbq\
/
'
( NN )
&&'9;G--.@,OO )
(s A??Bc t j j | }t j |d d|d}t j
di |5 }g t j d d | j | |d|t _ t 5 | j d d d t || }t j j || }t j j | rt j | t j t j j || | d d d |S # 1 sw Y xY w# 1 sw Y S xY w)NT)exist_okz.tmp-)prefixdirr z
--dist-dirr( )r@ rB r makedirstempfileTemporaryDirectoryr r r} r> r rS rD rV removerename) r!
setup_commandresult_extensionresult_directoryrg temp_opts tmp_dist_dirresult_basename result_paths r" _build_with_temp_dirz&_BuildMetaBackend._build_with_temp_dirs s+ 77??+;< $t4 &/?@
(
(
59
5 "1 ""?3
CH +, - 3WW__RWW__\%BC
SXX % HHOOAz *
XXa[
" % )4 : : U #CHHQK$CHHQK #CHHQK$CHHQKs 0C+ +(Dr )r% r& r' r r
__classcell__)r s @r" r r s % %r$ r ) rG rS r] rc rl r re r r _BACKENDr r r r r r r r r r( r$ r" r s 8
8 8 2 $ 'RYY'CR H N N P #'A'I'I#s'SS%] %
/:??// /, 2 2 9 4U3S 4+?%@ @AB |G |G~b1 bJ%% / %%R ' D D ' D D #+#L#L "" "" &.&N&N#*2*V*V' ,,N %
&
r$