a jc@sdZddlmZddlZddlZddlZddlmZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZdd lmZdd lmZmZdd lmZdd lmZmZdd lm Z ddl!m"Z"m#Z#ddl$m%Z%ddl&m'Z'e rddl(m)Z)ddl*m+Z+edede ffZ,ede,fZ-ededdZ.dCdddddZ/ddddd d!Z0dDddd#d$d%d&d'd(Z1ddd)d*d+Z2d%dd,d-d.Z3dEdd/d0d1d2d3Z4ddd4d5d6d7Z5Gd8d9d9ee.Z6Gd:d;d;e6d<Z7Gd=d>d>e6dZ8Gd?d@d@e%Z9GdAdBdBe%Z:dS)Fa< 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)partialwraps) TYPE_CHECKINGCallableAnyDictGenericIterableTupleTypeVarUnion)StrPath) FileError OptionError)default_environment)InvalidRequirement Requirement) SpecifierSet)InvalidVersionVersion)SetuptoolsDeprecationWarning)expand)DistributionMetadata DistributionstrTarget)rr)boundFrdict)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.@E:\soccer\ml_env\Lib\site-packages\setuptools/config/setupcfg.pyread_configuration8s  r0r)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_configurationRs r1r.zIterable[StrPath]boolztuple[ConfigHandler, ...])r+r$ other_filesr*r%c Csddlm}tj|}tj|s4td|dt}ttj |g||}z4|j ||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&r4ospathabspathisfilergetcwdchdirdirnameparse_config_filesparse_configurationcommand_optionsZ_finalize_license_files)r+r$r3r*r4Zcurrent_directoryr,r-r.r.r/r([s     r() 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)r?r@Z getter_nameZ by_attributegetterr.r.r/ _get_optionys  rE)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 )rr# set_optionsrEr?section_prefix)r-Z config_dicthandleroptionvaluer.r.r/r)s   r)AllCommandOptionsz2tuple[ConfigMetadataHandler, ConfigOptionsHandler]) distributionr>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)rLr>r*ensure_discoveredoptionsmetar.r.r/r=s. "r=list)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[r.r/ z8_warn_accidental_env_marker_misconfig..) len marker_envkeysrname_AmbiguousMarkeremitranymessage)rYrZr[markersr^exmsgr.rcr/%_warn_accidental_env_marker_misconfigs   rqc@seZdZUdZded<iZded<dddd d d Zedd d dZe ddZ ddZ ed1ddZ eddZ eddZeddZddddZddd d!Zed"d#Zed$d%Zed2d'd(Zd)d*Zd+d,d-d.Zd/d0Zd&S)3 ConfigHandlerz1Handles metadata supplied in configuration files.r rGzdict[str, str]aliasesr!rKexpand.EnsurePackagesDiscovered)r?rVrUcCs4||_||_t|||_g|_||_t|_dSN) r*r?r#_section_optionssectionsrFrUsetrSselfr?rVr*rUr.r.r/__init__szConfigHandler.__init__)rVccs>|D]0\}}||j\}}}|r(q|d|fVqdS)N.)items partitionrGlstrip)clsrVZ full_namerJpreseprir.r.r/rvs zConfigHandler._section_optionscCstd|jjdS).Metadata item name to parser function mapping.z!%s must provide .parsers propertyN)NotImplementedError __class____name__rzr.r.r/parserss zConfigHandler.parsersc Cs|j}|j||}zt||}Wn.tyP}zt||WYd}~n d}~00|rZdSz|j|dd|}Wntf|jyYdS0t |j |}t|d||}|||j |dS)NcSs|Srur.)xr.r.r/%rez+ConfigHandler.__setitem__..zset_%s)r?rsgetrCAttributeErrorKeyErrorr Exceptionr*rBr __setattr__rFappend) rzZ option_namerJr? current_valueer[Z simple_settersetterr.r.r/ __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|qSr.strip)rachunkr.r.r/ Arez-ConfigHandler._parse_list..) isinstancerX splitlinessplit)rrJ separatorr.r.r/ _parse_list/s   zConfigHandler._parse_listcCsRd}i}||D]:}||\}}}||kr.parserr.)rr@rr.rr/_exclude_files_parser^s z#ConfigHandler._exclude_files_parserrroot_dircCs\d}t|ts|S||s |S|t|d}dd|dD}|j|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 rNcSsg|] }|qSr.r)rar6r.r.r/rrez-ConfigHandler._parse_file..r) rr r`rfrrSrTrZ read_files)rzrJrZinclude_directivespecZ filepathsr.r.r/ _parse_fileus    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:)r`replacerTrUrOrZ read_attr)rzrJrOrZattr_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|Srur.)rJr[method 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 )r})rsection_options values_parserrJr@_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|Srur.rvrr.r/rrez6ConfigHandler._parse_section_to_dict..cSs|Srur.rr.r.r/rrer)rrrrr.rr/_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)rzrrirrJr.r.r/ parse_sections zConfigHandler.parse_sectionNone)r%cCsh|jD]X\}}d}|r"d|}t|d|ddd}|durZtd|jd|d||q dS) zTParses configuration file items from one or more related sections. rz_%szparse_section%sr|__Nz*Unsupported distribution option section: [])rwr}rCrrrG)rz section_namerZmethod_postfixZsection_parser_methodr.r.r/rNs$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_DeprecatedConfigrk)argskwargsfunckwrpr.r/config_handlers z@ConfigHandler._deprecated_config_handler..config_handlerr)rzrrprrr.rr/_deprecated_config_handlersz(ConfigHandler._deprecated_config_handler)r)N)r __module__ __qualname____doc____annotations__rsr{ classmethodrvpropertyrrrrrrrrrrrrrNrr.r.r.r/rrs8           rrcs^eZdZdZdddddZdZdejfd d d d d ddfdd Ze ddZ ddZ Z S)rPrQurl description classifiers platforms)Z home_pagesummary classifierplatformFNrrKr2rtz dict | Noner)r?rVr*rUrOrcs"t||||||_||_dSru)superr{rOr)rzr?rVr*rUrOrrr.r/r{s zConfigMetadataHandler.__init__c CsL|j}t|j|jd}|j}|j}||||||||d||||j|d S)rrlicense) rkeywordsprovides obsoletesrrZ license_filesrlong_descriptionversionZ project_urls)rrrrrrr_parse_version)rz parse_listZ parse_file parse_dictZexclude_files_parserr.r.r/r#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) rrrrrrrrrrO)rzrJrrr.r.r/r9s z$ConfigMetadataHandler._parse_version) rrrrGrsZ strict_moder5curdirr{rrr __classcell__r.r.rr/rPs   rPrcseZdZdZdddddfdd Zed d Zd d Zd d dddZe ddZ ddZ ddZ ddZ ddZddZddZdd Zd!d"Zd#d$ZZS)%rMrVrrKr2rt)r?rVr*rUcs$t|||||j|_i|_dSru)rr{rRrrOryrr.r/r{VszConfigOptionsHandler.__init__cCs|j|ddS)N;)r)rrr.r.r/_parse_list_semicolonasz*ConfigOptionsHandler._parse_list_semicoloncCs|j||jdS)Nr)rr)rzrJr.r.r/_parse_file_in_rootesz(ConfigOptionsHandler._parse_file_in_rootr )rYrJcCs*|||}t|||dd|DS)NcSsg|]}|ds|qS)#r_)rarr.r.r/rnrezAConfigOptionsHandler._parse_requirements_list..)rrrq)rzrYrJr[r.r.r/_parse_requirements_lisths z-ConfigOptionsHandler._parse_requirements_listcCsT|j}|j}|j}|j}||||||||dt|jd|j|j|j|j |t |dS)rzeThe namespace_packages parameter is deprecated, consider using implicit namespaces instead (PEP 420).install_requires)Zzip_safeZinclude_package_datarOscriptsZeager_resourcesZdependency_linksnamespace_packagesrZsetup_requiresZ tests_requirepackages entry_points py_modulesZpython_requirescmdclass) rrr_parse_cmdclassrrrr_parse_packagesrr)rzrZ parse_boolrZparse_cmdclassr.r.r/rps2zConfigOptionsHandler.parserscCs|jj}t||||jSru)rUrOrrrr)rzrJrOr.r.r/rsz$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__findrwrrTrrOrZ find_packages)rzrJZfind_directivesZ trimmed_value find_kwargsr.r.r/rs   z$ConfigOptionsHandler._parse_packagescsR|||j}gdtfdd|D}|d}|durN|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.)rakrZ valid_keysr.r/rszEConfigOptionsHandler.parse_section_packages__find..rNr)rrr#r}r)rzrZ section_datarrr.rr/rs   z1ConfigOptionsHandler.parse_section_packages__findcCs|||j}||d<dS)z`Parses `entry_points` configuration file section. :param dict section_options: rN)rrrzrr[r.r.r/parse_section_entry_pointssz/ConfigOptionsHandler.parse_section_entry_pointscCs|||j}t|Sru)rrrZcanonic_package_data)rzr package_datar.r.r/_parse_package_datasz(ConfigOptionsHandler._parse_package_datacCs|||d<dS)z`Parses `package_data` configuration file section. :param dict section_options: rNrrzrr.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_dataNr r r.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)r)rrrr.r/rrezCConfigOptionsHandler.parse_section_extras_require..Zextras_requireNrrr.rr/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)rrrrGr{rrrrrrrrrrrr r r rrr.r.rr/rMSs"    rMc@s$eZdZdZdZdZeddZdS)rjzAmbiguous 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)rrdocsr.r.r/rms z_AmbiguousMarker.messageN)rrrrrrrrmr.r.r.r/rjs rjc@seZdZdZdS)rz!userguide/declarative_config.htmlN)rrrrr.r.r.r/rsr)FF)r.F)F);r __future__rrrBr5 collectionsrrrtypingrrr r r r r rr_pathrerrorsrrZextern.packaging.markersrrgZextern.packaging.requirementsrrZextern.packaging.specifiersrZextern.packaging.versionrrwarningsrrrdistutils.distrr&rZSingleCommandOptionsrKr!r0r1r(rEr)r=rqrrrPrMrjrr.r.r.r/sR    ,          . #M