a0bic S r SSKrSSKrSSKrSSKJr SSKJr SSKJr SSKJ r J
r
J r J r J
r
JrJrJrJrJrJrJr SSKJrJr SS KJr SS
KJ r J r SS K J r SS K J!r!J"r" SS
K#J$r$ SSK%J&r& \ ( a SSK'J(r( SSK)J*r* \\+\RX 4 r-\ S\S\ 4 4 r. \ S\.4 r/\" S\S S9r0 S8S\-S\14S jjr2SSS\-SS4S jr3 S9SSS\-S \\- S \4S\S 4
S jjr5S \0S!\+4S" jr6S#\S S\14S$ jr7 S:S%SS&\/S\S' 4S( jjr8S)\+S*\+S+\94S, jr: " S- S.\
\0 5 r; " S/ S0\;S1 5 r< " S2 S3\;S 5 r= " S4 S5\$5 r> " S6 S7\$5 r?g);a<
Load setuptools configuration from ``setup.cfg`` files.
**API will be made private in the future**
To read project metadata, consider using
``build.util.project_wheel_metadata`` (https://pypi.org/project/build/).
For simple scenarios, you can also try parsing the file directly
with the help of ``configparser``.
N) defaultdict)partialwraps)
TYPE_CHECKINGCallableAnyDictGenericIterableListOptionalSetTupleTypeVarUnion ) FileError OptionError)default_environment)InvalidRequirement Requirement) SpecifierSet)InvalidVersionVersion) SetuptoolsDeprecationWarning )expand)DistributionMetadata DistributionstrTarget)r! r )boundfilepathreturnc | SSK Jn U" 5 nU( a UR 5 O/ n[ X@XR5 n[ U5 $ )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-python313-setuptools-69.0.2-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/setuptools/config/setupcfg.pyread_configurationr2 8 s7 $ - >D,7&&(RIdiFH ** r. r! c < [ X5 U R 5 U $ )zXApply the configuration from a ``setup.cfg`` file into an existing
distribution object.
)r* _finalize_requires)r. r% s r1 apply_configurationr6 R s 4 Kr3 other_filesr- )
ConfigHandler.c SSK Jn [ R R U5 n[ R R U5 ( d [
SU S35 e[ R " 5 n[ R " [ R R U5 5 / UQUPn UR XS9 [ X R US9nU R 5 [ R " U5 U$ ! [ R " U5 f = f)zHRead configuration from ``filepath`` and applies to the ``dist`` object.r )
_DistributionzConfiguration file z does not exist.)r/ )r- )r( r: ospathabspathisfiler getcwdchdirdirnameparse_config_filesparse_configurationcommand_options_finalize_license_files)r. r% r7 r- r: current_directoryr/ r0 s r1 r* r* [ s .wwx(H
77>>( # #-hZ7GHII HHRWW__X
&'(+(x(I$(((C& &&=Q
$$&
"# O "#s (3C3 3D
target_objkeyc h SU 3n[ R " [ X5 n[ XU5 nU" 5 $ )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.
get_) functoolsr getattr)rG rH getter_name by_attributegetters r1 _get_optionrP y s4 ,K $$Wj>L
Zl
;F 8Or3 r0 c [ [ 5 nU H= nUR H* n[ UR U5 nXAUR
U' M, M? U$ )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_optionsrP rG section_prefix)r0 config_dicthandleroptionvalues r1 r+ r+ sU $D)K ))F 2 2F;E:?.. / 7 *
r3 distributionrD )ConfigMetadataHandlerConfigOptionsHandlerc [ R " U 5 n[ U UUU5 nUR 5 U R ( d UR U l [ U R UUUU R U R 5 nUR 5 U R R UR UR 5 SSS5 XT4$ ! , ( d f WW4$ = f)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 EnsurePackagesDiscoveredr[ parse package_dirrZ metadatasrc_root_referenced_filesupdate)rY rD r- ensure_discoveredoptionsmetas r1 rC rC s $
( ( 6:K&
'''.':':L $$ ! ! $ $ ! !
&&-- % %t'='=
+
72 =3
7 62 =s B/C
C"label
orig_valueparsedc x ^ SU; d [ T5 S:w a g[ 5 R 5 n [ TS 5 nUR U; a [
R
U TS S9 gg! [ aG n[ U4S jU 5 5 ( a# [
R U TS S9n[ U5 Ue SnAgSnAff = f)a= 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.
r Nr )fieldreqc 3 L ># U H nTS R U5 v M g7f)r N)
startswith).0markerri s r1 8_warn_accidental_env_marker_misconfig.. s# B'vay##F++'s !$)
len
marker_envkeysr name_AmbiguousMarkeremitr anymessage)rg rh ri markersrm exmsgs ` r1 %_warn_accidental_env_marker_misconfigr s " zS[A -l !G2&)$ 88w ! !6!9 ! = 2 B'B B B"**F1I*FC$S)r 1 C2s 5A( (
B92=B44B9c > \ rS rSr% Sr\\S' 0 r\\\4 \S' S\ S\
S\ R 4S jr
\S\
4S j5 r\S
5 rS r\SS j5 r\S
5 r\S 5 r\S 5 rS\4S jrS\4S jr\S 5 r\S 5 r\S S j5 r S r S r S r Sr g) r8 z1Handles metadata supplied in configuration files.rT aliasesrG re rd c X0l Xl [ U R U5 5 U l / U l X@l [ 5 U l g N) r- rG rR _section_optionssectionsrS rd setrb )selfrG re r- rd s r1 __init__ConfigHandler.__init__ sC %9!$ T 2 27 ;<
&(!2 +.5 r3 c # # UR 5 HA u p#UR U R 5 u pEnU( a M, UR S5 U4v MC g 7f)N.)items partitionrT lstrip)clsre full_namerX preseprw s r1 r ConfigHandler._section_options sL '
I & 0 01C1C DNCd++c"E) ) !0s AAc F [ SU R R - 5 e).Metadata item name to parser function mapping.z!%s must provide .parsers property)NotImplementedError __class____name__)r s r1 parsersConfigHandler.parsers s# " /$..2I2I I
r3 c U R nU R R X5 n [ X15 nU( a g U R R US 5 " U5 n[ R " UR U5 n[ USU- U5 nU" U5 U R R U5 g ! [ a [ U5 ef = f! [ 4U R - a g f = f)Nc U $ r )xs r1 +ConfigHandler.__setitem__..% s Qr3 zset_%s)rG r getrL AttributeErrorKeyErrorr Exceptionr- rK r __setattr__rS append)r option_namerX rG
current_valueri
simple_settersetters r1 __setitem__ConfigHandler.__setitem__ s __
ll&&{@ ( #J SnU R U5 ( a [ SR T5 5 eU $ )Nfile:zCOnly strings are accepted for the {0} field, files are not accepted)ro
ValueErrorformat)rX exclude_directiverH s r1 parser3ConfigHandler._exclude_files_parser..parserj s= ' 122 --3VC[ Lr3 r )r rH r s ` r1 _exclude_files_parser#ConfigHandler._exclude_files_parser^ s
r3 root_dirc H Sn[ U[ 5 ( d U$ UR U5 ( d U$ U[ U5 S nUR S5 Vs/ s H oUR 5 PM nnU R R U5 [ R " Xb5 $ s snf )a 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 N,)
r r" ro rt r r rb rc r
read_files)r rX r include_directivespecr< filepathss r1 _parse_fileConfigHandler._parse_fileu s $%%%L 122LS*+-..2jjo>odZZ\o > %%i0 55 ?s B c SnUR U5 ( d U$ UR US5 nUR U R R 5 [
R " XRU5 $ )zRepresents value as a module attribute.
Examples:
attr: package.attr
attr: package.module.attr
:param str value:
:rtype: str
zattr: )ro replacerc rd r_ r read_attr)r rX r_ r attr_directive attr_descs r1 _parse_attrConfigHandler._parse_attr s^ ! //LMM."5 411==> AAr3 c ^ U4S jnU$ )zReturns parser function to represents value as a list.
Parses a value applying given methods one after another.
:param parse_methods:
:rtype: callable
c . > U nT H nU" U5 nM
U$ r r )rX ri method
parse_methodss r1 r^ 1ConfigHandler._get_parser_compound..parse s" F' ( Mr3 r )r r r^ s ` r1 _get_parser_compound"ConfigHandler._get_parser_compound s r3 c V 0 nUR 5 H u nu pVU" XF5 X4' M U$ )zParses 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 section_options
values_parserrX rH _r s r1 _parse_section_to_dict_with_key-ConfigHandler._parse_section_to_dict_with_key s3 , 2 2 4MC!&s0EJ 5 r3 Nc F ^ T( a U4S jOS nU R X5 $ )zParses 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 > T" U5 $ r r )r vr s r1 r 6ConfigHandler._parse_section_to_dict.. s
}Q /r3 c U$ r r )r r s r1 r r s UVr3 r )r r r r s ` r1 _parse_section_to_dict$ConfigHandler._parse_section_to_dict s! 5B/22?KKr3 c UR 5 H/ u nu p4[ R " [ 5 X@U' SSS5 M1 g! , ( d f MC = f)zAParses configuration file section.
:param dict section_options:
N)r
contextlibsuppressr )r r rw r rX s r1
parse_sectionConfigHandler.parse_section sB
!0 5 5 7 D*1$$X. "T
/. !8..s A
A c U R R 5 HZ u pSnU( a SU- n[ U SU- R SS5 S5 nUc [ SU R
SU S35 eU" U5 M\ g) zDParses configuration file items from one
or more related sections.
r z_%szparse_section%sr __Nz*Unsupported distribution option section: [])r r rL r r rT )r section_namer method_postfixsection_parser_methods r1 r^ ConfigHandler.parse s
.2]]-@-@-B )L N!& !58?"^3<
"/ 2% .Cr3 c 8 ^^^ [ T5 UUU4S j5 nU$ )zthis function will wrap around parameters that are deprecated
:param msg: deprecation message
:param func: function to be wrapped around
c h > TR SS5 [ R " ST40 TD6 T" U 0 UD6$ )N
stacklevelr z Deprecated config in `setup.cfg`)
setdefault_DeprecatedConfigry )argskwargsfunckwr~ s r1 config_handler@ConfigHandler._deprecated_config_handler..config_handler s7 MM, * " "#Es Qb Q(( (r3 r )r r
r~ r r s ``` r1 _deprecated_config_handler(ConfigHandler._deprecated_config_handler s#
t )
)
r3 )rb rd r- r rS rG )r r )!r
__module__ __qualname____firstlineno____doc__r" __annotations__r r
r# AllCommandOptionsr r] r classmethodr propertyr r r r r r _Pathr r r r r r r^ r __static_attributes__r r3 r1 r8 r8 s> ;
!GT#s(^ #
":: " *'8 * *
-4 C C& - - ,65 64B B( &
L
L#32
r3 r8 c
^ \ rS rSrSrSSSSS.rSr S \R 4S
S S \ S
\
S\ R S\
\ S\4 U 4S jjjr\S 5 rS rSrU =r$ )rZ i r` url description classifiers platforms) home_pagesummary
classifierplatformFNrG r re r- rd r_ r c > > [ TU ] XX45 XPl X`l g r )superr r_ r )r rG re r- rd r_ r r s r1 r ConfigMetadataHandler.__init__ s .BV&
r3 c U R n[ U R U R S9nU R nU R
nUUUUU R
X!5 U" S5 UUUU R US. $ )r r license) r keywordsprovides obsoletesr r(
license_filesr long_descriptionversion project_urls)r r r r r r r _parse_version)r
parse_list
parse_file
parse_dictexclude_files_parsers r1 r ConfigMetadataHandler.parsers# s %%
T - -
F
%%
# 9 9 $""# 44ZL+I6 '% *** &
r3 c 0 U R XR 5 nX!:w a UR 5 n [ U5 U$ [ R " U R XR U R 5 5 $ ! [ a [ SU SU 35 ef = f)z;Parses `version` option value.
:param value:
:rtype: str
zVersion loaded from z does not comply with PEP 440: )
r r r r r r r r. r r_ )r rX r. s r1 r0 $ConfigMetadataHandler._parse_version9 s ""5--8 mmoG
N~~d . .u6F6F
VWW "
!*5' 2,,396
s A9 9 Br_ r )r r r r rT r strict_moder; curdirr boolr r] r rR r r r r r0 r
__classcell__r s @r1 rZ rZ s N # G K '+ )) !* ! # ! # !
":: ! d^
! ! !
*X Xr3 rZ r c ^ \ rS rSrSrSSS\S\S\R 4U 4S jjr \
S 5 r S r S
\
S \
4S jr\S
5 rS rS rS rS rS rS rS rS rS rSrU =r$ )r[ iS re rG r! r- rd c V > [ TU ] XX45 UR U l 0 U l g r )r$ r ra r r_ )r rG re r- rd r s r1 r ConfigOptionsHandler.__init__V s* .BV"++
+-r3 c " U R USS9$ )N;)r )r r s r1 _parse_list_semicolon*ConfigOptionsHandler._parse_list_semicolona s u44r3 c 4 U R XR S9$ )Nr' )r r )r rX s r1 _parse_file_in_root(ConfigOptionsHandler._parse_file_in_roote s
>>r3 rg rX c U R U R U5 5 n[ XU5 U Vs/ s H oDR S5 ( a M UPM sn$ s snf )N#)rC rF r ro )r rg rX ri r s r1 _parse_requirements_list-ConfigOptionsHandler._parse_requirements_listh sJ ++D,D,DU,KL-eFC "(Ds/CDDDs AAc & U R nU R nU R nU R nUUUUUUU R US5 [ U R S5 U R U R U R U R U[ US.$ )r zeThe namespace_packages parameter is deprecated, consider using implicit namespaces instead (PEP 420).install_requires)zip_safeinclude_package_datar_ scriptseager_resourcesdependency_linksnamespace_packagesrM setup_requires
tests_requirepackages entry_points
py_modulespython_requirescmdclass) r r r _parse_cmdclassr r rJ rC _parse_packagesrF r )r r1
parse_boolr3 parse_cmdclasss r1 r ConfigOptionsHandler.parsersp s %%
%%
%%
-- #$.%! ) *"&"A"AH# !(--/A! # 8 8 ! 7 7 ,, 4 4$ +&-
r3 c U R R n[ R " U R U5 X R
5 $ r )rd r_ r rZ r r )r rX r_ s r1 r[ $ConfigOptionsHandler._parse_cmdclass s3 ,,88 t / / 6 ]]SSr3 c , SS/nUR 5 nX2; a U R U5 $ U R U R R S0 5 5 nUR X2S :H U R U R S9 [ R " S0 UD6$ )zN>NO %^ r3 c d U R XR 5 n[ R " U5 $ r )r r r canonic_package_data)r r package_datas r1 _parse_package_data(ConfigOptionsHandler._parse_package_data s) 22?DTDTU **<88r3 c , U R U5 U S' g)zPParses `package_data` configuration file section.
:param dict section_options:
ry Nrz r r s r1 parse_section_package_data/ConfigOptionsHandler.parse_section_package_data s
$ 7 7 H^ r3 c , U R U5 U S' g)zXParses `exclude_package_data` configuration file section.
:param dict section_options:
exclude_package_dataNr} r~ s r1 "parse_section_exclude_package_data7ConfigOptionsHandler.parse_section_exclude_package_data s
(,'?'?'P
#$r3 c < ^ T R UU 4S j5 nUT S' g)zRParses `extras_require` configuration file section.
:param dict section_options:
c 0 > TR SU S3U5 $ )Nzextras_require[r )rJ )rq r r s r1 r CConfigOptionsHandler.parse_section_extras_require.. s 66 17MqQr3 extras_requireNr rt s ` r1 parse_section_extras_require1ConfigOptionsHandler.parse_section_extras_require s(
55 Q
"(
r3 c U R XR 5 n[ R " X R 5 U S' g)zNParses `data_files` configuration file section.
:param dict section_options:
data_filesN)r r r canonic_data_filesr rt s r1 parse_section_data_files-ConfigOptionsHandler.parse_section_data_files s3
,,_>N>NO # 6 6v}} M\r3 r8 ) r r r r rT r r; r r] r r rC rF r" rJ r r r[ r\ re ru rz r r r r r r< r= s @r1 r[ r[ S s N ." . # . # .
":: . 5 5?Ec E# E
@T32*&9IQ
(N Nr3 r[ c 0 \ rS rSrSrSrSr\S 5 rSr g)rx i z Ambiguous requirement marker.z
One of the parsed requirements in `{field}` looks like a valid environment marker:
{req!r}
Please make sure that the configuration file is correct.
You can use dangling lines to avoid this problem.
z'userguide/declarative_config.html#opt-2c j SU R 3nU R U R U R X!S9$ )Nz%https://setuptools.pypa.io/en/latest/)see_url format_args) _SEE_DOCS_format_SUMMARY_DETAILS)r r docss r1 r{ _AmbiguousMarker.message s/ 6s}}oF{{3<< t{TTr3 r N)
r r r r r r r r r{ r r r3 r1 rx rx s+ .HH :I U Ur3 rx c \ rS rSrSrSrg)r i z!userguide/declarative_config.htmlr N)r r r r r r r r3 r1 r r s 3Ir3 r )FF)r F)F)@r r rK r; collectionsr r r typingr r r r
r r r
r r r r r errorsr r extern.packaging.markersr ru extern.packaging.requirementsr r extern.packaging.specifiersr extern.packaging.versionr r warningsr r r distutils.distr r( r! r" PathLiker SingleCommandOptionsr r# rR r2 r6 r; r* rP r+ rC r r r8 rZ r[ rx r r r3 r1 r s #
, H K 6 > 3 3,
c2;; E5#4 45
445 'M!N O >C++ +4n . $&!&
%
< F E*>$? D * + +&+ :; +\ 2 2# 2t 2@^ GFO ^ B JXM*@ A JXZ\N= 8 \N~U3 U(44 4r3