U
|
H=®d#7 ã @ s d Z ddlZddlZddlZddlZddlmZ ddlmZm Z ddl
|
m Z ddl m Z mZ ddlmZmZ ddlmZ er°dd lmZmZmZmZmZmZmZ ej Z ed
|
e Z e e ¡Z!d d Z"d d Z#eddddddZ$e rädndZ%dd Z&G dd de'Z(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)Ú configparser)ÚConfigurationErrorÚ!ConfigurationFileCouldNotBeLoaded)Úappdirs)ÚWINDOWSÚ
|
expanduser)Ú
|
ensure_dirÚenum)ÚMYPY_CHECK_RUNNING)ÚAnyÚDictÚIterableÚListÚNewTypeÚOptionalÚTupleÚKindc C s* | ¡ dd¡} | d¡r&| dd
} | S )zFMake a name consistent regardless of source (environment or file)
|
Ú_ú-z--é N)ÚlowerÚreplaceÚ
|
startswith)Úname© r úRD:\z\workplace\VsCode\pyvenv\venv\Lib\site-packages\pip/_internal/configuration.pyÚ_normalize_name* s
|
r c C s& d| krd | ¡}t|| dd¡S )NÚ.zbKey does not contain dot separated section and key. Perhaps you wanted to use 'global.{}' instead?é )Úformatr Úsplit)r Ú error_messager r r Ú_disassemble_key4 s ÿýr" ÚuserÚglobalÚsiteÚenvzenv-var)ÚUSERÚGLOBALÚSITEÚENVÚENV_VARzpip.inizpip.confc C sp dd t d¡D } tj tjt¡}tj tdt r8dndt¡}tj t
|
d¡t¡}t j | t j |gt j||giS )Nc S s g | ]}t j |t¡qS r )ÚosÚpathÚjoinÚCONFIG_BASENAME)Ú.0r- r r r Ú
|
<listcomp>N s ÿz+get_configuration_files.<locals>.<listcomp>Úpipú~z.pip)r Úsite_config_dirsr, r- r. ÚsysÚprefixr/ r r Úuser_config_dirÚkindsr( r) r' )Úglobal_config_filesÚsite_config_fileÚlegacy_config_fileÚnew_config_filer r r Úget_configuration_filesL s( þ
|
ý ÿ ýr= c sÆ e Zd ZdZd- fdd Zdd Zdd Zd d
|
Zd d Zd d Z dd Z
|
dd Z dd Z e dd Zdd Zdd Zdd Zd d Zd d Zd!d" Zd#d$ Zd%d& Zd'd( Zd)d* Zd+d, Z ZS ).Ú Configurationaâ Handles 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.
|
Nc
|
s¨ t t| ¡ tjtjtjd g}||krJtd d t
|
t |d d
¡¡|| _ || _ tjtjtjtjtjg| _ddg| _dd | jD | _dd | jD | _g | _d S ) Nz5Got invalid value for load_only - should be one of {}z, éÿÿÿÿÚversionÚhelpc S s i | ]
|
}|g qS r r ©r0 Úvariantr r r Ú
|
<dictcomp> s z*Configuration.__init__.<locals>.<dictcomp>c S s i | ]
|
}|i qS r r rB r r r rD s )Úsuperr> Ú__init__r8 r' r( r) r r r. ÚmapÚreprÚisolatedÚ load_onlyr* r+ Ú_override_orderÚ_ignore_env_namesÚ_parsersÚ_configÚ_modified_parsers)ÚselfrI rJ Ú_valid_load_only©Ú __class__r r rF q s0 ÿÿ ÿ
|
ÿÿzConfiguration.__init__c C s | ¡ | js| ¡ dS )zELoads configuration from configuration files and environment
|
N)Ú_load_config_filesrI Ú_load_environment_vars©rP r r r Úload s zConfiguration.loadc C s< | j dk stdz| ¡ d W S tk
|
r6 Y dS X dS )z@Returns the file with highest priority in configuration
|
Nz)Need to be specified a file to be editingr )rJ ÚAssertionErrorÚ_get_parser_to_modifyÚ
|
IndexErrorrV r r r Úget_file_to_edit s ÿz Configuration.get_file_to_editc C s
|
| j ¡ S )z`Returns key-value pairs like dict.items() representing the loaded
|
configuration
|
)Ú _dictionaryÚitemsrV r r r r] £ s zConfiguration.itemsc C s4 z | j | W S tk
|
r. td |¡Y nX dS )z,Get a value from the configuration.
|
úNo such key - {}N)r\ ÚKeyErrorr r )rP Úkeyr r r Ú get_valueª s zConfiguration.get_valuec C st | ¡ | jst| ¡ \}}|dk rTt|\}}| |¡sF| |¡ | |||¡ || j| j |< | ||¡ dS )z-Modify a value in the configuration.
|
N)
|
Ú_ensure_have_load_onlyrJ rX rY r" Ú has_sectionÚ add_sectionÚsetrN Ú_mark_as_modified)rP r` ÚvalueÚfnameÚparserÚsectionr r r r Ú set_value³ s
|
|
|
zConfiguration.set_valuec C s | ¡ | jst|| j| j kr0td |¡| ¡ \}}|dk rt|\}}| |¡rf| ||¡sntd|
|
|¡s| |¡ | ||¡ | j| j |= dS )z#Unset a value in the configuration.r^ Nz4Fatal Internal error [id=1]. Please report as a bug.) rb rJ rX rN r r rY r" rc Ú remove_optionr] Úremove_sectionrf )rP r` rh ri rj r r r r Ú unset_valueÇ s"
|
|
|
ÿÿ
|
|
zConfiguration.unset_valuec
|
C sX | ¡ | jD ]D\}}t d|¡ ttj |¡ t|d}| |¡ W 5 Q R X qdS )z*Save the current in-memory state.
|
z Writing to %sÚwN)
|
rb rO ÚloggerÚinfor r, r- ÚdirnameÚopenÚwrite)rP rh ri Úfr r r Úsaveâ s zConfiguration.savec C s$ | j d krtdt d| j ¡ d S )Nz'Needed a specific file to be modifying.z$Will be working with %s variant only)rJ r rp ÚdebugrV r r r rb õ s
|
z$Configuration._ensure_have_load_onlyc C s$ i }| j D ]}| | j| ¡ q
|
|S )z<A dictionary representing the loaded configuration.
|
)rK ÚupdaterN )rP ÚretvalrC r r r r\ û s
|
zConfiguration._dictionaryc C s t | ¡ }|tj dd
tjgkr4t d¡ dS | ¡ D ]V\}}|D ]H}| j dk rp|| j krpt d||¡ qH|
|
||¡}| j | ||f¡ qHq<dS )z5Loads configuration from configuration files
|
r r zZSkipping loading configuration files due to environment's PIP_CONFIG_FILE being os.devnullNz Skipping file '%s' (variant: %s)) ÚdictÚiter_config_filesr8 r* r, Údevnullrp rw r] rJ Ú
|
_load_filerM Úappend)rP Ú config_filesrC Úfilesrh ri r r r rT s" ÿ ÿ z Configuration._load_config_filesc C sL t d||¡ | |¡}| ¡ D ]&}| |¡}| j| | ||¡¡ q |S )Nz'For variant '%s', will try loading '%s')rp rw Ú_construct_parserÚsectionsr] rN rx Ú_normalized_keys)rP rC rh ri rj r] r r r r} $ s
|
|
zConfiguration._load_filec
|
C s t ¡ }tj |¡r|z| |¡ W nX tk
|
rN td t
|
d¡¡|dY n. t j k
|
rz } zt|dW 5 d }~X Y nX |S )Nz contains invalid {} charactersF)Úreasonrh )Úerror) r ÚRawConfigParserr, r- ÚexistsÚreadÚUnicodeDecodeErrorr r ÚlocaleÚgetpreferredencodingÚError)rP rh ri r
r r r r / s ÿü
|
z Configuration._construct_parserc C s" | j tj | d| ¡ ¡¡ dS )z7Loads configuration from environment variables
|
z:env:N)rN r8 r+ rx r Úget_environ_varsrV r r r rU F s ÿz$Configuration._load_environment_varsc C s. i }|D ] \}}|d t | }|||< q|S )z×Normalizes 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 )rP rj r] Ú
|
normalizedr Úvalr` r r r r N s
|
|
z Configuration._normalized_keysc c sR t j ¡ D ]B\}}| d¡o0|dd
¡ | jk}|r
|
|dd
¡ |fV q
|
dS )z@Returns a generator with all environmental vars with prefix PIP_ÚPIP_é N)r, Úenvironr] r r rL )rP r` r Úshould_be_yieldedr r r r [ s
|
þz Configuration.get_environ_varsc c s t j dd¡}|dk r&tj|gfV n tjg fV t }tj|tj fV | j ob|o`t j |¡ }|rztj
|
|tj
|
fV tj |tj fV dS )zYields variant and configuration files associated with it.
|
|
This should be treated like items of a dictionary.
|
ÚPIP_CONFIG_FILEN) r, r Úgetr8 r* r= r( rI r- r r' r) )rP Ú config_filer Úshould_load_user_configr r r r{ g s ÿz Configuration.iter_config_filesc C s
|
| j | S )z#Get values present in a config file)rN )rP rC r r r Úget_values_in_config s z"Configuration.get_values_in_configc C s* | j s
|
t| j| j }|s"td|d S )Nz4Fatal Internal error [id=2]. Please report as a bug.r? )rJ rX rM r )rP Úparsersr r r rY s
|
ÿz#Configuration._get_parser_to_modifyc C s" ||f}|| j kr | j |¡ d S )N)rO r~ )rP rh ri Úfile_parser_tupler r r rf s
|
z Configuration._mark_as_modifiedc C s d | jj| j¡S )Nz{}({!r}))r rS Ú__name__r\ rV r r r Ú__repr__ s zConfiguration.__repr__)N)r Ú
|
__module__Ú __qualname__Ú__doc__rF rW r[ r] ra rk rn rv rb Úpropertyr\ rT r} r rU r r r{ r rY rf r Ú __classcell__r r rR r r> c s.
|
r> ))r r Úloggingr, r5 Úpip._vendor.six.movesr Úpip._internal.exceptionsr r Zpip._internal.utilsr Úpip._internal.utils.compatr r Úpip._internal.utils.miscr r Úpip._internal.utils.typingr
|
Útypingr r r r r r r r Ústrr Ú getLoggerr rp r r" r8 r/ r= Úobjectr> r r r r Ú<module> s6 $
|
|
|
û
|
