o zqfd @sFdZddlZddlZddlZddlmZddlmZddlmZddlm Z m Z m Z m Z m Z mZmZmZmZmZmZmZddlmZdd lmZmZdd lmZdd lmZmZdd l m!Z!dd l"m#Z#m$Z$ddl%m&Z&ddl'm(Z(e rddl)m*Z*ddl+m,Z,e dede ffZ- e de-fZ.ededdZ/ dBdede0fddZ1dddeddfddZ2 dCddded!eed"e3ded#f d$d%Z4d&e/d'e5fd(d)Z6d*ed#de0fd+d,Z7 dDd-dd.e.ded/fd0d1Z8d2e5d3e5d4e9fd5d6Z:Gd7d8d8e e/Z;Gd9d:d:e;d;Zd?d?e&Z>Gd@dAdAe&Z?dS)Ea< 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``. N) defaultdict)partialwraps) TYPE_CHECKINGCallableAnyDictGenericIterableListOptionalSetTupleTypeVarUnion)StrPath) FileError OptionError)default_environment)InvalidRequirement Requirement) SpecifierSet)InvalidVersionVersion)SetuptoolsDeprecationWarning)expand)DistributionMetadata DistributionstrTarget)r!r)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.distr!find_config_files_applyconfiguration_to_dict)r% find_othersignore_option_errorsr!dist filenameshandlersr0Y/root/parts/websockify/install/lib/python3.10/site-packages/setuptools/config/setupcfg.pyread_configuration9s r2r-r!cCst||||S)z`Apply the configuration from a ``setup.cfg`` file into an existing distribution object. )r)_finalize_requires)r-r%r0r0r1apply_configurationSs r4r0 other_filesr,) ConfigHandler.c Csddlm}tj|}tj|std|dt}ttj |g||}z|j ||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'r7ospathabspathisfilergetcwdchdirdirnameparse_config_filesparse_configurationcommand_options_finalize_license_files)r-r%r5r,r7current_directoryr.r/r0r0r1r)\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)rDrE getter_name by_attributegetterr0r0r1 _get_optionzs  rLr/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_optionsrLrDsection_prefix)r/ config_dicthandleroptionvaluer0r0r1r*s  r* distributionrA)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) rEnsurePackagesDiscoveredrVparse package_dirrUmetadatasrc_root_referenced_filesupdate)rTrAr,ensure_discoveredoptionsmetar0r0r1r@s4  r@label orig_valueparsedc 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).0markerrcr0r1 sz8_warn_accidental_env_marker_misconfig..) len marker_envkeysrname_AmbiguousMarkeremitranymessage)rarbrcmarkersrfexmsgr0rkr1%_warn_accidental_env_marker_misconfigs    rxc@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'd(Zd)d*Zd!S).r6z1Handles metadata supplied in configuration files.rOaliasesrDr_r^cCs4||_||_t|||_g|_||_t|_dSN) r,rDrM_section_optionssectionsrNr^setr\selfrDr_r,r^r0r0r1__init__szConfigHandler.__init__ccs@|D]\}}||j\}}}|rq|d|fVqdS)N.)items partitionrOlstrip)clsr_ full_namerSpreseprpr0r0r1r{szConfigHandler._section_optionscCstd|jj).Metadata item name to parser function mapping.z!%s must provide .parsers property)NotImplementedError __class____name__rr0r0r1parserss zConfigHandler.parsersc Cs|j}|j||}zt||}Wnty"}zt||d}~ww|r'dSz |j|dd|}Wntf|jyBYdSwt |j |}t|d||}|||j |dS)NcSs|Srzr0)xr0r0r1&z+ConfigHandler.__setitem__..zset_%s)rDrygetrHAttributeErrorKeyErrorr Exceptionr,rGr __setattr__rNappend) r option_namerSrD current_valueerc simple_settersetterr0r0r1 __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 rdcSsg|] }|r|qSr0strip)richunkr0r0r1 Bsz-ConfigHandler._parse_list..) isinstancelist splitlinessplit)rrS separatorr0r0r1 _parse_list0s   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)rrSrresultlinerErvalr0r0r1 _parse_dictDszConfigHandler._parse_dictcCs|}|dvS)zQRepresents value as boolean. :param value: :rtype: bool )1trueyes)lowerrrSr0r0r1 _parse_boolUszConfigHandler._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)rh ValueErrorformat)rSexclude_directiverEr0r1parserks z3ConfigHandler._exclude_files_parser..parserr0)rrErr0rr1_exclude_files_parser_s  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|]}|qSr0r)rir9r0r0r1rz-ConfigHandler._parse_file..r) rr"rhrmrr\r]r read_files)rrSrinclude_directivespec filepathsr0r0r1 _parse_filevs    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:)rhreplacer]r^rYr read_attr)rrSrYrattr_directive attr_descr0r0r1 _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|Srzr0)rSrcmethod parse_methodsr0r1rXs z1ConfigHandler._get_parser_compound..parser0)rrrXr0rr1_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_parserrSrE_rr0r0r1_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|Srzr0rvrr0r1rsz6ConfigHandler._parse_section_to_dict..cSs|Srzr0rr0r0r1rrr)rrrrr0rr1_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)rrrprrSr0r0r1 parse_sections   zConfigHandler.parse_sectionr&cCsh|jD],\}}d}|rd|}t|d|ddd}|dur-td|jd|d||qdS) zTParses configuration file items from one or more related sections. rz_%szparse_section%sr__Nz*Unsupported distribution option section: [])r|rrHrrrO)r section_namermethod_postfixsection_parser_methodr0r0r1rXs& 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_DeprecatedConfigrr)argskwargsfunckwrwr0r1config_handlers z@ConfigHandler._deprecated_config_handler..config_handlerr)rrrwrrr0rr1_deprecated_config_handlersz(ConfigHandler._deprecated_config_handler)rrz)r&N)r __module__ __qualname____doc__r"__annotations__ryr r#AllCommandOptionsrrWr classmethodr{propertyrrrrrrrrrrrrrrXrr0r0r0r1r6sJ           r6c speZdZdZdddddZdZ dejfd d d ed e d e j de e def fdd ZeddZddZZS)rUrZurl description classifiers platforms) home_pagesummary classifierplatformFNrDrr_r,r^rYrcs"t||||||_||_dSrz)superrrYr)rrDr_r,r^rYrrr0r1rs  zConfigMetadataHandler.__init__c CsL|j}t|j|jd}|j}|j}||||||||d||||j|d S)rrlicense) rkeywordsprovides obsoletesrr license_filesrlong_descriptionversion project_urls)rrrrrrr_parse_version)r parse_list parse_file parse_dictexclude_files_parserr0r0r1r$s  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) rrrrrrrrrrY)rrSrrr0r0r1r:s" z$ConfigMetadataHandler._parse_version)rrrrOry strict_moder8curdirrboolrrWr rMrrrrr __classcell__r0r0rr1rUs6  rUrcseZdZdZdddededejffdd Ze dd Z d d Z d e d e fddZ eddZddZddZddZddZddZddZddZd d!Zd"d#ZZS)$rVr_rDr!r,r^cs$t|||||j|_i|_dSrz)rrr[rrYr~rr0r1rWs zConfigOptionsHandler.__init__cCs|j|ddS)N;)r)rrr0r0r1_parse_list_semicolonbsz*ConfigOptionsHandler._parse_list_semicoloncCs|j||jdS)Nr)rr)rrSr0r0r1_parse_file_in_rootfsz(ConfigOptionsHandler._parse_file_in_rootrarScCs*|||}t|||dd|DS)NcSsg|] }|ds|qS)#rg)rirr0r0r1roszAConfigOptionsHandler._parse_requirements_list..)r r rx)rrarSrcr0r0r1_parse_requirements_listis 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)zip_safeinclude_package_datarYscriptseager_resourcesdependency_linksnamespace_packagesrsetup_requires tests_requirepackages entry_points py_modulespython_requirescmdclass) rrr_parse_cmdclassrrrr _parse_packagesr r)rr parse_boolrparse_cmdclassr0r0r1rqs2zConfigOptionsHandler.parserscCs|jj}t||||jSrz)r^rYrrrr)rrSrYr0r0r1rsz$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_dirNr0) rrparse_section_packages__findr|rr]rrYr find_packages)rrSfind_directives trimmed_value find_kwargsr0r0r1rs   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||fqSr0r0)rikr valid_keysr0r1rszEConfigOptionsHandler.parse_section_packages__find..r)Nr)rrrMrr)rr section_datar(r)r0r-r1r$s   z1ConfigOptionsHandler.parse_section_packages__findcCs|||j}||d<dS)z`Parses `entry_points` configuration file section. :param dict section_options: rN)rrrrrcr0r0r1parse_section_entry_pointss z/ConfigOptionsHandler.parse_section_entry_pointscCs|||j}t|Srz)rrrcanonic_package_data)rr package_datar0r0r1_parse_package_datas z(ConfigOptionsHandler._parse_package_datacC|||d<dS)z`Parses `package_data` configuration file section. :param dict section_options: r3Nr4rrr0r0r1parse_section_package_dataz/ConfigOptionsHandler.parse_section_package_datacCr5)zhParses `exclude_package_data` configuration file section. :param dict section_options: exclude_package_dataNr6r7r0r0r1"parse_section_exclude_package_datar9z7ConfigOptionsHandler.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)r,rrr0r1rrzCConfigOptionsHandler.parse_section_extras_require..extras_requireNrr0r0rr1parse_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_filesrr0r0r0r1parse_section_data_filessz-ConfigOptionsHandler.parse_section_data_files)rrrrOrr rrWrrr r r"rrrrrr$r1r4r8r;r=r@r r0r0rr1rVTs4    rVc@s$eZdZdZdZdZeddZdS)rqzAmbiguous 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)rrdocsr0r0r1rts z_AmbiguousMarker.messageN)rrrrErFrCrrtr0r0r0r1rqs rqc@seZdZdZdS)rz!userguide/declarative_config.htmlN)rrrrCr0r0r0r1rsr)FF)r0F)F)@rrrGr8 collectionsrrrtypingrrrr r r r r rrrr_pathrerrorsrrextern.packaging.markersrrnextern.packaging.requirementsrrextern.packaging.specifiersrextern.packaging.versionrrwarningsrrrdistutils.distrr'r!SingleCommandOptionsrr#rMr2r4r r)r"rLr*r@rrxr6rUrVrqrr0r0r0r1s|    8             . #M