f,dZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z mZmZmZmZddlZddlZddlmZddlmZddlmZdd l mZdd lmZgd Zej<d d j?Z de jCddvZ"Gdde#Z$GddejJjLZ&ejNdZ(dZ)dZ*dZ+ejNdZ,ee e-ee-ee-dffZ. GddZ/Gdde/Z0Gdde0Z1e0Z2e2jfZ3e2jhZ4e2jjZ5e2jlZ6e2jnZ7e"s$e2jpZ8e2jrZ9e2jtZ:e1Z;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_sdistget_requires_for_build_wheel prepare_metadata_for_build_wheel build_wheel build_sdistget_requires_for_build_editable#prepare_metadata_for_build_editablebuild_editable __legacy__SetupRequirementsErrorSETUPTOOLS_ENABLE_FEATURESzlegacy-editable_-ceZdZdZy)rc||_yN) specifiers)selfr s :/usr/lib/python3.12/site-packages/setuptools/build_meta.py__init__zSetupRequirementsError.__init__Ds $N)__name__ __module__ __qualname__r#r$r"rrCs%r$rc@eZdZdZeej dZy) Distributionc@tt|}t|r)listr r)r!r specifier_lists r"fetch_build_eggszDistribution.fetch_build_eggsIsmJ78$^44r$c#Ktjj}|tj_ d|tj_y#|tj_wxYww)zw Replace distutils.dist.Distribution with this class for the duration of this context. N) distutilscorer*)clsorigs r"patchzDistribution.patchNsC~~**&) # / *.INN '$INN 's0A'A A' A$$A'N)r%r&r'r. classmethod contextlibcontextmanagerr4r(r$r"r*r*Hs)5  / /r$r*c#Ktj}dt_ d|t_y#|t_wxYww)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. cyrr()attrss r"z+no_install_setup_requires..gstr$N) setuptools_install_setup_requires)r3s r"no_install_setup_requiresr>^s3  - -D);J&2 -1 *T *sA0 A =Ac tj|Dcgc]B}tjjtjj ||sA|Dc}Scc}wr)oslistdirpathisdirjoin)a_dirnames r"_get_immediate_subdirectoriesrGnsLE* *bggmmBGGLLPTz'_file_with_extension..usJ0aAJJy4I0s!!z[No distribution was found. Ensure that `setup.py` is not empty and that it calls `setup()`.)r@rA ValueError) directoryrMmatchingfiles ` r"_file_with_extensionrStsQJ2::i0JH K  8  s'=ctjj|stjdSt j |S)Nz%from setuptools import setup; setup())r@rBexistsioStringIOtokenizeopen setup_scripts r"_open_setup_scriptr\s1 77>>, '{{BCC == &&r$c#Ktj5tjddddddy#1swYyxYww)Nignorezsetup.py install is deprecated)warningscatch_warningsfilterwarningsr(r$r"suppress_known_deprecationrbs1  "*JK  # " "sA; AAAceZdZdZdededeefdZdedeefdZ dedeefdZ dedeefdZ dedeefd Z y ) _ConfigSettingsTranslatorzTranslate ``config_settings`` into distutils-style command arguments. Only a limited number of options is currently supported. keyconfig_settingsreturnc|xsi}|j|xsg}t|trtj|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!rerfcfgoptss r" _get_configz%_ConfigSettingsTranslator._get_configs=$#wws|!r$.tS$9u{{4 CtCr$c#K|xsi}hd}d|vsd|vrIt|jdxs|jdxsd}|j|vrdndd|vsd|vrIt|jdxs|jdxsd}|j|vrdnd|jd |Ed {y 7w) 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)rkrilowerrp)r!rfrnfalseylevels r" _global_argsz&_ConfigSettingsTranslator._global_argss*#,  {c1 *Icggk.BIcJE ;;=F24 = c>Y#-(ECGGI,>E#FE ;;=F24 =##$5GGGsCC C C c#K|xsi}d|vr#tt|dxsd}|rdndd|vrdt|dgEd{yy7w)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-dateruz --tag-datez --no-datez tag-buildz --tag-buildN)rrk)r!rfrnvals r"__dist_info_argsz*_ConfigSettingsTranslator.__dist_info_argssd&#  CJ :7;>> fn = _ConfigSettingsTranslator()._editable_args >>> list(fn(None)) [] >>> list(fn({"editable-mode": "strict"})) ['--mode', 'strict'] z editable-mode editable_modeNz--mode)rirk)r!rfrnmodes r"_editable_argsz(_ConfigSettingsTranslator._editable_argssF#ww'C377?+C c$i(((s>AAAc#DK|jd|Ed{y7w)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)rpr!rfs r"_arbitrary_argsz)_ConfigSettingsTranslator._arbitrary_argss*##$4oFFFs   N) r%r&r'__doc__rk_ConfigSettingsrrprr|)_ConfigSettingsTranslator__dist_info_argsrrr(r$r"rdrds DsD_DcD,HOH H@>>HSM>4)o)(3-) GG8C=Gr$rdceZdZdZddZddZddZdededefd Zdedede fd Z dd Z dd Z dd Z ddZdeedeefdZes ddZddZ ddZyy)_BuildMetaBackendc*gtjdd|j|dt_ tj 5|j ddd|S#1swY|SxYw#t $r}||jz }Yd}~|Sd}~wwxYw)Nr egg_info)sysargvr|r*r4 run_setuprr )r!rf requirementses r"_get_build_requiresz%_BuildMetaBackend._get_build_requiress XXbq\    /     )##% &  & & ) ALL (L )s5A/A"A/"A,'A/,A// B8B  Bcftjj|}d}t|5}|j j dd}ddd t ty#1swYxYw#t$r/}|jrtjdddYd}~yd}~wwxYw)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@rBabspathr\readreplaceexeclocals SystemExitcoder emit)r!r[__file__r%rLrrs r"rz_BuildMetaBackend.run_setup-s77??<0  )Q668##GU3D*  vx * )  vv ( - -HJ+    s#!A,A8,A58 B0%B++B0Nc*|j|dgS)Nwheelrrrs r"rz._BuildMetaBackend.get_requires_for_build_wheelDs''wi'PPr$c(|j|gS)Nrrrs r"rz._BuildMetaBackend.get_requires_for_build_sdistGs''b'IIr$metadata_directorysuffixrgc|j||}t|j|stjt |||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 parentshutilmoverkrF)r!rrinfo_dirs r"_bubble_up_info_directoryz+_BuildMetaBackend._bubble_up_info_directoryJsC,,-?H*<= KKH '9 :}}r$cPtj|D]m\}}}|Dcgc]}|j|s|}}t|dk7st|dk7sEt|dk(s Jd|dt ||dcSd|d|}t j |cc}w)Nrr z Multiple z directories foundzNo z directory found in )r@walkrJlenrr InternalError) r!rrrdirsrrL candidatesmsgs r"rz&_BuildMetaBackend._find_info_directoryWs!ww'9:OFD!%)@TQZZ-?!TJ@:!#s4yA~:!+Sy@R-SS+FJqM22 ;F8/0B/CD""3''As B#B#cgtjdd|j|dd|dt_t5|j ddd|j |d|j |dS#1swY-xYw)Nr dist_infoz --output-dirz--keep-egg-infoz .egg-infoz .dist-info)rrr|r>rrr!rrfs r"rz2_BuildMetaBackend.prepare_metadata_for_build_wheelbs XXbq\    /          ' ( NN ) &&'9;G--.@,OO ) (s A??Bctjj|}tj|dd|d}t j di|5}gt jdd|j||d||t _t5|jdddt||}tjj||} tjj| rtj| tjtjj||| ddd|S#1swYxYw#1swYSxYw)NT)exist_okz.tmp-)prefixdirr z --dist-dirr()r@rBrmakedirstempfileTemporaryDirectoryrrr|r>rrSrDrUremoverename) r! setup_commandresult_extensionresult_directoryrfarbitrary_args temp_opts tmp_dist_dirresult_basename result_paths r"_build_with_temp_dirz&_BuildMetaBackend._build_with_temp_dirss577??+;< $t4&/?@  ( ( 59 5"1""?3     CH+, -3WW__RWW__\%BC SXX % HHOOAz * XXa[ "  % G <  8#CHHQK$CHHQK#CHHQK$CHHQKs 0C''(Dr)r%r&r'rr __classcell__)rs@r"rrs %%r$r)rGrSr\rbrkrrdrr_BACKENDrrrrrrrrrr(r$r"rs8  88 2$ 'RYY'CRHNNP#'A'I'I#s'SS%]% /:??///,  2 2 '  4U3S 4+?%@ @AB |G|G~i1iX%%/%%R  'DD'DD#+#L#L "" "" &.&N&N#*2*V*V',,N% & r$