o e6@sBdZddlZddlZddlZddlZddlmZmZmZm Z m Z m Z m Z ddl mZmZddlmZddlmZddlmZddlmZmZejZe d eZerRd nd Zd Zed dddddZejej ej!ej"ej#fZ$ej ejej!fZ%ee&Z'dedefddZ(dede efddZ)deee effddZ*GdddZ+dS)a Configuration management setup Some terminology: - name As written in config files. - value Value associated with a name - key Name combined with it's section (section.name) - variant A single word describing where the configuration key-value pair came from N)AnyDictIterableListNewTypeOptionalTuple)ConfigurationError!ConfigurationFileCouldNotBeLoaded)appdirs)WINDOWS) getLogger) ensure_direnumKindzpip.inizpip.conf)versionhelpuserglobalZsiteenvzenv-var)USERGLOBALSITEENVENV_VARnamereturncCs*|dd}|dr|dd}|S)zAMake a name consistent regardless of source (environment or file)_-z--N)lowerreplace startswith)rr#;lib/python3.10/site-packages/pip/_internal/configuration.py_normalize_name2s  r%cCs(d|vrd|d}t||ddS)N.zVKey does not contain dot separated section and key. Perhaps you wanted to use 'global.z ' instead?)r split)rZ error_messager#r#r$_disassemble_key:s r)cCstddtdD}tjtjt}tjtjdt rdndt}tjt dt}t j |t j |gt j||giS)NcSsg|] }tj|tqSr#)ospathjoinCONFIG_BASENAME).0r+r#r#r$ Esz+get_configuration_files..Zpip~z.pip)r Zsite_config_dirsr*r+r,sysprefixr- expanduserr Zuser_config_dirkindsrrr)Zglobal_config_filesZsite_config_fileZlegacy_config_fileZnew_config_filer#r#r$get_configuration_filesDs   r5cseZdZdZd7dedeeddffdd Zd8dd Zdee fd d Z de e e e ffd d Zde de fddZde de ddfddZde ddfddZd8ddZd8ddZedee e ffddZd8ddZdede defd d!Zde defd"d#Zd8d$d%Zd&e d'e e e e fdee e ffd(d)Zde e e e ffd*d+Zde e eee ffd,d-Zdedee e ffd.d/Z de e effd0d1Z!de d2eddfd3d4Z"de fd5d6Z#Z$S)9 ConfigurationaHandles management of configuration. Provides an interface to accessing and managing configuration files. This class converts provides an API that takes "section.key-name" style keys and stores the value associated with it as "key-name" under the section "section". This allows for a clean interface wherein the both the section and the key-name are preserved in an easy to manage form in the configuration files and the data stored is also nice. Nisolated load_onlyrcsjt|dur|tvrtddttt||_||_ ddt D|_ ddt D|_ g|_ dS)Nz5Got invalid value for load_only - should be one of {}z, cSsi|]}|gqSr#r#r.variantr#r#r$ rz*Configuration.__init__..cSsi|]}|iqSr#r#r9r#r#r$r;ur<)super__init__VALID_LOAD_ONLYr formatr,mapreprr7r8OVERRIDE_ORDER_parsers_config_modified_parsers)selfr7r8 __class__r#r$r>es  zConfiguration.__init__cCs||js |dSdS)z|}t|}z|j|WStyt|td|w)z#Get a value from the configuration.No such key - )r%rQKeyErrorr)r )rGrSorig_keyr#r#r$ get_values  zConfiguration.get_valuevaluecCs|t|}||js J|\}}|dur.t|\}}||s'||||||||j|j|<| ||dS)z$Modify a value in the configuration.N) r%_ensure_have_load_onlyr8rNr) has_sectionZ add_sectionsetrE_mark_as_modified)rGrSrXfnameparsersectionrr#r#r$ set_values     zConfiguration.set_valuecCs|}t|}||jsJ||j|jvrtd||\}}|durMt|\}}||r9|||s=td| |sG| || |||j|j|=dS)z#Unset a value in the configuration.rTNz4Fatal Internal error [id=1]. Please report as a bug.) r%rYr8rEr rNr)rZZ remove_optionrRZremove_sectionr\)rGrSrVr]r^r_rr#r#r$ unset_values(       zConfiguration.unset_valuec Cs||jD]D\}}td|ttj|zt|d }| |Wdn1s/wYWqt yK}z t d|d|d}~wwdS)z!Save the current in-memory state.z Writing to %swNz:An error occurred while writing to the configuration file z: ) rYrFloggerinforr*r+dirnameopenwriteOSErrorr )rGr]r^ferrorr#r#r$saves(   zConfiguration.savecCs$|jdur tdtd|jdS)Nz'Needed a specific file to be modifying.z$Will be working with %s variant only)r8r rcdebugrLr#r#r$rYs z$Configuration._ensure_have_load_onlycCs"i}tD] }||j|q|S)z3A dictionary representing the loaded configuration.)rCupdaterE)rGZretvalr:r#r#r$rQszConfiguration._dictionarycCst|}|tjddtjgkrtddS|D]+\}}|D]$}|j dur8||j kr8td||q$| ||}|j | ||fq$qdS)z,Loads configuration from configuration filesrr'zZSkipping loading configuration files due to environment's PIP_CONFIG_FILE being os.devnullNz Skipping file '%s' (variant: %s)) dictiter_config_filesr4rr*devnullrcrlrRr8 _load_filerDappend)rG config_filesr:filesr]r^r#r#r$rJs  z Configuration._load_config_filesr:r]cCsLtd||||}|D]}||}|j||||q|S)Nz'For variant '%s', will try loading '%s')rcverbose_construct_parserZsectionsrRrErm_normalized_keys)rGr:r]r^r_rRr#r#r$rq s    zConfiguration._load_filec Cs|t}tj|rs  zConfiguration.get_environ_varsccstjdd}t}tj|tjfV|j o |otj| }|r,tj |tj fVtj |tj fV|durBtj |gfVdStj gfVdS)aYields variant and configuration files associated with it. This should be treated like items of a dictionary. The order here doesn't affect what gets overridden. That is controlled by OVERRIDE_ORDER. However this does control the order they are displayed to the user. It's probably most ergononmic to display things in the same order as OVERRIDE_ORDER ZPIP_CONFIG_FILEN) r*rgetr5r4rr7r+r|rrr)rGZenv_config_filersZshould_load_user_configr#r#r$roGs zConfiguration.iter_config_filescCs |j|S)z#Get values present in a config file)rE)rGr:r#r#r$get_values_in_configgs z"Configuration.get_values_in_configcCs*|jsJ|j|j}|std|dS)Nz4Fatal Internal error [id=2]. Please report as a bug.)r8rDr )rGparsersr#r#r$rNks  z#Configuration._get_parser_to_modifyr^cCs&||f}||jvr|j|dSdSN)rFrr)rGr]r^Zfile_parser_tupler#r#r$r\ys zConfiguration._mark_as_modifiedcCs|jjd|jdS)N())rI__name__rQrLr#r#r$__repr__~szConfiguration.__repr__r)rN)%r __module__ __qualname____doc__boolrrr>rMstrrPrrrrRrWr`rarkrYpropertyrrQrJr{rqrvrKrwrrrorrNr\r __classcell__r#r#rHr$r6Ws<           r6),rrzr}r*r1typingrrrrrrrZpip._internal.exceptionsr r Zpip._internal.utilsr Zpip._internal.utils.compatr Zpip._internal.utils.loggingr Zpip._internal.utils.miscrrr{rrr-rr4rrrrrrCr?rrcr%r)r5r6r#r#r#r$s: $