a 6Rhg@s4UdZddlmZddlZddlZddlZddlmZddlm Z m Z ddlm Z m Z ddl mZmZmZmZmZmZmZddlmZdd lmZmZdd lmZmZd d lmZd d l m!Z!d dl"m#Z#m$Z$d dl%m&Z&ddlm'Z'erddl(m)Z)ddl*m+Z+ddl,m-Z-e.e/e0e/effZ1de2d<e.e/e1fZ3de2d<edddZ4dEdddddd d!Z5dddd"d#d$Z6dFddd&dd'd(d)d*Z7d+d,d-d.d/Z8d0dd1d2d3Z9dGdddd'd4d5d6Z:d,d,d7d8d9d:Z;Gd;d<dd>eGdAdBdBe&Z?GdCdDdDe&Z@dS)Ha< 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``. ) annotationsN) defaultdict)IterableIterator)partialwraps) TYPE_CHECKINGAnyCallableClassVarGenericTypeVarcast)default_environment)InvalidRequirement Requirement)InvalidVersionVersion)_static)StrPath) FileError OptionError)SetuptoolsDeprecationWarning)expand) TypeAlias Distribution)DistributionMetadatarSingleCommandOptionsAllCommandOptionsTargetrrFrbooldict)filepath find_othersignore_option_errorsreturncCs8ddlm}|}|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 rr)setuptools.distrfind_config_files_applyconfiguration_to_dict)r%r&r'rdist filenameshandlersr0P/opt/python-3.9.24/usr/lib/python3.9/site-packages/setuptools/config/setupcfg.pyread_configuration2s  r2)r-r%r(cCst||||S)z`Apply the configuration from a ``setup.cfg`` file into an existing distribution object. )r+Z_finalize_requires)r-r%r0r0r1apply_configurationLs r3r0zIterable[StrPath]z2tuple[ConfigMetadataHandler, ConfigOptionsHandler])r-r% other_filesr'r(c Csddlm}tj|}tj|s4td|dt}ttj |g||}z>|j |t t t |dt||j|d}|Wt|n t|0|S)zHRead configuration from ``filepath`` and applies to the ``dist`` object.r) _DistributionzConfiguration file z does not exist.)r.)r')r)r5ospathabspathisfilergetcwdchdirdirnameparse_config_filesrliststrparse_configurationcommand_optionsZ_finalize_license_files)r-r%r4r'r5Zcurrent_directoryr.r/r0r0r1r+Us     r+z#Distribution | DistributionMetadatar?) target_objkeycCs*d|}tt||}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. get_) functoolsrgetattr)rBrCZ getter_nameZ by_attributegetterr0r0r1 _get_optionts  rHzKIterable[ConfigHandler[Distribution] | ConfigHandler[DistributionMetadata]])r/r(cCs<tt}|D]*}|jD]}t|j|}|||j|<qq |S)zReturns configuration data gathered by given handlers as a dict. :param Iterable[ConfigHandler] handlers: Handlers list, usually from parse_configuration() :rtype: dict )rr$ set_optionsrHrBsection_prefix)r/Z config_dicthandleroptionvaluer0r0r1r,s   r,) distributionrAr'r(cCst|f}t||||}||js0|j|_t|j||||j|j}||j |j|jWdn1sv0Y||fS)aPerforms 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) rZEnsurePackagesDiscoveredConfigOptionsHandlerparse package_dirConfigMetadataHandlermetadatasrc_root_referenced_filesupdate)rNrAr'ensure_discoveredoptionsmetar0r0r1r@s. "r@r>)label orig_valueparsedc sd|vstdkrdSt}z,td}|j|vrLtj|ddWnVty}z>tfdd|Drtj |dd}t||WYd}~n d}~00dS)amBecause 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.  rNr)fieldreqc3s|]}d|VqdS)rN startswith).0markerr\r0r1 z8_warn_accidental_env_marker_misconfig..) len marker_envkeysrname_AmbiguousMarkeremitranymessage)rZr[r\markersr_exmsgr0rdr1%_warn_accidental_env_marker_misconfigs   rrc@seZdZUdZded<iZded<dddd d d d Zedd dddZe ddZ d dddZ ed3ddZ eddZ eddZeddZdd d!d"Zd#d d$d%Zed&d'Zed(d)Zed4d+d,Zd dd-d.Zd dd/d0Zd1d2Zd*S)5 ConfigHandlerz1Handles metadata supplied in configuration files.r?rJzClassVar[dict[str, str]]aliasesr"r!expand.EnsurePackagesDiscoveredNone)rBrXrWr(cCs8||_||_t|||_g|_||_tt|_ dSN) r'rBr$_section_optionssectionsrIrWsetr?rUselfrBrXr'rWr0r0r1__init__s zConfigHandler.__init__z*Iterator[tuple[str, SingleCommandOptions]])rXr(ccs>|D]0\}}||j\}}}|r(q|d|fVqdS)N.)items partitionrJlstrip)clsrXZ full_namerMpreZ_seprjr0r0r1rxs zConfigHandler._section_optionscCst|jjddS).Metadata item name to parser function mapping.z must provide .parsers propertyN)NotImplementedError __class____name__r|r0r0r1parserss zConfigHandler.parsersr(c Cs|j}|j||}zt||}Wn.tyP}zt||WYd}~n d}~00|rZdSz|j|dd|}Wntf|jyYdS0t |j |}t|d||}|||j |dS)NcSs|Srwr0)xr0r0r1&rfz+ConfigHandler.__setitem__..set_)rBrtgetrFAttributeErrorKeyErrorr Exceptionr'rEr __setattr__rIappend) r|Z option_namerMrB current_valueer\Z simple_settersetterr0r0r1 __setitem__s  zConfigHandler.__setitem__,cCs8t|tr|Sd|vr |}n ||}dd|DS)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 r]cSsg|]}|r|qSr0strip)rbchunkr0r0r1 Brfz-ConfigHandler._parse_list..) isinstancer> splitlinessplit)rrM separatorr0r0r1 _parse_list0s   zConfigHandler._parse_listcCsRd}i}||D]:}||\}}}||kr.parserr0)rrCrr0rr1_exclude_files_parser_s z#ConfigHandler._exclude_files_parserStrPath | Noneroot_dircCshd}t|ts|S||s&t|S|t|d}dd|dD}|j|tt ||S)aORepresents 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 rNcSsg|] }|qSr0r)rbr7r0r0r1rrfz-ConfigHandler._parse_file..r) rr?rarrrgrrUrVrZ read_files)r|rMrZinclude_directivespecZ filepathsr0r0r1 _parse_filevs     zConfigHandler._parse_filercCs@d}||st|S||d}||jjt|||S)zRepresents value as a module attribute. Examples: attr: package.attr attr: package.module.attr :param str value: :rtype: str zattr:) rarrreplacerVrWrQrZ read_attr)r|rMrQrZattr_directiveZ attr_descr0r0r1 _parse_attrs    zConfigHandler._parse_attrcsfdd}|S)zReturns parser function to represents value as a list. Parses a value applying given methods one after another. :param parse_methods: :rtype: callable cs|}D] }||}q|Srwr0)rMr\method parse_methodsr0r1rPs z1ConfigHandler._get_parser_compound..parser0)rrrPr0rr1_get_parser_compounds z"ConfigHandler._get_parser_compoundcCs,i}|D]\}\}}|||||<q |S)aParses 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)rsection_options values_parserrMrC_rr0r0r1_parse_section_to_dict_with_keys z-ConfigHandler._parse_section_to_dict_with_keyNcs$rfddndd}|||S)aParses 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 cs|Srwr0rvrr0r1rrfz6ConfigHandler._parse_section_to_dict..cSs|Srwr0rr0r0r1rrf)r)rrrrr0rr1_parse_section_to_dicts z$ConfigHandler._parse_section_to_dictc CsL|D]>\}\}}tt|||<Wdq1s<0YqdS)zQParses configuration file section. :param dict section_options: N)r contextlibsuppressr)r|rrjrrMr0r0r1 parse_sections zConfigHandler.parse_sectioncCsl|jD]\\}}d}|r$d|}t|d|ddd}|dur^td|jd|d||q dS) zTParses configuration file items from one or more related sections. rrrr~__Nz*Unsupported distribution option section: [])ryrrFrrrJ)r| section_namerZmethod_postfixZsection_parser_methodr0r0r1rPs$ zConfigHandler.parsec stfdd}|S)zthis function will wrap around parameters that are deprecated :param msg: deprecation message :param func: function to be wrapped around cs.ddtjdfi|i|S)N stacklevelrz Deprecated config in `setup.cfg`) setdefault_DeprecatedConfigrl)argskwargsfunckwrqr0r1config_handlers z@ConfigHandler._deprecated_config_handler..config_handler)r)r|rrqrrr0rr1_deprecated_config_handlersz(ConfigHandler._deprecated_config_handler)r)N)r __module__ __qualname____doc____annotations__rtr} classmethodrxpropertyrrrrrrrrrrrrrPrr0r0r0r1rss8            rsc s`eZdZdZdddddZdZdejfd d d d d dddfdd Ze ddZ ddZ Z S)rRrSurl description classifiers platforms)Z home_pagesummary classifierplatformFNrr!r#ruz dict | Nonerrv)rBrXr'rWrQrr(cs"t||||||_||_dSrw)superr}rQr)r|rBrXr'rWrQrrr0r1r}s zConfigMetadataHandler.__init__cCsx||jtj}||jtj}t|j|jd}|j }tj tj tj tj ||||||||d|||tj |j tj |dS)rrlicense)author author_email maintainermaintainer_emailrkeywordsprovides obsoletesrrZ license_filesrlong_descriptionZlong_description_content_typeversionrZ project_urls) rrrListrDictrrrrr_parse_version)r|Zparse_list_staticZparse_dict_static parse_fileZexclude_files_parserr0r0r1r%s, zConfigMetadataHandler.parsersc Cs|||j}||krj|}z t|Wn:tyd}z"td|d||WYd}~n d}~00|St|||j |jS)zSParses `version` option value. :param value: :rtype: str zVersion loaded from z does not comply with PEP 440: N) rrrrrrrrrrQ)r|rMrrr0r0r1rAs z$ConfigMetadataHandler._parse_version) rrrrJrtZ strict_moder6curdirr}rrr __classcell__r0r0rr1rRs   rRcseZdZdZddddddfdd Zed d Zd d ZdddddZe ddZ ddZ ddZ ddZ ddddZddZdddd Zddd!d"Zddd#d$Zddd%d&ZZS)'rOrXrr!r#rurv)rBrXr'rWr(cs$t|||||j|_i|_dSrw)rr}rTrrQr{rr0r1r}^szConfigOptionsHandler.__init__cCs|j|ddS)N;)r)rrr0r0r1_parse_list_semicolonisz*ConfigOptionsHandler._parse_list_semicoloncCs|j||jdS)Nr)rr)r|rMr0r0r1_parse_file_in_rootmsz(ConfigOptionsHandler._parse_file_in_rootr?)rZrMcCs0|||}t|||tdd|DS)Ncss|]}|ds|VqdS)#Nr`)rbrr0r0r1revrfz@ConfigOptionsHandler._parse_requirements_list..)rrrrrr)r|rZrMr\r0r0r1_parse_requirements_listps z-ConfigOptionsHandler._parse_requirements_listcCsN|j}|j}|j}|||j|||||dt|jd|j|j|j |t j |dS)rzeThe namespace_packages parameter is deprecated, consider using implicit namespaces instead (PEP 420).install_requires)Zzip_safeZinclude_package_datarQscriptsZeager_resourcesZdependency_linksnamespace_packagesrZsetup_requirespackages entry_points py_modulesZpython_requirescmdclass) rr_parse_cmdclassrrrrr_parse_packagesrr SpecifierSet)r|Z parse_listZ parse_boolZparse_cmdclassr0r0r1rys.zConfigOptionsHandler.parserscCs|jj}t||||jSrw)rWrQrrrr)r|rMrQr0r0r1rsz$ConfigOptionsHandler._parse_cmdclasscCsbddg}|}||vr"||S||jdi}|j||dk|j|jdtj fi|S)zTParses `packages` option value. :param value: :rtype: list zfind:zfind_namespace:z packages.findr) namespacesrZfill_package_dir) rrparse_section_packages__findryrrVrrQrZ find_packages)r|rMZfind_directivesZ trimmed_value find_kwargsr0r0r1rs   z$ConfigOptionsHandler._parse_packagescsN|||j}gdfdd|D}|d}|durJ|d|d<|S)zParses `packages.find` configuration file section. To be used in conjunction with _parse_packages(). :param dict section_options: )whereincludeexcludecs"i|]\}}|vr|r||qSr0r0)rbkrZ valid_keysr0r1 rfzEConfigOptionsHandler.parse_section_packages__find..r Nr)rrrr)r|rZ section_datarr r0r r1rs  z1ConfigOptionsHandler.parse_section_packages__findrcCs|||j}||d<dS)z`Parses `entry_points` configuration file section. :param dict section_options: rN)rrr|rr\r0r0r1parse_section_entry_pointssz/ConfigOptionsHandler.parse_section_entry_pointscCs|||j}t|Srw)rrrZcanonic_package_data)r|r package_datar0r0r1_parse_package_datasz(ConfigOptionsHandler._parse_package_datacCs|||d<dS)z`Parses `package_data` configuration file section. :param dict section_options: rNrr|rr0r0r1parse_section_package_datasz/ConfigOptionsHandler.parse_section_package_datacCs|||d<dS)zhParses `exclude_package_data` configuration file section. :param dict section_options: Zexclude_package_dataNrrr0r0r1"parse_section_exclude_package_datasz7ConfigOptionsHandler.parse_section_exclude_package_datacs&|fdd}t|d<dS)zbParses `extras_require` configuration file section. :param dict section_options: csd|d|S)Nzextras_require[r)r)r rrr0r1rrfzCConfigOptionsHandler.parse_section_extras_require..Zextras_requireN)rrrrr0rr1parse_section_extras_requires  z1ConfigOptionsHandler.parse_section_extras_requirecCs$|||j}t||j|d<dS)z^Parses `data_files` configuration file section. :param dict section_options: data_filesN)rrrZcanonic_data_filesrrr0r0r1parse_section_data_filessz-ConfigOptionsHandler.parse_section_data_files)rrrrJr}rrrrrrrrrrrrrrrrr0r0rr1rO[s"     rOc@s$eZdZdZdZdZeddZdS)rkzAmbiguous 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-2cKs"d|j}|j|j|j||dS)Nz%https://setuptools.pypa.io/en/latest/)Zsee_urlZ format_args) _SEE_DOCS_format_SUMMARY_DETAILS)rrdocsr0r0r1rns z_AmbiguousMarker.messageN)rrrrrrrrnr0r0r0r1rks rkc@seZdZdZdS)rz!userguide/declarative_config.htmlN)rrrrr0r0r0r1r sr)FF)r0F)F)Ar __future__rrrEr6 collectionsrcollections.abcrrrrtypingrr r r r r rZpackaging.markersrrhZpackaging.requirementsrrZpackaging.versionrrrr_pathrerrorsrrwarningsrrZtyping_extensionsrr)rdistutils.distrr$r?tupler rr!r"r2r3r+rHr,r@rrrsrRrOrkrr0r0r0r1sT  $           . &S