D E r d Z ddlZddlZddlZddlZddlmZ ddlmZ ddlmZ ddl m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZ ddlmZmZ ddlmZmZ dd lm Z m Z dd
l m Z dd l m!Z! d d
l"m#Z# e
r ddl$m%Z% ddl&m'Z' ee(ej) f Z*e
dede f f Z+ e
de+f Z, eded Z- d4de*de.fdZ/ddde*ddfdZ0 d5ddde*d ee* d e1ded f
d Z2d e-d!e(fd"Z3d#ed de.fd$Z4 d6d%dd&e,ded' fd(Z5d)e(d*e(d+e6fd,Z7 G d- d.ee- Z8 G d/ d0e8d1 Z9 G d2 d3e8d Z:dS )7ze
Load setuptools configuration from ``setup.cfg`` files.
**API will be made private in the future**
N) defaultdict)partialwraps)
TYPE_CHECKINGCallableAnyDictGenericIterableListOptionalTupleTypeVarUnion)DistutilsOptionErrorDistutilsFileError) RequirementInvalidRequirement)VersionInvalidVersion) SpecifierSet) SetuptoolsDeprecationWarning )expand Distribution)DistributionMetadatastrTarget)r r )boundFfilepathreturnc ddl m} | }|r| ng }t || || }t | S )a, Read given configuration file and returns options from it as a dict.
:param str|unicode filepath: Path to configuration file
to get options from.
:param bool find_others: Whether to search for other configuration files
which could be on in various places.
:param bool ignore_option_errors: Whether to silently ignore
options, values of which could not be resolved (e.g. due to exceptions
in directives such as file:, attr:, etc.).
If False exceptions are propagated as expected.
:rtype: dict
r r )setuptools.distr find_config_files_applyconfiguration_to_dict)r" find_othersignore_option_errorsr dist filenameshandlerss /builddir/build/BUILDROOT/alt-python311-setuptools-65.6.3-2.el9.x86_64/opt/alt/python311/lib/python3.11/site-packages/setuptools/config/setupcfg.pyread_configurationr/ ( s^ ( -,,,,, <>>D,7?&&(((RIdHi1EFFH * ** r+ r c N t | | | | S )z`Apply the configuration from a ``setup.cfg`` file into an existing
distribution object.
)r' _finalize_requires)r+ r" s r. apply_configurationr3 D s+ 4 Kr0 other_filesr* )
ConfigHandler.c ( ddl m} t j | }t j | st
d|z t j }t j t j | g ||} |
| | t | | j | }|
t j | n# t j | w xY w|S )zHRead configuration from ``filepath`` and applies to the ``dist`` object.r )
_Distributionz%Configuration file %s does not exist.)r, )r* )r% r8 ospathabspathisfiler getcwdchdirdirnameparse_config_filesparse_configurationcommand_options_finalize_license_files)r+ r" r5 r* r8 current_directoryr, r- s r. r' r' M s .-----wx((H
7>>( # # U !H8!STTT HRW__X
&
&'''(+(x(I$(((CCC& $&=Q
$$&&&
"####"#### Os
"AC9 9D
target_objkeyc dj di t }t j t | | }t | || } | S )z
Given a target object and option key, get that option from
the target object, either through a get_{key} method or
from an attribute directly.
z get_{key}r4 )formatlocals functoolsr getattr)rE rF getter_name by_attributegetters r. _get_optionrO j sP %+$00vxx00K $Wj#>>L
Zl
;
;F 688Or0 r- c t t }| D ]1}|j D ]'}t |j | }|||j |< (2|S )zReturns configuration data gathered by given handlers as a dict.
:param list[ConfigHandler] handlers: Handlers list,
usually from parse_configuration()
:rtype: dict
)r dict set_optionsrO rE section_prefix)r- config_dicthandleroptionvalues r. r( r( v sk $D))K @ @ ) @ @F 2F;;E:?K. / 7 7 @ r0 distributionrB )ConfigMetadataHandlerConfigOptionsHandlerc B t j | 5 }t | ||| }| | j s |j | _ t | j |||| j | j }| ddd n # 1 swxY w Y ||fS )a Performs additional parsing of configuration options
for a distribution.
Returns a list of used option handlers.
:param Distribution distribution:
:param dict command_options:
:param bool ignore_option_errors: Whether to silently ignore
options, values of which could not be resolved (e.g. due to exceptions
in directives such as file:, attr:, etc.).
If False exceptions are propagated as expected.
:rtype: list
N)r EnsurePackagesDiscoveredrZ parse package_dirrY metadatasrc_root)rX rB r* ensure_discoveredoptionsmetas r. rA rA s $
( 6 6 :K&
' ;'.':L $$ ! $ !
) , =s A1BBBlabel
orig_valueparsedc D d|v st | dk rdS t j t 5 d | }t | }|j )d| d|d d}t j |t ddd dS # 1 swxY w Y dS ) am Because users sometimes misinterpret this configuration:
[options.extras_require]
foo = bar;python_version<"4"
It looks like one requirement with an environment marker
but because there is no newline, it's parsed as two requirements
with a semicolon as separator.
Therefore, if:
* input string does not contain a newline AND
* parsed result contains two requirements AND
* parsing of the two parts from the result (";")
leads in a valid Requirement with a valid marker
a UserWarning is shown to inform the user about the possible problem.
N;z#One of the parsed requirements in `z*` looks like a valid environment marker: 'r z}'
Make sure that the config is correct and check https://setuptools.pypa.io/en/latest/userguide/declarative_config.html#opt-2)
len
contextlibsuppressr joinr markerwarningswarn UserWarning)rd re rf original_requirements_strreqmsgs r. %_warn_accidental_env_marker_misconfigrv s " zS[[A - - / 0 0
,
,$'HHV$4$4!344 : !_e _ _;A!9_ _ _
M#{ + + +
,
,
,
,
,
,
,
,
,
,
,
,
,
,
,
,
,
,s ABB Bc R e Zd ZU dZeed< i Zeeef ed< dede de
j fdZ e
d Zd Zedd Zed Zed
Zed Zedefd ZdefdZed Zed Zedd Zd Zd Z d Z dS )r6 z1Handles metadata supplied in configuration files.rS aliasesrE rb ra c i }| j }| D ]I\ }}| | s| |d d }|||< J|| _ || _ || _ g | _ || _ d S )N .)
rS items
startswithreplacestripr* rE sectionsrR ra ) selfrE rb r* ra r rS section_namesection_optionss r. __init__zConfigHandler.__init__ s ') ,-4]]__ 5 5 )L/ **>::
'//CCII#NNL%4H\ " "$8!$
&(!2 r0 c : t d| j j z ).Metadata item name to parser function mapping.z!%s must provide .parsers property)NotImplementedError __class____name__)r s r. parserszConfigHandler.parsers s# " /$.2I I
r0 c t }| j }| j || }t ||| }||u rt | |rd S d}| j | }|r' || }n# t $ r
d}| j s Y nw xY w|rd S t |d|z d }|t ||| n || | j
| d S )NFTzset_%s) tuplerE rx getrK KeyErrorr Exceptionr* setattrrR append) r option_namerW unknownrE
current_value skip_optionparsersetters r. __setitem__zConfigHandler.__setitem__ s9 ''_
l&&{K@@
KAA
G # #;'' ' F !!+..
u
" 0
FX %;TBB > J U 3 3 3 3 F5MMM ,,,,,s 8 B BB,c t |t r|S d|v r| }n| | }d |D S )zRepresents value as a list.
Value is split either by separator (defaults to comma) or by lines.
:param value:
:param separator: List items separator character.
:rtype: list
rh c ^ g | ]*}| | +S r4 r ).0chunks r.
z-ConfigHandler._parse_list..: s- BBB%EKKMMB
BBBr0 )
isinstancelist
splitlinessplit)clsrW separators r. _parse_listzConfigHandler._parse_list( s\ eT " " L 5==$$&&EEKK **EBB5BBBBr0 c d}i }| | D ]\}| | \ }}}||k rt d|z | || < ]|S )zPRepresents value as a dict.
:param value:
:rtype: dict
=z(Unable to parse option value to dict: %s)r partitionr r )r rW r resultlinerF sepvals r. _parse_dictzConfigHandler._parse_dict< s OOE** . .D NN9 5 5MCci *>F #&))++F399;;
r0 c 2 | }|dv S )zQRepresents value as boolean.
:param value:
:rtype: bool
)1trueyes)lowerr rW s r. _parse_boolzConfigHandler._parse_boolO s
,,,r0 c fd}|S )zReturns a parser function to make sure field inputs
are not files.
Parses a value after getting the key so error messages are
more informative.
:param key:
:rtype: callable
c z d}| | r"t d | S )Nfile:zCOnly strings are accepted for the {0} field, files are not accepted)r}
ValueErrorrH )rW exclude_directiverF s r. r z3ConfigHandler._exclude_files_parser..parsere sI ' 122
--3VC[[ Lr0 r4 )r rF r s ` r. _exclude_files_parserz#ConfigHandler._exclude_files_parserY s#
r0 root_dirc d}t |t s|S | | s|S |t | d }d | d D }t j || S )aO Represents value as a string, allowing including text
from nearest files using `file:` directive.
Directive is sandboxed and won't reach anything outside
directory with setup.py.
Examples:
file: README.rst, CHANGELOG.md, src/file.txt
:param str value:
:rtype: str
r Nc 3 > K | ]}| V d S Nr )r r: s r. z,ConfigHandler._parse_file.. s* >>dTZZ\\>>>>>>r0 r )r r r} rk r r
read_files)r rW r include_directivespec filepathss r. _parse_filezConfigHandler._parse_filep s $%%% L 122 LS*++--.>>djjoo>>> H555r0 c d}| | s|S | |d }| | j j t j ||| S )zRepresents value as a module attribute.
Examples:
attr: package.attr
attr: package.module.attr
:param str value:
:rtype: str
zattr:rz )r} r~ updatera r^ r read_attr)r rW r^ r attr_directive attr_descs r. _parse_attrzConfigHandler._parse_attr sh ! // LMM."55 41=>>> ;AAAr0 c fd}|S )zReturns parser function to represents value as a list.
Parses a value applying given methods one after another.
:param parse_methods:
:rtype: callable
c , | }D ]
} || }|S r r4 )rW rf method
parse_methodss r. r] z1ConfigHandler._get_parser_compound..parse s+ F'
(
( Mr0 r4 )r r r] s ` r. _get_parser_compoundz"ConfigHandler._get_parser_compound s# r0 c b i }| D ]\ }\ }} ||| ||< |S )a Parses section options into a dictionary.
Applies a given parser to each option in a section.
:param dict section_options:
:param callable values_parser: function with 2 args corresponding to key, value
:rtype: dict
)r| )r r
values_parserrW rF _r s r. _parse_section_to_dict_with_keyz-ConfigHandler._parse_section_to_dict_with_key sH , 2 2 4 4 1 1MC!S& sC00E#JJ r0 Nc D rfdnd }| || S )a Parses section options into a dictionary.
Optionally applies a given parser to each value.
:param dict section_options:
:param callable values_parser: function with 1 arg corresponding to option value
:rtype: dict
c | S r r4 )r vr s r. z6ConfigHandler._parse_section_to_dict.. s }}Q / / r0 c |S r r4 )r r s r. r z6ConfigHandler._parse_section_to_dict.. s UV r0 r )r r r r s ` r. _parse_section_to_dictz$ConfigHandler._parse_section_to_dict s7 5BW/////22?FKKKr0 c | D ]>\ }\ }}t j t 5 || |< ddd n # 1 swxY w Y ?dS )zQParses configuration file section.
:param dict section_options:
N)r| rl rm r )r r namer rW s r.
parse_sectionzConfigHandler.parse_section s
#2"7"7"9"9 # # T:Au$X..
#
# "T
#
#
#
#
#
#
#
#
#
#
#
#
#
#
# # #s AA A c | j D ]^\ }}d}|rd|z }t | d|z dd d }|t d| j d|d || _dS ) zTParses configuration file items from one
or more related sections.
rz z_%szparse_section%sr{ __Nz*Unsupported distribution option section: [])r r| rK r~ r rS )r r r method_postfixsection_parser_methods r. r] zConfigHandler.parse s
.2]-@-@-B-B 3 3 )L/ N
6!& !58?"^3< t j | i |S r )rp rq )argskwargsfuncru
warning_classs r. config_handlerz@ConfigHandler._deprecated_config_handler..config_handler s* M#} - - -4((( (r0 r )r r ru r r s ``` r. _deprecated_config_handlerz(ConfigHandler._deprecated_config_handler sB
t ) ) ) ) ) )
) r0 )r r ) r
__module__ __qualname____doc__r __annotations__rx r
r AllCommandOptionsr r\ r propertyr r classmethodr r r r _Pathr r r r r r r] r r4 r0 r. r6 r6 s ;;
!GT#s(^ 33 #3
": 3 3 3 3.
X
$- $- $-L C C C [C& [$ - - [- [, 6% 6 6 6 [62B B B B B( [& [
L
L
L [
L# # #3 3 34
r0 r6 c
e Zd ZdZdddddZdZ dej fd d
d ed e d
e
j de e
def fd
Zed Zd Z xZS )rY r_ url description classifiers platforms) home_pagesummary
classifierplatformFNrE r rb r* ra r^ r c l t |||| || _ || _ d S r )superr r^ r )r rE rb r* ra r^ r r s r. r z ConfigMetadataHandler.__init__ s8 W.BDUVVV&
r0 c @ | j }t | j | j }| j }| j }|||| |dt || || |d | |d dt |||| j |d
S )r r z[The requires parameter is deprecated, please use install_requires for runtime dependencies.license license_filezDThe license_file parameter is deprecated, use license_files instead.)
r keywordsprovidesrequires obsoletesr r r
license_filesr long_descriptionversion project_urls)
r r r r r r r r r _parse_version)r
parse_list
parse_file
parse_dictexclude_files_parsers r. r z ConfigMetadataHandler.parsers s %
T -
FFF
%
# 9 $"" 77=, $ 44ZLL++I66 ; ;$$^44-, (% ** &/
r0 c d | || j }||k r]| } t | n6# t $ r) d}t |j di t w xY w|S t j |
|| j | j S )zSParses `version` option value.
:param value:
:rtype: str
zCVersion loaded from {value} does not comply with PEP 440: {version}r4 ) r r r r r r rH rI r r r r^ )r rW r tmpls r. r z$ConfigMetadataHandler._parse_versionB s ""5$-88 e mmooG
D !
D
D
D5 +;4;+B+B+B+BCCC
D N~d . .ud6F
V VWWWs A 3A:)r r r rS rx strict_moder9 curdirr boolr r\ r rQ r r r r r
__classcell__r s @r. rY rY s N # G K '+ ) ! !* ! # ! # !
": ! d^
! ! ! ! ! ! !
X
BX X X X X X Xr0 rY r c e Zd ZdZdddededej f fd Ze d Z
d Z d e d
e fd Z
ed Zd
Zd Zd Zd Zd Zd Zd Zd Zd Z xZS )rZ rb rE r r* ra c v t |||| |j | _ i | _ d S r )r r r` r r^ )r rE rb r* ra r s r. r z ConfigOptionsHandler.__init__a s= W.BDUVVV"+
+-r0 c 0 | |d S )Nrj )r )r r s r. _parse_list_semicolonz*ConfigOptionsHandler._parse_list_semicolonl s u444r0 c : | || j S )Nr )r r )r rW s r. _parse_file_in_rootz(ConfigOptionsHandler._parse_file_in_rootp s
>>>r0 rd rW c | | | }t ||| d |D S )Nc < g | ]}| d |S )#)r} )r r s r. r zAConfigOptionsHandler._parse_requirements_list..y s) DDDts/C/CDDDDr0 )r r rv )r rd rW rf s r. _parse_requirements_listz-ConfigOptionsHandler._parse_requirements_lists sL ++D,D,DU,K,KLL-eUFCCC EDDDDDr0 c | j }| j }| j }| j }||||||| |dt
t
| j d | j | j | j | j
|t |dS )r zeThe namespace_packages parameter is deprecated, consider using implicit namespaces instead (PEP 420).install_requires)zip_safeinclude_package_datar^ scriptseager_resourcesdependency_linksnamespace_packagesr" setup_requires
tests_requirepackages entry_points
py_modulespython_requirescmdclass) r r r _parse_cmdclassr r r r r _parse_packagesr r )r r
parse_boolr parse_cmdclasss r. r z ConfigOptionsHandler.parsers{ s %
%
%
- #$.%! ) *"&"A"AH, # # !(-/A! ! # 8 ! 7 , 4$ +&-
r0 c v | j j }t j | | || j S r )ra r^ r r/ r r )r rW r^ s r. r0 z$ConfigOptionsHandler._parse_cmdclass s1 ,8 t / / 6 6 T]SSSr0 c : ddg}| }||vr| | S | | j di }| ||d k | j | j t j di |S )zTParses `packages` option value.
:param value:
:rtype: list
zfind:zfind_namespace:z
packages.findr )
namespacesr fill_package_dirr4 )
r r parse_section_packages__findr r r r r^ r
find_packages)r rW find_directives
trimmed_value find_kwargss r. r1 z$ConfigOptionsHandler._parse_packages s #$56
/ /##E** * 77 M or 2 2
% );;] ! -
#22k222r0 c | || j }g dt fd| D }| d }| |d |d< |S )zParses `packages.find` configuration file section.
To be used in conjunction with _parse_packages().
:param dict section_options:
)whereincludeexcludec * g | ]\ }}|v | ||fS r4 r4 )r kr
valid_keyss r. r zEConfigOptionsHandler.parse_section_packages__find.. s* N N N1ZAaVr0 r> Nr )r r rQ r| r )r r section_datar< r> rC s @r. r8 z1ConfigOptionsHandler.parse_section_packages__find s 22?DDTUU 444
N N N N 2 2 4 4 N N N
(( #(8K r0 c F | || j }|| d< dS )z`Parses `entry_points` configuration file section.
:param dict section_options:
r, N)r r r r rf s r. parse_section_entry_pointsz/ConfigOptionsHandler.parse_section_entry_points s,
,,_d>NOO %^ r0 c ` | || j }t j | S r )r r r canonic_package_data)r r package_datas r. _parse_package_dataz(ConfigOptionsHandler._parse_package_data s+ 22?DDTUU *<888r0 c 6 | | | d< dS )z`Parses `package_data` configuration file section.
:param dict section_options:
rJ NrK r r s r. parse_section_package_dataz/ConfigOptionsHandler.parse_section_package_data s"
$ 7 7 H H^ r0 c 6 | | | d< dS )zhParses `exclude_package_data` configuration file section.
:param dict section_options:
exclude_package_dataNrM rN s r. "parse_section_exclude_package_dataz7ConfigOptionsHandler.parse_section_exclude_package_data s#
(,'?'?'P'P
#$$$r0 c D | fd }| d< dS )zbParses `extras_require` configuration file section.
:param dict section_options:
c 8 d| d| S )Nzextras_require[r )r )rB r r s r. r zCConfigOptionsHandler.parse_section_extras_require.. s# 667M7M7M7MqQQ r0 extras_requireNr rF s ` r. parse_section_extras_requirez1ConfigOptionsHandler.parse_section_extras_require s<
55 Q Q Q Q
"(
r0 c v | || j }t j || j | d< dS )z^Parses `data_files` configuration file section.
:param dict section_options:
data_filesN)r r r canonic_data_filesr rF s r. parse_section_data_filesz-ConfigOptionsHandler.parse_section_data_files s;
,,_d>NOO # 6vt} M M\r0 )r r r rS r r r r\ r r r r r r r r r0 r1 r8 rG rK rO rR rV rZ r r s @r. rZ rZ ] sp N ." . # . # .
": . . . . . . 5 5 [5? ? ?Ec E# E E E E
X
@T T T3 3 32 *& & &9 9 9I I IQ Q Q
(
(
(N N N N N N Nr0 rZ )FF)r4 F)F);r r9 rl rJ rp collectionsr r r typingr r r r
r r r
r r r r distutils.errorsr r (setuptools.extern.packaging.requirementsr r #setuptools.extern.packaging.versionr r &setuptools.extern.packaging.specifiersr setuptools._deprecation_warningr rz r r% r distutils.distr r PathLiker SingleCommandOptionsr r rQ r/ r3 r r' rO r( rA r rv r6 rY rZ r4 r0 r. re s'
# # # # # # 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 F E E E E E E E T T T T T T T T G G G G G G G G ? ? ? ? ? ? H H H H H H 4,,,,,,333333
c2; E5#4 45
445 'M!N O O O
+ ++
+ + + +8n . $&!&
$)% : F E*>$? D * ( ( (&( :; ( ( ( (V , ,# ,t , , , ,Bk k k k k GFO k k k \ XX XX XX XX XXM*@ A XX XX XXv]N ]N ]N ]N ]N= 8 ]N ]N ]N ]N ]Nr0