o JAfWc @s0dZddlZddlZddlZddlZddlmZddlmZddlmZddl m Z m Z m Z m Z mZmZmZmZmZmZmZmZddlmZmZddlmZmZdd lmZdd lm Z m!Z!dd l"m#Z#dd l$m%Z%d dl&m'Z'e r~ddl(m)Z)ddl*m+Z+ee,ej-fZ.e dede ffZ/ e de/fZ0ededdZ1 dd+dd,e0ded-fd.d/Z9d0e,d1e,d2e:fd3d4Z;Gd5d6d6ee1ZdS)?ze Load setuptools configuration from ``setup.cfg`` files. **API will be made private in the future** N) defaultdict)partialwraps) TYPE_CHECKINGCallableAnyDictGenericIterableListOptionalSetTupleTypeVarUnion)DistutilsOptionErrorDistutilsFileError) RequirementInvalidRequirement)default_environment)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.distrfind_config_files_applyconfiguration_to_dict)r# find_othersignore_option_errorsrdist filenameshandlersr.\/usr/lib/python3.10/site-packages/setuptools-67.5.1-py3.10.egg/setuptools/config/setupcfg.pyread_configuration5s r0r+rcCst||||S)z`Apply the configuration from a ``setup.cfg`` file into an existing distribution object. )r'_finalize_requires)r+r#r.r.r/apply_configurationOs r2r. 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%r5ospathabspathisfilergetcwdchdirdirnameparse_config_filesparse_configurationcommand_options_finalize_license_files)r+r#r3r*r5current_directoryr,r-r.r.r/r'Xs        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)rBrC getter_name by_attributegetterr.r.r/ _get_optionvs rKr-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_optionsrKrBsection_prefix)r- config_dicthandleroptionvaluer.r.r/r(s  r( distributionr?)ConfigMetadataHandlerConfigOptionsHandlercCst|6}t||||}||js|j|_t|j||||j|j}||j |j|jWd||fS1s>wY||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) rEnsurePackagesDiscoveredrUparse package_dirrTmetadatasrc_root_referenced_filesupdate)rSr?r*ensure_discoveredoptionsmetar.r.r/r>s4  r>label orig_valueparsedc sd|vs tdkr dSt}d|ddd}ztd}|j|vr0t|WdSWdStyU}ztfdd |DrJt||WYd}~dSd}~ww) 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.  Nz#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-2c3s|] }d|VqdS)rN startswith).0markerrbr.r/ sz8_warn_accidental_env_marker_misconfig..) len marker_envkeysrnamewarningswarnrany)r`rarbmarkersmsgreqexr.rir/%_warn_accidental_env_marker_misconfigs$    rvc@seZdZUdZeed< iZeeefed< dede de j fddZ e de fd d Zed d Zd dZe d*ddZe ddZe ddZe ddZdefddZdefddZe ddZe dd Ze d+d"d#Zd$d%Zd&d'Zd(d)Zd!S),r4z1Handles metadata supplied in configuration files.rNaliasesrBr^r]cCs4||_||_t|||_g|_||_t|_dSN) r*rBrL_section_optionssectionsrMr]setr[selfrBr^r*r]r.r.r/__init__szConfigHandler.__init__ccs@|D]\}}||j\}}}|rq|d|fVqdS)N.)items partitionrNlstrip)clsr^ full_namerRpreseprnr.r.r/ryszConfigHandler._section_optionscCstd|jj).Metadata item name to parser function mapping.z!%s must provide .parsers property)NotImplementedError __class____name__r}r.r.r/parserss zConfigHandler.parsersc Cs|j}|j||}zt||}Wn tyt|w|r!dSz |j|dd|}Wntf|jy<YdSwt |j |}t|d||}|||j |dS)NcSs|Srxr.)xr.r.r/'z+ConfigHandler.__setitem__..zset_%s)rBrwgetrGAttributeErrorKeyErrorr Exceptionr*rFr __setattr__rMappend)r} option_namerRrB current_valuerb 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 rccSsg|] }|r|qSr.strip)rgchunkr.r.r/ Csz-ConfigHandler._parse_list..) isinstancelist splitlinessplit)rrR separatorr.r.r/ _parse_list1s   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)rrrr)rrRrresultlinerCrvalr.r.r/ _parse_dictEszConfigHandler._parse_dictcCs|}|dvS)zQRepresents value as boolean. :param value: :rtype: bool )1trueyes)lowerrrRr.r.r/ _parse_boolXszConfigHandler._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)rf ValueErrorrD)rRexclude_directiverCr.r/parserns z3ConfigHandler._exclude_files_parser..parserr.)rrCrr.rr/_exclude_files_parserbs  z#ConfigHandler._exclude_files_parserroot_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)rgr7r.r.r/rz-ConfigHandler._parse_file..r) rr rfrkrr[r\r read_files)r}rRrinclude_directivespec filepathsr.r.r/ _parse_fileys    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:)rfreplacer\r]rXr read_attr)r}rRrXrattr_directive attr_descr.r.r/ _parse_attrs   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|Srxr.)rRrbmethod parse_methodsr.r/rWs z1ConfigHandler._get_parser_compound..parser.)rrrWr.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_parserrRrC_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|Srxr.rvrr.r/rsz6ConfigHandler._parse_section_to_dict..cSs|Srxr.rr.r.r/rrr)rrrrr.rr/_parse_section_to_dicts z$ConfigHandler._parse_section_to_dictc CsL|D]\}\}}tt |||<Wdn1swYqdS)zQParses configuration file section. :param dict section_options: N)r contextlibsuppressr)r}rrnrrRr.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. rz_%szparse_section%sr__Nz0Unsupported distribution option section: [%s.%s])rzrrGrrrN)r} section_namermethod_postfixsection_parser_methodr.r.r/rWs" 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|Srx)rorp)argskwargsfuncrs warning_classr.r/config_handlers z@ConfigHandler._deprecated_config_handler..config_handlerr)r}rrsrrr.rr/_deprecated_config_handlersz(ConfigHandler._deprecated_config_handler)rrx)r __module__ __qualname____doc__r __annotations__rwr r!AllCommandOptionsrrVr~ classmethodrypropertyrrrrrr_PathrrrrrrrWrr.r.r.r/r4sJ            r4c speZdZdZdddddZdZ dejfd d d ed e d e j de e def fdd ZeddZddZZS)rTrYurl description classifiers platforms) home_pagesummary classifierplatformFNrBrr^r*r]rXrcs"t||||||_||_dSrx)superr~rXr)r}rBr^r*r]rXrrr.r/r~s  zConfigMetadataHandler.__init__cCsh|j}t|j|jd}|j}|j}|||||dt|||||d||ddt||||j |d S)rrz[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 obsoletesrrr license_filesrlong_descriptionversion project_urls) rrrrrrrrr_parse_version)r} parse_list parse_file parse_dictexclude_files_parserr.r.r/r's4 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.) rrrrrrrDrErrrrX)r}rRrtmplr.r.r/rIs   z$ConfigMetadataHandler._parse_version)rrrrNrw strict_moder6curdirrboolrrVr rLrr~rrr __classcell__r.r.rr/rT s6  !rTrcseZdZdZdddededejffdd Ze dd Z d d Z d e d e fddZ eddZddZddZddZddZddZddZddZd d!Zd"d#ZZS)$rUr^rBrr*r]cs$t|||||j|_i|_dSrx)rr~rZrrXr|rr.r/r~gs zConfigOptionsHandler.__init__cCs|j|ddS)N;)r)rrr.r.r/_parse_list_semicolonrsz*ConfigOptionsHandler._parse_list_semicoloncCs|j||jdS)Nr)rr)r}rRr.r.r/_parse_file_in_rootvsz(ConfigOptionsHandler._parse_file_in_rootr`rRcCs*|||}t|||dd|DS)NcSsg|] }|ds|qS)#re)rgrr.r.r/rszAConfigOptionsHandler._parse_requirements_list..)rr rv)r}r`rRrbr.r.r/_parse_requirements_listys z-ConfigOptionsHandler._parse_requirements_listcCsV|j}|j}|j}|j}||||||||dtt|jd|j|j|j |j |t |dS)rzeThe namespace_packages parameter is deprecated, consider using implicit namespaces instead (PEP 420).install_requires)zip_safeinclude_package_datarXscriptseager_resourcesdependency_linksnamespace_packagesr setup_requires tests_requirepackages entry_points py_modulespython_requirescmdclass) rrr_parse_cmdclassrrrr r_parse_packagesr r)r}r parse_boolrparse_cmdclassr.r.r/rs4zConfigOptionsHandler.parserscCs|jj}t||||jSrx)r]rXrrrr)r}rRrXr.r.r/rsz$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) namespacesrfill_package_dirNr.) rrparse_section_packages__findrzrr\rrXr find_packages)r}rRfind_directives trimmed_value find_kwargsr.r.r/rs   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.)rgkr valid_keysr.r/rs$zEConfigOptionsHandler.parse_section_packages__find..r%Nr)rrrLrr)r}r section_datar$r%r.r)r/r s  z1ConfigOptionsHandler.parse_section_packages__findcCs|||j}||d<dS)z`Parses `entry_points` configuration file section. :param dict section_options: rN)rrr}rrbr.r.r/parse_section_entry_pointss z/ConfigOptionsHandler.parse_section_entry_pointscCs|||j}t|Srx)rrrcanonic_package_data)r}r 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: r/Nr0r}rr.r.r/parse_section_package_dataz/ConfigOptionsHandler.parse_section_package_datacCr1)zhParses `exclude_package_data` configuration file section. :param dict section_options: exclude_package_dataNr2r3r.r.r/"parse_section_exclude_package_datar5z7ConfigOptionsHandler.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(rrr.r/rrzCConfigOptionsHandler.parse_section_extras_require..extras_requireNrr,r.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)rrrcanonic_data_filesrr,r.r.r/parse_section_data_filessz-ConfigOptionsHandler.parse_section_data_files)rrrrNrrrrVr~rrr r r rrrrr r-r0r4r7r:r=rr.r.rr/rUds4    rU)FF)r.F)F)?rr6rrFro collectionsrrrtypingrrrr r r r r rrrrdistutils.errorsrr(setuptools.extern.packaging.requirementsrrZ#setuptools.extern.packaging.markersrrlZ#setuptools.extern.packaging.versionrr&setuptools.extern.packaging.specifiersrZsetuptools._deprecation_warningrrrr%rdistutils.distrr PathLikerSingleCommandOptionsrr!rLr0r2rr'rKr(r>rrvr4rTrUr.r.r.r/sx   8            .%%Z