o 5iGh@sUdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z m Z ddlm Z mZddlmZmZmZmZmZmZmZdd lmZdd lmZmZdd lmZmZd d l m!Z!d dl"m#Z#d dl$m%Z%m&Z&d dl'm(Z(ddl m)Z)erddl*m+Z+ddl,m-Z-ddl.m/Z/e0e1e2e1effZ3de4d< e0e1e3fZ5de4d< edddZ6 dMdNd$d%Z7dOd'd(Z8 ) dPdQd-d.Z9dRd3d4Z:dSd7d8Z; dTdUd;d<ZGdEdFdFe>dZ?GdGdHdHe>dZ@GdIdJdJe(ZAGdKdLdLe(ZBdS)Wa< 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)abstractmethod) defaultdict)IterableIterator)partialwraps) TYPE_CHECKINGAnyCallableClassVarGenericTypeVarcast)default_environment)InvalidRequirement Requirement)InvalidVersionVersion)_static)StrPath) FileError OptionError)SetuptoolsDeprecationWarning)expand) TypeAlias Distribution)DistributionMetadatarSingleCommandOptionsAllCommandOptionsTargetrr Ffilepathr find_othersboolignore_option_errorsreturndictcCs8ddlm}|}|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 filenameshandlersr1Y/root/parts/websockify/install/lib/python3.10/site-packages/setuptools/config/setupcfg.pyread_configuration3s r3r.cCst||||S)z`Apply the configuration from a ``setup.cfg`` file into an existing distribution object. )r,_finalize_requires)r.r$r1r1r2apply_configurationMs r5r1 other_filesIterable[StrPath]2tuple[ConfigMetadataHandler, ConfigOptionsHandler]c Csddlm}tj|}tj|std|dt}ttj |g||}z |j |t t t |dt||j|d}|Wt||St|w)zHRead configuration from ``filepath`` and applies to the ``dist`` object.r) _DistributionzConfiguration file z does not exist.)r/)r')r*r9ospathabspathisfilergetcwdchdirdirnameparse_config_filesrliststrparse_configurationcommand_options_finalize_license_files)r.r$r6r'r9current_directoryr/r0r1r1r2r,Vs       r, target_obj#Distribution | DistributionMetadatakeyrCcCs*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)rHrJ getter_name by_attributegetterr1r1r2 _get_optionus  rQr0KIterable[ConfigHandler[Distribution] | ConfigHandler[DistributionMetadata]]cCs<tt}|D]}|jD]}t|j|}|||j|<q q|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_optionsrQrHsection_prefix)r0 config_dicthandleroptionvaluer1r1r2r-s   r- distributionrEcCst|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) rEnsurePackagesDiscoveredConfigOptionsHandlerparse package_dirConfigMetadataHandlermetadatasrc_root_referenced_filesupdate)rYrEr'ensure_discoveredoptionsmetar1r1r2rDs4  rDlabel orig_valueparsedrBc sd|vs tdkr dSt}ztd}|j|vr)tj|ddWdSWdStyW}z tfdd|DrLtj |dd}t||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.  rNr)fieldreqc3s|] }d|VqdS)rN startswith).0markerrhr1r2 z8_warn_accidental_env_marker_misconfig..) len marker_envkeysrname_AmbiguousMarkeremitranymessage)rfrgrhmarkersrkexmsgr1rpr2%_warn_accidental_env_marker_misconfigs    r~c@seZdZUdZded< iZded< d5ddZed6ddZe e d7ddZ d8ddZ ed9ddZ eddZeddZedd Zd:d#d$Zd;d&d'Zed(d)Zed*d+Zed(z+ConfigHandler.__setitem__..set_)rHrgetrMAttributeErrorKeyErrorr Exceptionr'rLr __setattr__rSappend) r option_namerXrH current_valueerh simple_settersetterr1r1r2 __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 ricSsg|] }|r|qSr1strip)rnchunkr1r1r2 Dsz-ConfigHandler._parse_list..) isinstancerB splitlinessplit)rrX separatorr1r1r2 _parse_list2s   zConfigHandler._parse_listcCsRd}i}||D]}||\}}}||krtd||||<q |S)zPRepresents value as a dict. :param value: :rtype: dict =z&Unable to parse option value to dict: )rrrr)rrXrresultlinerJsepvalr1r1r2 _parse_dictFszConfigHandler._parse_dictcCs|}|dvS)zQRepresents value as boolean. :param value: :rtype: bool )1trueyes)lowerrrXr1r1r2 _parse_boolWszConfigHandler._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}||rtddt|S)Nfile:z"Only strings are accepted for the z field, files are not accepted)rm ValueErrorrStr)rXexclude_directiverJr1r2parserms    z3ConfigHandler._exclude_files_parser..parserr1)rrJrr1rr2_exclude_files_parseras  z#ConfigHandler._exclude_files_parserroot_dirStrPath | NonecCshd}t|ts |S||st|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|]}|qSr1r)rnr;r1r1r2rz-ConfigHandler._parse_file..r) rrCrmrrrsrrarbr read_files)rrXrinclude_directivespec filepathsr1r1r2 _parse_filexs    zConfigHandler._parse_filercCs@d}||s t|S||d}||jjt|||S)zRepresents value as a module attribute. Examples: attr: package.attr attr: package.module.attr :param str value: :rtype: str zattr:) rmrrreplacerbrcr]r read_attr)rrXr]rattr_directive attr_descr1r1r2 _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|Srr1)rXrhmethod parse_methodsr1r2r\s z1ConfigHandler._get_parser_compound..parser1)rrr\r1rr2_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_parserrXrJ_rr1r1r2_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|Srr1rvrr1r2rsz6ConfigHandler._parse_section_to_dict..cSs|Srr1rr1r1r2rr)r)rrrrr1rr2_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)rrrvrrXr1r1r2 parse_sections   zConfigHandler.parse_sectioncCsl|jD].\}}d}|rd|}t|d|ddd}|dur/td|jd|d||qdS) zTParses configuration file items from one or more related sections. rrrr__Nz*Unsupported distribution option section: [])rrrMrrrT)r section_namermethod_postfixsection_parser_methodr1r1r2r\s&  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_DeprecatedConfigrx)argskwargsfunckwr}r1r2config_handlers z@ConfigHandler._deprecated_config_handler..config_handler)r)rrr}rrr1rr2_deprecated_config_handlersz(ConfigHandler._deprecated_config_handler)rHr#rdr"rcrr(r)rdr"r(rr(rr(r)r)rr)rrr)r __module__ __qualname____doc____annotations__rr classmethodrpropertyrrrrrrrrrrrrrr\rr1r1r1r2rs@                rcsTeZdZdZdddddZdZ dejfdfdd Ze dddZ ddZ Z S) r^r_url description classifiers platforms) home_pagesummary classifierplatformFNrHr rdr"r'r&rcrr] dict | Nonerrr(rcs"t||||||_||_dSr)superrr]r)rrHrdr'rcr]rrr1r2rs  zConfigMetadataHandler.__init__rcCs||jtj}||jtj}t|j|jd}|j }idtj dtj dtj dtj d|d|d|d |d |||d |d d |d |d|dtj d|j dtj d|S)rrauthor author_email maintainermaintainer_emailrkeywordsprovides obsoletesrlicense license_filesrlong_descriptionlong_description_content_typeversionr project_urls) rrrListrDictrrrrr_parse_version)rparse_list_staticparse_dict_static parse_fileexclude_files_parserr1r1r2r'sN     zConfigMetadataHandler.parsersc Cst|||j}||kr.|}zt|W|Sty-}z td|d||d}~wwt|||j |jS)zSParses `version` option value. :param value: :rtype: str zVersion loaded from z does not comply with PEP 440: N) rrrrrrrrrr])rrXrrr1r1r2rCs" z$ConfigMetadataHandler._parse_version)rHr rdr"r'r&rcrr]rrrr(rr) rrrrTr strict_moder:curdirrrrr __classcell__r1r1rr2r^ s  r^cseZdZdZd+fd d Zed dZddZd,ddZe d-ddZ ddZ ddZ ddZ d.dd Zd!d"Zd.d#d$Zd.d%d&Zd.d'd(Zd.d)d*ZZS)/r[rdrHrr"r'r&rcrr(rcs$t|||||j|_i|_dSr)rrr`rr]rrr1r2r`s zConfigOptionsHandler.__init__cCs|j|ddS)N;)r)rrr1r1r2_parse_list_semicolonksz*ConfigOptionsHandler._parse_list_semicoloncCs|j||jdS)Nr)rr)rrXr1r1r2_parse_file_in_rootosz(ConfigOptionsHandler._parse_file_in_rootrfrCrXcCs0|||}t|||tdd|DS)Ncss|] }|ds|VqdS)#Nrl)rnrr1r1r2rqxrrz@ConfigOptionsHandler._parse_requirements_list..)r r!r~rr)rrfrXrhr1r1r2_parse_requirements_listrs z-ConfigOptionsHandler._parse_requirements_listrcCsN|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)zip_safeinclude_package_datar]scriptseager_resourcesdependency_linksnamespace_packagesr$setup_requirespackages entry_points py_modulespython_requirescmdclass) rr_parse_cmdclassrrrr#r _parse_packagesr!r SpecifierSet)r parse_list parse_boolparse_cmdclassr1r1r2r{s.zConfigOptionsHandler.parserscCs|jj}t||||jSr)rcr]rr0rr)rrXr]r1r1r2r1sz$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_dirNr1) rrparse_section_packages__findrrrbrr]r find_packages)rrXfind_directives trimmed_value find_kwargsr1r1r2r2s   z$ConfigOptionsHandler._parse_packagescsN|||j}gdfdd|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"i|] \}}|vr|r||qSr1r1)rnkr valid_keysr1r2 s"zEConfigOptionsHandler.parse_section_packages__find..r>Nr)rrrr)rr section_datar=r>r1rBr2r9s  z1ConfigOptionsHandler.parse_section_packages__findcCs|||j}||d<dS)z`Parses `entry_points` configuration file section. :param dict section_options: r-N)rrrrrhr1r1r2parse_section_entry_pointss z/ConfigOptionsHandler.parse_section_entry_pointscCs|||j}t|Sr)rrrcanonic_package_data)rr package_datar1r1r2_parse_package_datas z(ConfigOptionsHandler._parse_package_datacC|||d<dS)z`Parses `package_data` configuration file section. :param dict section_options: rINrJrrr1r1r2parse_section_package_dataz/ConfigOptionsHandler.parse_section_package_datacCrK)zhParses `exclude_package_data` configuration file section. :param dict section_options: exclude_package_dataNrLrMr1r1r2"parse_section_exclude_package_datarOz7ConfigOptionsHandler.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#)rArrr1r2rrzCConfigOptionsHandler.parse_section_extras_require..extras_requireN)rrrrFr1rr2parse_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_filesrrFr1r1r2parse_section_data_filessz-ConfigOptionsHandler.parse_section_data_files) rHrrdr"r'r&rcrr(r)rfrCrXrCrr)rrrrTrrr r!r#rrr1r2r9rGrJrNrQrSrVrr1r1rr2r[]s$        r[c@s$eZdZdZdZdZeddZdS)rwzAmbiguous 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/)see_url format_args) _SEE_DOCS_format_SUMMARY_DETAILS)rrdocsr1r1r2rzs z_AmbiguousMarker.messageN)rrrr[r\rYrrzr1r1r1r2rws rwc@seZdZdZdS)rz!userguide/declarative_config.htmlN)rrrrYr1r1r1r2r sr)FF)r$rr%r&r'r&r(r))r.rr$rr(r)r1F) r.rr$rr6r7r'r&r(r8)rHrIrJrC)r0rRr(r))F)rYrrEr"r'r&r(r8)rfrCrgrCrhrB)Cr __future__rrrLr:abcr collectionsrcollections.abcrrrrtypingr r r r r rrpackaging.markersrrtpackaging.requirementsrrpackaging.versionrrrr_pathrerrorsrrwarningsrrtyping_extensionsrr*rdistutils.distr r)rCtupler!rr"r#r3r5r,rQr-rDr~rr^r[rwrr1r1r1r2s\   $              . 'S