File: //usr/lib/python3.9/site-packages/pip/_internal/__pycache__/configuration.cpython-39.pyc
a
?�f#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#edddddd�Z$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 �?/usr/lib/python3.9/site-packages/pip/_internal/configuration.py�_normalize_name* s
r c C s& d| vrd� | �}t|��| �dd�S )N�.zbKey does not contain dot separated section and key. Perhaps you wanted to use 'global.{}' instead?� )�formatr �split)r Z
error_messager r r �_disassemble_key4 s ��r! �user�globalZsite�envzenv-var)�USER�GLOBAL�SITE�ENV�ENV_VARzpip.inizpip.confc C sp dd� t �d�D �} tj�tjt�}tj�td�t 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>Zpip�~z.pip)r Zsite_config_dirsr* r+ r, �sys�prefixr- r r Zuser_config_dir�kindsr& r' r% )Zglobal_config_filesZsite_config_fileZlegacy_config_fileZnew_config_filer r r �get_configuration_filesL s �
�
�
�r4 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}||vrJtd�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 �r. �variantr r r �
<dictcomp>� s z*Configuration.__init__.<locals>.<dictcomp>c S s i | ]
}|i �qS r r r9 r r r r; � s )�superr5 �__init__r3 r% r& r' r r r, �map�repr�isolated� load_onlyr( r) �_override_order�_ignore_env_names�_parsers�_config�_modified_parsers)�selfr@ rA Z_valid_load_only�� __class__r r r= q s( ���
��zConfiguration.__init__c C s | � � | js| �� dS )zELoads configuration from configuration files and environment
N)�_load_config_filesr@ �_load_environment_vars�rG r r r �load� s zConfiguration.loadc C s: | j dusJ d��z| �� d W S ty4 Y dS 0 dS )z@Returns the file with highest priority in configuration
Nz)Need to be specified a file to be editingr )rA �_get_parser_to_modify�
IndexErrorrL 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�itemsrL r r r rR � s zConfiguration.itemsc C s2 z | j | W S ty, td�|���Y n0 dS )z,Get a value from the configuration.
�No such key - {}N)rQ �KeyErrorr r )rG �keyr r r � get_value� s zConfiguration.get_valuec C st | � � | jsJ �| �� \}}|durTt|�\}}|�|�sF|�|� |�|||� || j| j |< | �||� dS )z-Modify a value in the configuration.
N) �_ensure_have_load_onlyrA rN r! � has_sectionZ add_section�setrE �_mark_as_modified)rG rU �value�fname�parser�sectionr r r r � set_value� s
zConfiguration.set_valuec C s� | � � | jsJ �|| j| j vr0td�|���| �� \}}|dur�t|�\}}|�|�rf|�||�sntd��|� |�s�|�
|� | � ||� | j| j |= dS )z#Unset a value in the configuration.rS Nz4Fatal Internal error [id=1]. Please report as a bug.) rW rA rE r r rN r! rX Z
remove_optionrR Zremove_sectionrZ )rG rU r\ r] r^ r r r r � unset_value� s"
��
zConfiguration.unset_valuec C sl | � � | jD ]X\}}t�d|� ttj�|�� t|d��}|� |� W d � q1 s\0 Y qdS )z*Save the current in-memory state.
z
Writing to %s�wN)
rW rF �logger�infor r* r+ �dirname�open�write)rG r\ r] �fr r r �save� s zConfiguration.savec C s$ | j d u rtd��t�d| j � d S )Nz'Needed a specific file to be modifying.z$Will be working with %s variant only)rA r rb �debugrL r r r rW � s
z$Configuration._ensure_have_load_onlyc C s$ i }| j D ]}|�| j| � q
|S )z<A dictionary representing the loaded configuration.
)rB �updaterE )rG Zretvalr: r r r rQ � s
zConfiguration._dictionaryc C s� t | �� �}|tj dd� tjgkr4t�d� dS |�� D ]V\}}|D ]H}| j durp|| 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_filesr3 r( r* �devnullrb ri rR rA �
_load_filerD �append)rG � config_filesr: �filesr\ r] r r r rJ s �� z Configuration._load_config_filesc C sL t �d||� | �|�}|�� D ]&}|�|�}| j| �| �||�� q |S )Nz'For variant '%s', will try loading '%s')rb ri �_construct_parserZsectionsrR rE rj �_normalized_keys)rG r: r\ r] r^ rR r r r rn $ s
zConfiguration._load_filec
C s� t �� }tj�|�r|z|�|� W nX tyL td�t �
d��|d��Y n0 t j yz } zt|d��W Y d }~n
d }~0 0 |S )Nz contains invalid {} charactersF)�reasonr\ )�error) r �RawConfigParserr* r+ �exists�read�UnicodeDecodeErrorr r �locale�getpreferredencoding�Error)rG r\ r] ru r r r rr / s ��
z Configuration._construct_parserc C s" | j tj �| �d| �� �� dS )z7Loads configuration from environment variables
z:env:N)rE r3 r) rj rs �get_environ_varsrL r r r rK 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 )rG r^ rR Z
normalizedr �valrU r r r rs N s
z Configuration._normalized_keysc c sR t j�� D ]B\}}|�d�o0|dd� �� | jv}|r
|dd� �� |fV q
dS )z@Returns a generator with all environmental vars with prefix PIP_ZPIP_� N)r* �environrR r r rC )rG rU r~ Zshould_be_yieldedr r r r} [ s
�z Configuration.get_environ_varsc c s� t j�dd�}|dur&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.
ZPIP_CONFIG_FILEN) r* r� �getr3 r( r4 r& r@ r+ rw r% r' )rG Z config_filerp Zshould_load_user_configr r r rl g s �z Configuration.iter_config_filesc C s
| j | S )z#Get values present in a config file)rE )rG r: r r r �get_values_in_config� s z"Configuration.get_values_in_configc C s* | j s
J �| j| j }|s"td��|d S )Nz4Fatal Internal error [id=2]. Please report as a bug.r6 )rA rD r )rG Zparsersr r r rN � s
�z#Configuration._get_parser_to_modifyc C s" ||f}|| j vr | j �|� d S )N)rF ro )rG r\ r] Zfile_parser_tupler r r rZ � s
z Configuration._mark_as_modifiedc C s d� | jj| j�S )Nz{}({!r}))r rI �__name__rQ rL r r r �__repr__� s zConfiguration.__repr__)N)r� �
__module__� __qualname__�__doc__r= rM rP rR rV r_ r` rh rW �propertyrQ rJ rn rr rK rs r} rl r� rN rZ r� �
__classcell__r r rH r r5 c s.
r5 ))r� rz Zloggingr* r1 Zpip._vendor.six.movesr Zpip._internal.exceptionsr r Zpip._internal.utilsr Zpip._internal.utils.compatr r Zpip._internal.utils.miscr r Zpip._internal.utils.typingr
�typingr r r
r r r r rv �strr Z getLoggerr� rb r r! r3 r- r4 �objectr5 r r r r �<module> s6
$
�