o JAfY @sdZddlZddlZddlZddlmZddlmZddlmZddlm Z m Z m Z m Z m Z mZmZmZmZmZmZddlmZmZddlmZmZdd lmZdd lmZd d lmZe rjdd l m!Z!ddl"m#Z#ee$ej%fZ&e dede ffZ' e de'fZ(ededdZ)  d5de&de*fddZ+ddde&ddfddZ,  d6ddde&dee&de-dedf d d!Z.d"e)d#e$fd$d%Z/d&edde*fd'd(Z0 d7d)dd*e(ded+fd,d-Z1Gd.d/d/e e)Z2Gd0d1d1e2d2Z3Gd3d4d4e2dZ4dS)8ze Load setuptools configuration from ``setup.cfg`` files. **API will be made private in the future** N) defaultdict)partialwraps) TYPE_CHECKINGCallableAnyDictGenericIterableListOptionalTupleTypeVarUnion)DistutilsOptionErrorDistutilsFileError)VersionInvalidVersion) SpecifierSet)SetuptoolsDeprecationWarning)expand Distribution)DistributionMetadatastrTarget)rr)boundFfilepathreturncCs8ddlm}|}|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.distrZfind_config_files_applyconfiguration_to_dict)rZ find_othersignore_option_errorsrdist filenameshandlersr(?/usr/lib/python3.10/site-packages/setuptools/config/setupcfg.pyread_configuration&s r*r%rcCst||||S)z`Apply the configuration from a ``setup.cfg`` file into an existing distribution object. )r"Z_finalize_requires)r%rr(r(r)apply_configurationBs r+r( other_filesr$) ConfigHandler.c Csddlm}tj|}tj|std|t}ttj |g||}z|j ||dt ||j |d}| Wt||St|w)zHRead configuration from ``filepath`` and applies to the ``dist`` object.r) _Distributionz%Configuration file %s does not exist.)r&)r$)r!r.ospathabspathisfilergetcwdchdirdirnameZparse_config_filesparse_configurationcommand_optionsZ_finalize_license_files)r%rr,r$r.Zcurrent_directoryr&r'r(r(r)r"Ks        r" target_objkeycCs2djdit}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. z get_{key}Nr()formatlocals functoolsrgetattr)r8r9Z getter_nameZ by_attributegetterr(r(r) _get_optionhs r?r'cCs<tt}|D]}|jD]}t|j|}|||j|<q q|S)zReturns configuration data gathered by given handlers as a dict. :param list[ConfigHandler] handlers: Handlers list, usually from parse_configuration() :rtype: dict )rdict set_optionsr?r8section_prefix)r'Z config_dicthandleroptionvaluer(r(r)r#ts  r# distributionr7)ConfigMetadataHandlerConfigOptionsHandlercCs|t|-}t||||}||js|j|_t|j||||j|j}|Wd||fS1s5wY||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)rEnsurePackagesDiscoveredrHparse package_dirrGmetadatasrc_root)rFr7r$ensure_discoveredoptionsmetar(r(r)r6s.   r6c@seZdZUdZeed< iZeeefed< dede de j fddZ e d d Zd d Zed&ddZeddZeddZeddZedefddZdefddZeddZed'ddZd d!Zd"d#Zd$d%ZdS)(r-z1Handles metadata supplied in configuration files.rBaliasesr8rOrNc Csdi}|j}|D]\}}||sq ||dd}|||<q ||_||_||_g|_||_ dS)N.) rBitems startswithreplacestripr$r8sectionsrArN) selfr8rOr$rNrXrB section_namesection_optionsr(r(r)__init__s   zConfigHandler.__init__cCstd|jj).Metadata item name to parser function mapping.z!%s must provide .parsers property)NotImplementedError __class____name__)rYr(r(r)parserss zConfigHandler.parsersc Cst}|j}|j||}t|||}||urt||rdSd}|j|}|r?z||}Wnty>d}|js<Ynw|rCdSt|d|d}|durVt |||n|||j |dS)NFTzset_%s) tupler8rQgetr=KeyErrorra Exceptionr$setattrrAappend) rYZ option_namerEunknownr8 current_valueZ skip_optionparsersetterr(r(r) __setitem__s4    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  cSsg|] }|r|qSr(rW).0chunkr(r(r) sz-ConfigHandler._parse_list..) isinstancelist splitlinessplit)clsrE separatorr(r(r) _parse_lists   zConfigHandler._parse_listcCsPd}i}||D]}||\}}}||krtd||||<q |S)zPRepresents value as a dict. :param value: :rtype: dict =z(Unable to parse option value to dict: %s)ry partitionrrW)rwrErxresultliner9sepvalr(r(r) _parse_dictszConfigHandler._parse_dictcCs|}|dvS)zQRepresents value as boolean. :param value: :rtype: bool )1trueyes)lowerrwrEr(r(r) _parse_bool,szConfigHandler._parse_boolcfdd}|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 cs d}||rtd|S)Nfile:zCOnly strings are accepted for the {0} field, files are not accepted)rU ValueErrorr:)rEZexclude_directiver9r(r)rjBs z3ConfigHandler._exclude_files_parser..parserr()rwr9rjr(rr)_exclude_files_parser6s  z#ConfigHandler._exclude_files_parserroot_dircCsPd}t|ts |S||s|S|t|d}dd|dD}t||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 rNcss|]}|VqdSNro)rpr0r(r(r) dsz,ConfigHandler._parse_file..rm)rsrrUlenrvrZ read_files)rwrErZinclude_directivespecZ filepathsr(r(r) _parse_fileMs   zConfigHandler._parse_filecCs:d}||s |S||d}||jjt|||S)zRepresents value as a module attribute. Examples: attr: package.attr attr: package.module.attr :param str value: :rtype: str zattr:rR)rUrVupdaterNrKrZ read_attr)rYrErKrZattr_directiveZ attr_descr(r(r) _parse_attrgs   zConfigHandler._parse_attrcr)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|Srr()rEparsedmethod parse_methodsr(r)rJs z1ConfigHandler._get_parser_compound..parser()rwrrJr(rr)_get_parser_compound{s z"ConfigHandler._get_parser_compoundNcCs6i}|pdd}|D] \}\}}||||<q |S)zParses section options into a dictionary. Optionally applies a given parser to values. :param dict section_options: :param callable values_parser: :rtype: dict cSs|Srr()rr(r(r)sz6ConfigHandler._parse_section_to_dict..)rT)rwr[Z values_parserrEr9_rr(r(r)_parse_section_to_dicts  z$ConfigHandler._parse_section_to_dictc Cs8|D]\}\}}z|||<WqtyYqwdS)zQParses configuration file section. :param dict section_options: N)rTrd)rYr[namerrEr(r(r) parse_sections  zConfigHandler.parse_sectioncCsb|jD])\}}d}|rd|}t|d|ddd}|dur*td|j|f||qdS)zTParses configuration file items from one or more related sections. rRz_%szparse_section%srS__Nz0Unsupported distribution option section: [%s.%s])rXrTr=rVrrB)rYrZr[Zmethod_postfixZsection_parser_methodr(r(r)rJs" zConfigHandler.parsecstfdd}|S)zthis function will wrap around parameters that are deprecated :param msg: deprecation message :param warning_class: class of warning exception to be raised :param func: function to be wrapped around cst|i|Sr)warningswarn)argskwargsfuncmsg warning_classr(r)config_handlers z@ConfigHandler._deprecated_config_handler..config_handlerr)rYrrrrr(rr)_deprecated_config_handlersz(ConfigHandler._deprecated_config_handler)rmr)r` __module__ __qualname____doc__r__annotations__rQr rAllCommandOptionsrrIr\propertyrarl classmethodryrrr_PathrrrrrrJrr(r(r(r)r-sD   &       r-c speZdZdZdddddZdZ dejfd d d ed e d e j de e def fdd ZeddZddZZS)rGrLurl description classifiers platforms)Z home_pagesummaryZ classifierplatformFNr8rrOr$rNrKrcs"t||||||_||_dSr)superr\rKr)rYr8rOr$rNrKrr_r(r)r\s  zConfigMetadataHandler.__init__cCsh|j}t|j|jd}|j}|j}|||||dt|||||d||ddt||||j |d S)r]rz[The requires parameter is deprecated, please use install_requires for runtime dependencies.license license_filezDThe license_file parameter is deprecated, use license_files instead.) rkeywordsZprovidesrequiresZ obsoletesrrrZ license_filesrZlong_descriptionversionZ project_urls) ryrrrrrrrr_parse_version)rY parse_list parse_file parse_dictZexclude_files_parserr(r(r)ras4 zConfigMetadataHandler.parserscCsn|||j}||kr+|}zt|W|Sty*d}t|jditwt | ||j |jS)zSParses `version` option value. :param value: :rtype: str zCVersion loaded from {value} does not comply with PEP 440: {version}Nr() rrrWrrrr:r;rrrrK)rYrErtmplr(r(r)rs   z$ConfigMetadataHandler._parse_version)r`rrrBrQZ strict_moder/curdirrboolrrIr r@rr\rrar __classcell__r(r(rr)rGs6  !rGrcseZdZdZdddededejffdd Ze dd Z d d Z d d Z e ddZddZddZddZddZddZddZddZddZd d!ZZS)"rHrOr8rr$rNcs$t|||||j|_i|_dSr)rr\rMrrK)rYr8rOr$rNrr(r)r\4s zConfigOptionsHandler.__init__cCs|j|ddS)N;)rx)ryrr(r(r)_parse_list_semicolon?sz*ConfigOptionsHandler._parse_list_semicoloncCs|j||jdS)Nr)rr)rYrEr(r(r)_parse_file_in_rootCsz(ConfigOptionsHandler._parse_file_in_rootcCs|||}dd|DS)NcSsg|] }|ds|qS)#)rU)rpr}r(r(r)rrKszAConfigOptionsHandler._parse_requirements_list..)rr)rYrErr(r(r)_parse_requirements_listFsz-ConfigOptionsHandler._parse_requirements_listcCsP|j}|j}|j}|j}||||||||dt|j|j|j|j|j |t |dS)r]zeThe namespace_packages parameter is deprecated, consider using implicit namespaces instead (PEP 420).)Zzip_safeZinclude_package_datarKscriptsZeager_resourcesZdependency_linksnamespace_packagesZinstall_requiresZsetup_requiresZ tests_requirepackages entry_pointsZ py_modulesZpython_requirescmdclass) ryrr_parse_cmdclassrrrr_parse_packagesrr)rYrZ parse_boolrZparse_cmdclassr(r(r)raMs0zConfigOptionsHandler.parserscCs|jj}t||||jSr)rNrKrrrr)rYrErKr(r(r)rlsz$ConfigOptionsHandler._parse_cmdclasscCsbddg}|}||vr||S||jdi}|j||dk|j|jdtj di|S)zTParses `packages` option value. :param value: :rtype: list zfind:zfind_namespace:z packages.findr) namespacesrZfill_package_dirNr() rWryparse_section_packages__findrXrcrrrKrZ find_packages)rYrEZfind_directivesZ trimmed_value find_kwargsr(r(r)rps   z$ConfigOptionsHandler._parse_packagescsR|||j}gdtfdd|D}|d}|dur'|d|d<|S)zParses `packages.find` configuration file section. To be used in conjunction with _parse_packages(). :param dict section_options: )whereincludeexcludecs$g|]\}}|vr|r||fqSr(r()rpkvZ valid_keysr(r)rrs$zEConfigOptionsHandler.parse_section_packages__find..rNr)rryr@rTrc)rYr[Z section_datarrr(rr)rs  z1ConfigOptionsHandler.parse_section_packages__findcC|||j}||d<dS)z`Parses `entry_points` configuration file section. :param dict section_options: rN)rryrYr[rr(r(r)parse_section_entry_pointss z/ConfigOptionsHandler.parse_section_entry_pointscCs|||j}t|Sr)rryrZcanonic_package_data)rYr[ package_datar(r(r)_parse_package_datas z(ConfigOptionsHandler._parse_package_datacC|||d<dS)z`Parses `package_data` configuration file section. :param dict section_options: rNrrYr[r(r(r)parse_section_package_dataz/ConfigOptionsHandler.parse_section_package_datacCr)zhParses `exclude_package_data` configuration file section. :param dict section_options: Zexclude_package_dataNrrr(r(r)"parse_section_exclude_package_datarz7ConfigOptionsHandler.parse_section_exclude_package_datacCr)zbParses `extras_require` configuration file section. :param dict section_options: Zextras_requireN)rrrr(r(r)parse_section_extras_requires  z1ConfigOptionsHandler.parse_section_extras_requirecCs$|||j}t||j|d<dS)z^Parses `data_files` configuration file section. :param dict section_options: Z data_filesN)rryrZcanonic_data_filesrrr(r(r)parse_section_data_filessz-ConfigOptionsHandler.parse_section_data_files)r`rrrBrrrrIr\rrrrrrarrrrrrrrrrr(r(rr)rH0s4   rH)FF)r(F)F)5rr/rr< collectionsrrrtypingrrrr r r r r rrrZdistutils.errorsrrZ#setuptools.extern.packaging.versionrrZ&setuptools.extern.packaging.specifiersrZsetuptools._deprecation_warningrrRrr!rdistutils.distrrPathLikerZSingleCommandOptionsrrr@r*r+rr"r?r#r6r-rGrHr(r(r(r)sr   4           +&[