U -cnb@sdZddlZddlZddlZddlZddlmZddlmZddlmZddl m Z m Z m Z m Z mZmZmZmZmZmZmZddlmZmZddlmZmZdd lmZmZdd lmZdd l m!Z!d d l"m#Z#e rddl$m%Z%ddl&m'Z'ee(ej)fZ*e dede ffZ+e de+fZ,ededdZ-d5e*e.dddZ/de*ddddZ0d6de*ee*e1edddd Z2e-e(d!d"d#Z3ede.d$d%d&Z4d7de,ed'd(d)d*Z5e(e(e6d+d,d-Z7Gd.d/d/ee-Z8Gd0d1d1e8d2Z9Gd3d4d4e8dZ:dS)8ze 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)rr)boundF)filepathreturncCs8ddlm}|}|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!Z find_othersignore_option_errorsrdist filenameshandlersr+>/tmp/pip-unpacked-wheel-izj_87as/setuptools/config/setupcfg.pyread_configuration(s  r-r)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!r+r+r,apply_configurationDs r.r+) ConfigHandler.)r(r! other_filesr'r"c Csddlm}tj|}tj|s0td|t}ttj |||f}z*|j ||dt ||j |d}| W5t|X|S)zHRead configuration from ``filepath`` and applies to the ``dist`` object.r) _Distributionz%Configuration file %s does not exist.)r))r')r#r1ospathabspathisfilergetcwdchdirdirnameparse_config_filesparse_configurationcommand_optionsZ_finalize_license_files)r(r!r0r'r1Zcurrent_directoryr)r*r+r+r,r%Ms"       r%) target_objkeycCs.djft}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})formatlocals functoolsrgetattr)r<r=Z getter_nameZ by_attributegetterr+r+r, _get_optionjs rC)r*r"cCs<tt}|D]*}|jD]}t|j|}|||j|<qq |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_optionsrCr<section_prefix)r*Z config_dicthandleroptionvaluer+r+r,r&vs   r&)ConfigMetadataHandlerConfigOptionsHandler) distributionr;r"c Csbt|J}t||||}||js0|j|_t|j||||j|j}|W5QRX||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 )rEnsurePackagesDiscoveredrKparse package_dirrJmetadatasrc_root)rLr;r'ensure_discoveredoptionsmetar+r+r,r:s( r:)label orig_valueparsedc Cspd|kst|dkrdSttDd|}t|}|jdk rbd|d|dd}t|t W5QRXdS) 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.  N;z#One of the parsed requirements in `z*` looks like a valid environment marker: 'rz}' Make sure that the config is correct and check https://setuptools.pypa.io/en/latest/userguide/declarative_config.html#opt-2) len contextlibsuppressrjoinrmarkerwarningswarn UserWarning)rUrVrWZoriginal_requirements_strreqmsgr+r+r,%_warn_accidental_env_marker_misconfigs   rec@seZdZUdZeed<iZeeefed<ee e j dddZ e ddZd d Zed&d d ZeddZeddZeddZeedddZedddZeddZeddZed'ddZd d!Zd"d#Zd$d%ZdS)(r/z1Handles metadata supplied in configuration files.rFaliases)r<rSrRc Csdi}|j}|D].\}}||s&q||dd}|||<q||_||_||_g|_||_ dS)N.) rFitems startswithreplacestripr'r<sectionsrErR) selfr<rSr'rRrmrF section_namesection_optionsr+r+r,__init__s  zConfigHandler.__init__cCstd|jjdS).Metadata item name to parser function mapping.z!%s must provide .parsers propertyN)NotImplementedError __class____name__rnr+r+r,parserss zConfigHandler.parsersc Cst}|j}|j||}t|||}||kr6t||r>dSd}|j|}|rz ||}Wn tk r~d}|jszYnX|rdSt|d|d}|dkrt |||n|||j |dS)NFTzset_%s) tupler<rfgetrAKeyErrorrw Exceptionr'setattrrEappend) rnZ option_namerIunknownr<Z current_valueZ skip_optionparsersetterr+r+r, __setitem__s0   zConfigHandler.__setitem__,cCs8t|tr|Sd|kr |}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 rXcSsg|]}|r|qSr+rl).0chunkr+r+r, :sz-ConfigHandler._parse_list..) isinstancelist splitlinessplit)clsrI separatorr+r+r, _parse_list(s   zConfigHandler._parse_listcCsPd}i}||D]8}||\}}}||kr:td||||<q|S)zPRepresents value as a dict. :param value: :rtype: dict =z(Unable to parse option value to dict: %s)r partitionrrl)rrIrresultliner=sepvalr+r+r, _parse_dict<szConfigHandler._parse_dictcCs|}|dkS)zQRepresents value as boolean. :param value: :rtype: bool )1trueyes)lowerrrIr+r+r, _parse_boolOszConfigHandler._parse_boolcsfdd}|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)rj ValueErrorr>)rIZexclude_directiver=r+r,res z3ConfigHandler._exclude_files_parser..parserr+)rr=rr+rr,_exclude_files_parserYs 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|]}|VqdSNr)rr3r+r+r, sz,ConfigHandler._parse_file..r)rrrjr[rrZ read_files)rrIrZinclude_directivespecZ filepathsr+r+r, _parse_fileps  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:rg)rjrkupdaterRrOrZ read_attr)rnrIrOrZattr_directiveZ attr_descr+r+r, _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|Srr+)rIrWmethod parse_methodsr+r,rNs z1ConfigHandler._get_parser_compound..parser+)rrrNr+rr,_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 )ri)rrp values_parserrIr=_rr+r+r,_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|Srr+rvrr+r,z6ConfigHandler._parse_section_to_dict..cSs|Srr+rr+r+r,rrr)rrprrr+rr,_parse_section_to_dicts z$ConfigHandler._parse_section_to_dictc Cs8|D]*\}\}}tt|||<W5QRXqdS)zQParses configuration file section. :param dict section_options: N)rir\r]rz)rnrpnamerrIr+r+r, parse_sections zConfigHandler.parse_sectioncCsb|jD]R\}}d}|r"d|}t|d|ddd}|dkrTtd|j|f||q dS)zTParses configuration file items from one or more related sections. rgz_%szparse_section%srh__Nz0Unsupported distribution option section: [%s.%s])rmrirArkrrF)rnrorpZmethod_postfixZsection_parser_methodr+r+r,rNs 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||Sr)r`ra)argskwargsfuncrd warning_classr+r,config_handlers z@ConfigHandler._deprecated_config_handler..config_handlerr)rnrrdrrr+rr,_deprecated_config_handlersz(ConfigHandler._deprecated_config_handler)r)N)ru __module__ __qualname____doc__r__annotations__rfr rAllCommandOptionsrrMrqpropertyrwr classmethodrrrr_PathrrrrrrrNrr+r+r+r,r/s<    &        r/csdeZdZdZdddddZdZdejfd ee e j e e ed fd d Zed dZddZZS)rJrPurl description classifiers platforms)Z home_pagesummary classifierplatformFNr)r<rSr'rRrOrcs"t||||||_||_dSr)superrqrOr)rnr<rSr'rRrOrrtr+r,rqs zConfigMetadataHandler.__init__cCsh|j}t|j|jd}|j}|j}|||||dt|||||d||ddt||||j |d S)rrrz[The requires parameter is deprecated, please use install_requires for runtime dependencies.license license_filezDThe license_file parameter is deprecated, use license_files instead.) rkeywordsprovidesrequires obsoletesrrrZ license_filesrlong_descriptionversion project_urls) rrrrrrrrr_parse_version)rn parse_listZ parse_file parse_dictZexclude_files_parserr+r+r,rw s4 zConfigMetadataHandler.parserscCsr|||j}||krZ|}z t|Wn*tk rTd}t|jftYnX|St | ||j |jS)zSParses `version` option value. :param value: :rtype: str zCVersion loaded from {value} does not comply with PEP 440: {version}) rrrlrrrr>r?rrrrO)rnrIrtmplr+r+r,rBs z$ConfigMetadataHandler._parse_version)rurrrFrfZ strict_moder2curdirrboolrrMr rDrrqrrwr __classcell__r+r+rr,rJs(   !rJrcseZdZdZdeeejdfdd Ze ddZ dd Z e e d d d Z ed dZddZddZddZddZddZddZddZddZdd ZZS)!rKrSr)r<rSr'rRcs$t|||||j|_i|_dSr)rrqrQrrO)rnr<rSr'rRrr+r,rqaszConfigOptionsHandler.__init__cCs|j|ddS)NrZ)r)rrr+r+r,_parse_list_semicolonlsz*ConfigOptionsHandler._parse_list_semicoloncCs|j||jdS)Nr)rr)rnrIr+r+r,_parse_file_in_rootpsz(ConfigOptionsHandler._parse_file_in_root)rUrIcCs*|||}t|||dd|DS)NcSsg|]}|ds|qS)#)rj)rrr+r+r,rys zAConfigOptionsHandler._parse_requirements_list..)rrre)rnrUrIrWr+r+r,_parse_requirements_listss z-ConfigOptionsHandler._parse_requirements_listcCsV|j}|j}|j}|j}||||||||dtt|jd|j|j|j |j |t |dS)rrzeThe namespace_packages parameter is deprecated, consider using implicit namespaces instead (PEP 420).install_requires)Zzip_safeZinclude_package_datarOscriptsZeager_resourcesZdependency_linksZnamespace_packagesrZsetup_requiresZ tests_requirepackages entry_points py_modulesZpython_requirescmdclass) rrr_parse_cmdclassrrrrr_parse_packagesrr)rnrZ parse_boolrZparse_cmdclassr+r+r,rw{s6zConfigOptionsHandler.parserscCs|jj}t||||jSr)rRrOrrrr)rnrIrOr+r+r,rsz$ConfigOptionsHandler._parse_cmdclasscCs^ddg}|}||kr"||S||jdi}|j||dk|j|jdtj f|S)zTParses `packages` option value. :param value: :rtype: list zfind:zfind_namespace:z packages.findr) namespacesrZfill_package_dir) rlrparse_section_packages__findrmryrrrOrZ find_packages)rnrIZfind_directivesZ trimmed_value find_kwargsr+r+r,rs   z$ConfigOptionsHandler._parse_packagescsT|||j}dddgtfdd|D}|d}|dk rP|d|d<|S)zParses `packages.find` configuration file section. To be used in conjunction with _parse_packages(). :param dict section_options: whereincludeexcludecs$g|]\}}|kr|r||fqSr+r+)rkrZ valid_keysr+r,rszEConfigOptionsHandler.parse_section_packages__find..Nr)rrrDriry)rnrpZ section_datarrr+rr,rs   z1ConfigOptionsHandler.parse_section_packages__findcCs|||j}||d<dS)z`Parses `entry_points` configuration file section. :param dict section_options: rN)rrrnrprWr+r+r,parse_section_entry_pointssz/ConfigOptionsHandler.parse_section_entry_pointscCs|||j}t|Sr)rrrZcanonic_package_data)rnrp package_datar+r+r,_parse_package_datasz(ConfigOptionsHandler._parse_package_datacCs|||d<dS)z`Parses `package_data` configuration file section. :param dict section_options: rNrrnrpr+r+r,parse_section_package_datasz/ConfigOptionsHandler.parse_section_package_datacCs|||d<dS)zhParses `exclude_package_data` configuration file section. :param dict section_options: Zexclude_package_dataNrrr+r+r,"parse_section_exclude_package_datasz7ConfigOptionsHandler.parse_section_exclude_package_datacs |fdd}|d<dS)zbParses `extras_require` configuration file section. :param dict section_options: csd|d|S)Nzextras_require[])r)rrrvr+r,rrzCConfigOptionsHandler.parse_section_extras_require..Zextras_requireNrrr+rvr,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: data_filesN)rrrZcanonic_data_filesrrr+r+r,parse_section_data_filessz-ConfigOptionsHandler.parse_section_data_files)rurrrFrrrrMrqrrrrrrrwrrrrrrrrrrr+r+rr,rK]s*    rK)FF)r+F)F);rr2r\r@r` collectionsrrrtypingrrrr r r r r rrrdistutils.errorsrrZ(setuptools.extern.packaging.requirementsrrZ#setuptools.extern.packaging.versionrrZ&setuptools.extern.packaging.specifiersrZsetuptools._deprecation_warningrrgrr#rdistutils.distrrPathLikerZSingleCommandOptionsrrrDr-r.rr%rCr&r:rrer/rJrKr+r+r+r,sf   4           +!0[