U aʹjd@s4UdZddlmZddlZddlZddlZddlmZddlmZm Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZddlmZddlmZmZdd lmZdd lmZm Z d d l!m"Z"d d l#m$Z$m%Z%d dl&m'Z'ddl(m)Z)e rddl*m+Z+ddl,m-Z-ddl.m/Z/ee0ee0e ffZ1de2d<ee0e1fZ3de2d<edddZ4dDddddddd Z5dddd!d"d#Z6dEddd%dd&d'd(d)Z7d*d+d,d-d.Z8d/dd0d1d2Z9dFdddd&d3d4d5Z:d+d+d6d7d8d9Z;Gd:d;d;ee4Zd?d?eGd@dAdAe'Z?GdBdCdCe'Z@dS)Ga< 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_CHECKINGAnyCallableDictGenericIterableIteratorListTupleTypeVarcast)default_environment)InvalidRequirement Requirement) SpecifierSet)InvalidVersionVersion)StrPath) FileError OptionError)SetuptoolsDeprecationWarning)expand) TypeAlias Distribution)DistributionMetadatarSingleCommandOptionsAllCommandOptionsTargetr r!Frbooldict)filepath find_othersignore_option_errorsreturncCs8ddlm}|}|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'r(r)r dist filenameshandlersr2Y/var/www/html/bwave/python/venv/lib/python3.8/site-packages/setuptools/config/setupcfg.pyread_configuration=s  r4)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'r2r2r3apply_configurationWs r5r2zIterable[StrPath]z2tuple[ConfigMetadataHandler, ConfigOptionsHandler])r/r' other_filesr)r*c Csddlm}tj|}tj|s4td|dt}ttj |||f}z4|j |t t t |dt||j|d}|W5t|X|S)zHRead configuration from ``filepath`` and applies to the ``dist`` object.r) _DistributionzConfiguration file z does not exist.)r0)r))r+r7ospathabspathisfilergetcwdchdirdirnameparse_config_filesrr strparse_configurationcommand_optionsZ_finalize_license_files)r/r'r6r)r7Zcurrent_directoryr0r1r2r2r3r-`s"      r-z#Distribution | DistributionMetadatar@) 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)rCrDZ getter_nameZ by_attributegetterr2r2r3 _get_options  rIzKIterable[ConfigHandler[Distribution] | ConfigHandler[DistributionMetadata]])r1r*cCs<tt}|D]*}|jD]}t|j|}|||j|<qq |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_optionsrIrCsection_prefix)r1Z config_dicthandleroptionvaluer2r2r3r.s   r.) distributionrBr)r*c Cstt|\}t||||}||js0|j|_t|j||||j|j}||j |j|jW5QRX||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 ) rZEnsurePackagesDiscoveredConfigOptionsHandlerparse package_dirConfigMetadataHandlermetadatasrc_root_referenced_filesupdate)rOrBr)ensure_discoveredoptionsmetar2r2r3rAs0 rAlist)label orig_valueparsedc sd|kstdkrdSt}z,td}|j|krLtj|ddWnTtk r}z6tfdd|Drtj |dd}t||W5d}~XYnXdS)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^r2r3 sz8_warn_accidental_env_marker_misconfig..) len marker_envkeysrname_AmbiguousMarkeremitranymessage)r\r]r^markersraexmsgr2rfr3%_warn_accidental_env_marker_misconfigs   rsc@seZdZUdZded<iZded<dddd d d Zedd d ddZe ddZ ddddZ ed3ddZ eddZ eddZeddZdd d!d"Zd#d d$d%Zed&d'Zed(d)Zed4d+d,Zd-d.Zddd/d0Zd1d2Zd*S)5 ConfigHandlerz1Handles metadata supplied in configuration files.r@rKzdict[str, str]aliasesr$r#expand.EnsurePackagesDiscovered)rCrYrXcCs4||_||_t|||_g|_||_t|_dSN) r)rCr&_section_optionssectionsrJrXsetrVselfrCrYr)rXr2r2r3__init__szConfigHandler.__init__z*Iterator[tuple[str, SingleCommandOptions]])rYr*ccs>|D]0\}}||j\}}}|r(q|d|fVqdS)N.)items partitionrKlstrip)clsrYZ full_namerNpreseprkr2r2r3rxs zConfigHandler._section_optionscCstd|jjdS).Metadata item name to parser function mapping.z!%s must provide .parsers propertyN)NotImplementedError __class____name__r|r2r2r3parserss zConfigHandler.parsersNone)r*c Cs|j}|j||}zt||}Wn,tk rN}zt||W5d}~XYnX|rXdSz|j|dd|}Wntf|jk rYdSXt |j |}t|d||}|||j |dS)NcSs|Srwr2)xr2r2r31z+ConfigHandler.__setitem__..set_)rCrugetrGAttributeErrorKeyErrorr Exceptionr)rFr __setattr__rJappend) r|Z option_namerNrC current_valueer^Z simple_settersetterr2r2r3 __setitem__!s 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 r_cSsg|]}|r|qSr2strip)rdchunkr2r2r3 Msz-ConfigHandler._parse_list..) isinstancer[ splitlinessplit)rrN separatorr2r2r3 _parse_list;s   zConfigHandler._parse_listcCsRd}i}||D]:}||\}}}||kr.parserr2)rrDrr2rr3_exclude_files_parserjs z#ConfigHandler._exclude_files_parserStrPath | Noneroot_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|] }|qSr2r)rdr9r2r2r3rsz-ConfigHandler._parse_file..r) rr@rcrhrrVrWrZ read_files)r|rNrZinclude_directivespecZ filepathsr2r2r3 _parse_files    zConfigHandler._parse_filercCs: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:)rcreplacerWrXrRrZ read_attr)r|rNrRrZattr_directiveZ attr_descr2r2r3 _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|Srwr2)rNr^method parse_methodsr2r3rQs z1ConfigHandler._get_parser_compound..parser2)rrrQr2rr3_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_parserrNrD_rr2r2r3_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|Srwr2rvrr2r3rrz6ConfigHandler._parse_section_to_dict..cSs|Srwr2rr2r2r3rrr)rrrrr2rr3_parse_section_to_dicts z$ConfigHandler._parse_section_to_dictc Cs8|D]*\}\}}tt|||<W5QRXqdS)zQParses configuration file section. :param dict section_options: N)r contextlibsuppressr)r|rrkrrNr2r2r3 parse_sections zConfigHandler.parse_sectioncCsl|jD]\\}}d}|r$d|}t|d|ddd}|dkr^td|jd|d||q dS) zTParses configuration file items from one or more related sections. rrrr~__Nz*Unsupported distribution option section: [])ryrrGrrrK)r| section_namerZmethod_postfixZsection_parser_methodr2r2r3rQs 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&ddtjdf||S)N stacklevelrz Deprecated config in `setup.cfg`) setdefault_DeprecatedConfigrm)argskwargsfunckwrrr2r3config_handler s z@ConfigHandler._deprecated_config_handler..config_handler)r)r|rrrrrr2rr3_deprecated_config_handlersz(ConfigHandler._deprecated_config_handler)r)N)r __module__ __qualname____doc____annotations__rur} classmethodrxpropertyrrrrrrrrrrrrrQrr2r2r2r3rts8            rtcs^eZdZdZdddddZdZdejfd d d d d ddfdd Ze ddZ ddZ Z S)rSrTurl description classifiers platforms)Z home_pagesummary classifierplatformFNr!r#r%rvz dict | Noner)rCrYr)rXrRrcs"t||||||_||_dSrw)superr}rRr)r|rCrYr)rXrRrrr2r3r}"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)r| parse_listZ parse_file parse_dictZexclude_files_parserr2r2r3r/s  zConfigMetadataHandler.parsersc Cs|||j}||krh|}z t|Wn8tk rb}ztd|d||W5d}~XYnX|St|||j |jS)zSParses `version` option value. :param value: :rtype: str zVersion loaded from z does not comply with PEP 440: N) rrrrrrrrrrR)r|rNrrr2r2r3rEs z$ConfigMetadataHandler._parse_version) rrrrKruZ strict_moder8curdirr}rrr __classcell__r2r2rr3rSs   rScseZdZdZdddddfdd Zed d Zd d Zd d dddZe ddZ ddZ ddZ ddZ ddZddZddZdd Zd!d"Zd#d$ZZS)%rPrYr r#r%rv)rCrYr)rXcs$t|||||j|_i|_dSrw)rr}rUrrRr{rr2r3r}bszConfigOptionsHandler.__init__cCs|j|ddS)N;)r)rrr2r2r3_parse_list_semicolonmsz*ConfigOptionsHandler._parse_list_semicoloncCs|j||jdS)Nr)rr)r|rNr2r2r3_parse_file_in_rootqsz(ConfigOptionsHandler._parse_file_in_rootr@)r\rNcCs*|||}t|||dd|DS)NcSsg|]}|ds|qS)#rb)rdrr2r2r3rzs zAConfigOptionsHandler._parse_requirements_list..)rrrs)r|r\rNr^r2r2r3_parse_requirements_listts z-ConfigOptionsHandler._parse_requirements_listcCsP|j}|j}|j}|j}||||||||dt|jd|j|j|j |t |dS)rzeThe namespace_packages parameter is deprecated, consider using implicit namespaces instead (PEP 420).install_requires)Zzip_safeZinclude_package_datarRscriptsZeager_resourcesZdependency_linksnamespace_packagesrZsetup_requirespackages entry_points py_modulesZpython_requirescmdclass) rrr_parse_cmdclassrrrr_parse_packagesrr)r|rZ parse_boolrZparse_cmdclassr2r2r3r|s2zConfigOptionsHandler.parserscCs|jj}t||||jSrw)rXrRrrrr)r|rNrRr2r2r3rsz$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) rrparse_section_packages__findryrrWrrRrZ find_packages)r|rNZfind_directivesZ trimmed_value find_kwargsr2r2r3rs   z$ConfigOptionsHandler._parse_packagescsP|||j}dddgfdd|D}|d}|dk rL|d|d<|S)zParses `packages.find` configuration file section. To be used in conjunction with _parse_packages(). :param dict section_options: whereincludeexcludecs"i|]\}}|kr|r||qSr2r2)rdkrZ valid_keysr2r3 s zEConfigOptionsHandler.parse_section_packages__find..Nr)rrrr)r|rZ section_datarrr2rr3rs   z1ConfigOptionsHandler.parse_section_packages__findcCs|||j}||d<dS)z`Parses `entry_points` configuration file section. :param dict section_options: rN)rrr|rr^r2r2r3parse_section_entry_pointssz/ConfigOptionsHandler.parse_section_entry_pointscCs|||j}t|Srw)rrrZcanonic_package_data)r|r package_datar2r2r3_parse_package_datasz(ConfigOptionsHandler._parse_package_datacCs|||d<dS)z`Parses `package_data` configuration file section. :param dict section_options: r Nr r|rr2r2r3parse_section_package_datasz/ConfigOptionsHandler.parse_section_package_datacCs|||d<dS)zhParses `exclude_package_data` configuration file section. :param dict section_options: Zexclude_package_dataNrrr2r2r3"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)rrrr2r3rrzCConfigOptionsHandler.parse_section_extras_require..Zextras_requireNrr r2rr3parse_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_filesrr r2r2r3parse_section_data_filessz-ConfigOptionsHandler.parse_section_data_files)rrrrKr}rrrrrrrrrr r rrrrrr2r2rr3rP_s"    rPc@s$eZdZdZdZdZeddZdS)rlzAmbiguous 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)rrdocsr2r2r3ros z_AmbiguousMarker.messageN)rrrrrrrror2r2r2r3rls rlc@seZdZdZdS)rz!userguide/declarative_config.htmlN)rrrrr2r2r2r3rsr)FF)r2F)F)Ar __future__rrrFr8 collectionsrrrtypingrrrr r r r r rrrZpackaging.markersrriZpackaging.requirementsrrZpackaging.specifiersrZpackaging.versionrr_pathrerrorsrrwarningsrrrtyping_extensionsrr+r distutils.distr!r@r"rr#r$r4r5r-rIr.rArsrtrSrPrlrr2r2r2r3sT  4           . %M