B `5@sdZddlZddlZddlZddlZddlZddlmZmZm Z m Z m Z m Z m Z ddlmZmZddlmZddlmZddlmZmZejZe deZerd nd Zd Zed d ddddZejejej ej!ej"fZ#ejejej fZ$e%e&Z'ddZ(ddZ)ddZ*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) ensure_direnumKindzpip.inizpip.conf)versionhelpuserglobalsiteenvzenv-var)USERGLOBALSITEENVENV_VARcCs*|dd}|dr&|dd}|S)zFMake a name consistent regardless of source (environment or file) _-z--N)lowerreplace startswith)namer"Jsz+get_configuration_files..pip~z.pip)r site_config_dirsr+r,r-sysprefixr. expanduserr user_config_dirkindsrrr)Zglobal_config_filesZsite_config_filelegacy_config_filenew_config_filer"r"r#get_configuration_filesGs  r;cseZdZdZd-fdd ZddZddZd d Zd d Zd dZ ddZ ddZ ddZ e ddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,ZZS). 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. Ncsjt|dk r4|tkr4tddttt||_||_ ddt D|_ ddt D|_ g|_ dS)Nz5Got invalid value for load_only - should be one of {}z, cSsi|] }g|qSr"r")r/variantr"r"r# zsz*Configuration.__init__..cSsi|] }i|qSr"r")r/r=r"r"r#r>}s)super__init__VALID_LOAD_ONLYr r'r-mapreprisolated load_onlyOVERRIDE_ORDER_parsers_config_modified_parsers)selfrDrE) __class__r"r#r@ls   zConfiguration.__init__cCs||js|dS)zELoads configuration from configuration files and environment N)_load_config_filesrD_load_environment_vars)rJr"r"r#loadszConfiguration.loadcCs8|jdk stdy |dStk r2dSXdS)z@Returns the file with highest priority in configuration Nz)Need to be specified a file to be editingr)rEAssertionError_get_parser_to_modify IndexError)rJr"r"r#get_file_to_edits   zConfiguration.get_file_to_editcCs |jS)z`Returns key-value pairs like dict.items() representing the loaded configuration ) _dictionaryitems)rJr"r"r#rTszConfiguration.itemscCs2y |j|Stk r,td|YnXdS)z,Get a value from the configuration. zNo such key - N)rSKeyErrorr )rJkeyr"r"r# get_values zConfiguration.get_valuecCst||jst|\}}|dk rTt|\}}||sF||||||||j|j|<| ||dS)z-Modify a value in the configuration. N) _ensure_have_load_onlyrErOrPr* has_section add_sectionsetrH_mark_as_modified)rJrVvaluefnameparsersectionr!r"r"r# set_values     zConfiguration.set_valuecCs||jst||j|jkr0td||\}}|dk rt|\}}||rf|||sntd| |s| || |||j|j|=dS)z#Unset a value in the configuration.zNo such key - Nz4Fatal Internal error [id=1]. Please report as a bug.) rXrErOrHr rPr*rY remove_optionrTremove_sectionr\)rJrVr^r_r`r!r"r"r# unset_values        zConfiguration.unset_valuec Cs\|xN|jD]D\}}td|ttj|t|d}| |WdQRXqWdS)z*Save the current in-memory state. z Writing to %swN) rXrIloggerinfor r+r,dirnameopenwrite)rJr^r_fr"r"r#saves   zConfiguration.savecCs$|jdkrtdtd|jdS)Nz'Needed a specific file to be modifying.z$Will be working with %s variant only)rEr rfdebug)rJr"r"r#rXs z$Configuration._ensure_have_load_onlycCs&i}xtD]}||j|q W|S)zWdS)z5Loads configuration from configuration files rr&zZSkipping loading configuration files due to environment's PIP_CONFIG_FILE being os.devnullNz Skipping file '%s' (variant: %s)) dictiter_config_filesr8rr+devnullrfrmrTrE _load_filerGappend)rJ config_filesr=filesr^r_r"r"r#rLs    z Configuration._load_config_filescCsPtd||||}x2|D]&}||}|j||||q"W|S)Nz'For variant '%s', will try loading '%s')rfrm_construct_parsersectionsrTrHrn_normalized_keys)rJr=r^r_r`rTr"r"r#rss   zConfiguration._load_filec Cst}tj|r|y||WnXtk rNtdt d|dYn.tj k rz}zt|dWdd}~XYnX|S)Nzcontains invalid {} charactersF)reasonr^)error) configparserRawConfigParserr+r,existsreadUnicodeDecodeErrorr r'localegetpreferredencodingError)rJr^r_r{r"r"r#rw"s   zConfiguration._construct_parsercCs"|jtj|d|dS)z7Loads configuration from environment variables z:env:N)rHr8rrnryget_environ_vars)rJr"r"r#rM9s z$Configuration._load_environment_varscCs2i}x(|D] \}}|dt|}|||<q W|S)zNormalizes items to construct a dictionary with normalized keys. This routine is where the names become keys and are made the same regardless of source - configuration files or environment. r%)r$)rJr`rT normalizedr!valrVr"r"r#ryAs  zConfiguration._normalized_keysccsHxBtjD]4\}}|dr |dd}|tkr ||fVq WdS)z@Returns a generator with all environmental vars with prefix PIP_PIP_N)r+environrTr rENV_NAMES_IGNORED)rJrVrr!r"r"r#rNs  zConfiguration.get_environ_varsccstjdd}|dk r&tj|gfVn tjgfVt}tj|tjfV|j ob|o`tj | }|rztj |tj fVtj |tj fVdS)zYields variant and configuration files associated with it. This should be treated like items of a dictionary. PIP_CONFIG_FILEN) r+rgetr8rr;rrDr,r~rr)rJ config_filerushould_load_user_configr"r"r#rqXs  zConfiguration.iter_config_filescCs |j|S)z#Get values present in a config file)rH)rJr=r"r"r#get_values_in_configwsz"Configuration.get_values_in_configcCs*|js t|j|j}|s"td|dS)Nz4Fatal Internal error [id=2]. Please report as a bug.)rErOrGr )rJparsersr"r"r#rP|s   z#Configuration._get_parser_to_modifycCs"||f}||jkr|j|dS)N)rIrt)rJr^r_file_parser_tupler"r"r#r\s zConfiguration._mark_as_modifiedcCs|jjd|jdS)N())rK__name__rS)rJr"r"r#__repr__szConfiguration.__repr__)N)r __module__ __qualname____doc__r@rNrRrTrWrardrlrXpropertyrSrLrsrwrMryrrqrrPr\r __classcell__r"r")rKr#r<^s,       r<),rr|rloggingr+r4typingrrrrrrrpip._internal.exceptionsr r pip._internal.utilsr pip._internal.utils.compatr pip._internal.utils.miscr rr}strrr.rr8rrrrrrFrA getLoggerrrfr$r*r;r<r"r"r"r# s6$