File: //usr/local/lib/python3.10/dist-packages/pip/_internal/__pycache__/configuration.cpython-310.pyc
o
��h�8 � @ s" d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl m
Z
m Z ddl m
Z
mZ ddlmZ ddlmZ dd lmZ dd
lmZmZ ejZe d e�ZerTd nd
ZdZ edddddd�Z e j e j e j e j!e j"fZ#e j e j e j fZ$ee%�Z&d"dd�Z'd#dd �Z(d$d d �Z)G d d!� d!�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
� )� annotationsN)�Iterable)�Any�NewType)�ConfigurationError�!ConfigurationFileCouldNotBeLoaded)�appdirs)�WINDOWS)� getLogger)�
ensure_dir�enum�Kindzpip.inizpip.conf)�version�help�user�global�site�envzenv-var)�USER�GLOBAL�SITE�ENV�ENV_VAR�name�str�returnc C s* | � � �dd�} | �d�r| dd� } | S )zAMake a name consistent regardless of source (environment or file)�_�-z--� N)�lower�replace�
startswith)r � r" �F/usr/local/lib/python3.10/dist-packages/pip/_internal/configuration.py�_normalize_name5 s
r$ � list[str]c C s( d| vrd| � d�}t |��| �dd�S )N�.zVKey does not contain dot separated section and key. Perhaps you wanted to use 'global.z
' instead?� )r �split)r �
error_messager" r" r# �_disassemble_key= s �� r* �dict[Kind, list[str]]c C st dd� t �d�D �} tj�tjt�}tj�tj�d�t r dndt�}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>H s �z+get_configuration_files.<locals>.<listcomp>�pip�~z.pip)r �site_config_dirsr, r- r. �sys�prefixr/ �
expanduserr �user_config_dir�kindsr r r )�global_config_files�site_config_file�legacy_config_file�new_config_filer" r" r# �get_configuration_filesG s �
�
�r> c s� e Zd ZdZdEdF� fd d
�
ZdGd d �ZdHdd�ZdIdd�ZdJdd�ZdKdd�Z dLdd �Z
dGd d �Z dGd d �Z e
dMd"d#��ZdGd$d%�ZdNd*d+�ZdOd,d-�ZdGd.d/�ZdPd3d4�ZdQd6d7�ZdRd9d:�ZdSd;d<�ZdTd>d?�ZdUdAdB�ZdVdCdD�Z� ZS )W�
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.
N�isolated�bool� load_only� Kind | Noner �Nonec sj t � �� |d ur|tvrtd�d�ttt�����|| _|| _ dd� t
D �| _ dd� t
D �| _ g | _
d S )Nz5Got invalid value for load_only - should be one of {}z, c S s i | ]}|g �qS r" r" �r0 �variantr" r" r# �
<dictcomp>u � �z*Configuration.__init__.<locals>.<dictcomp>c S s i | ]}|i �qS r" r" rE r" r" r# rG x rH )�super�__init__�VALID_LOAD_ONLYr �formatr. �map�reprr@ rB �OVERRIDE_ORDER�_parsers�_config�_modified_parsers)�selfr@ rB �� __class__r" r# rJ h s
����
zConfiguration.__init__c C s | � � | js
| �� dS dS )z<Loads configuration from configuration files and environmentN)�_load_config_filesr@ �_load_environment_vars�rS r" r" r# �load} s �zConfiguration.load�
str | Nonec C s6 | j dus J d��z| �� d W S ty Y dS w )z7Returns the file with highest priority in configurationNz)Need to be specified a file to be editingr )rB �_get_parser_to_modify�
IndexErrorrX r" r" r# �get_file_to_edit� s �z Configuration.get_file_to_edit�Iterable[tuple[str, Any]]c C s
| j �� S )z`Returns key-value pairs like dict.items() representing the loaded
configuration
)� _dictionary�itemsrX r" r" r# r` � s
zConfiguration.items�keyr r c C sZ |}t |�}zi }| j�� D ]}|�|� q|| W S ty, t|� td|� ���w )z#Get a value from the configuration.�No such key - )r$ r_ �values�update�KeyErrorr* r )rS ra �orig_key� clean_config� file_valuesr" r" r# � get_value� s
�zConfiguration.get_value�valuec C s� t |�}| �� | js
J �| �� \}}|dur.t|�\}}|�|�s'|�|� |�|||� | j| j � |i � || j| j | |< | �
||� dS )z$Modify a value in the configuration.N) r$ �_ensure_have_load_onlyrB r[ r* � has_section� add_section�setrQ �
setdefault�_mark_as_modified)rS ra rj �fname�parser�sectionr r" r" r# � set_value� s
zConfiguration.set_valuec C s� |}t |�}| �� | jsJ �| �� \}}|| j| j | vr.|| j| j vr.td|� ���|durWt|�\}}|�|�rC|�||�sGtd��|� |�sQ|�
|� | � ||� z | j| j | |= W dS t yt | j| j |= Y dS w )z#Unset a value in the configuration.rb Nz4Fatal Internal error [id=1]. Please report as a bug.)
r$ rk rB r[ rQ r r* rl �
remove_optionr` �remove_sectionrp re )rS ra rf rq rr rs r r" r" r# � unset_value� s2
�
��
�zConfiguration.unset_valuec C s� | � � | jD ]D\}}t�d|� ttj�|�� z t|d��
}|� |� W d � n1 s/w Y W q t
yK } z
t d|� d|� ���d}~ww dS )z!Save the current in-memory state.z
Writing to %s�wNz:An error occurred while writing to the configuration file z: ) rk rR �logger�infor r, r- �dirname�open�write�OSErrorr )rS rq rr �f�errorr" r" r# �save� s( ��������zConfiguration.savec C s$ | j d u r td��t�d| j � d S )Nz'Needed a specific file to be modifying.z$Will be working with %s variant only)rB r ry �debugrX r" r" r# rk � s
z$Configuration._ensure_have_load_only�dict[str, dict[str, Any]]c C s" i }t D ]
}|�| j| � q|S )z3A dictionary representing the loaded configuration.)rO rd rQ )rS �retvalrF r" r" r# r_ � s zConfiguration._dictionaryc C s� t | �� �}|tj dd� tjgkrt�d� dS |�� D ]+\}}|D ]$}| j dur8|| j kr8t�d||� q$| �
||�}| j | � ||f� q$q dS )z,Loads configuration from configuration filesr r' zZSkipping loading configuration files due to environment's PIP_CONFIG_FILE being os.devnullNz Skipping file '%s' (variant: %s))
�dict�iter_config_filesr9 r r, �devnullry r� r` rB �
_load_filerP �append)rS � config_filesrF �filesrq rr r" r" r# rV s � ��z Configuration._load_config_filesrF r
rq �RawConfigParserc C sb t �d||� | �|�}|�� D ] }|�|�}| j| �|i � | j| | �| �||�� q|S )Nz'For variant '%s', will try loading '%s') ry �verbose�_construct_parser�sectionsr` rQ ro rd �_normalized_keys)rS rF rq rr rs r` r" r" r# r� s
zConfiguration._load_filec
C s| t �� }tj�|�r<t�d�}z
|j||d� W |S ty* t d|� d�|d�� t j
y; } zt |d��d }~ww |S )NF)�encodingzcontains invalid z characters)�reasonrq )r� ) � configparserr� r, r- �exists�locale�getpreferredencoding�read�UnicodeDecodeErrorr �Error)rS rq rr �locale_encodingr� r" r" r# r� " s
�
�
��z Configuration._construct_parserc C s: | j tj �di � | j tj d �| �d| �� �� dS )z.Loads configuration from environment variablesz:env:N)rQ r9 r ro rd r� �get_environ_varsrX r" r" r# rW 7 s �z$Configuration._load_environment_varsrs r` �dict[str, Any]c 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$ )rS rs r` �
normalizedr �valra r" r" r# r� > s
z Configuration._normalized_keys�Iterable[tuple[str, str]]c c sF � t j�� D ]\}}|�d�r |dd� �� }|tvr ||fV qdS )z@Returns a generator with all environmental vars with prefix PIP_�PIP_� N)r, �environr` r! r �ENV_NAMES_IGNORED)rS ra r� r r" r" r# r� L s �
��z Configuration.get_environ_vars� Iterable[tuple[Kind, list[str]]]c c s� � t j�dd�}t� }tj|tj fV | j o |o t j�|� }|r,tj |tj fV tj
|tj
fV |durBtj |gfV dS tj g fV dS )a� Yields 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 ergonomic to display
things in the same order as OVERRIDE_ORDER
�PIP_CONFIG_FILEN) r, r� �getr> r9 r r@ r- r� r r r )rS �env_config_filer� �should_load_user_configr" r" r# r� U s � �z Configuration.iter_config_filesc C s
| j | S )z#Get values present in a config file)rQ )rS rF r" r" r# �get_values_in_configu s
z"Configuration.get_values_in_config�tuple[str, RawConfigParser]c C s* | j sJ �| j| j }|std��|d S )Nz4Fatal Internal error [id=2]. Please report as a bug.���)rB rP r )rS �parsersr" r" r# r[ y s
�z#Configuration._get_parser_to_modifyrr c C s& ||f}|| j vr| j �|� d S d S �N)rR r� )rS rq rr �file_parser_tupler" r" r# rp � s
�z Configuration._mark_as_modifiedc C s | j j� d| j�d�S )N�(�))rU �__name__r_ rX r" r" r# �__repr__� s zConfiguration.__repr__r� )r@ rA rB rC r rD )r rD )r rZ )r r^ )ra r r r )ra r rj r r rD )ra r r rD )r r� )rF r
rq r r r� )rq r r r� )rs r r` r^ r r� )r r� )r r� )rF r
r r� )r r� )rq r rr r� r rD )r r )r� �
__module__� __qualname__�__doc__rJ rY r] r` ri rt rw r� rk �propertyr_ rV r� r� rW r� r� r� r� r[ rp r� �
__classcell__r" r" rT r# r? Z s0
"
r? )r r r r )r r r r% )r r+ )+r� �
__future__r r� r� r, r5 �collections.abcr �typingr r �pip._internal.exceptionsr r �pip._internal.utilsr �pip._internal.utils.compatr �pip._internal.utils.loggingr
�pip._internal.utils.miscr r r� r r
r/ r� r9 r r r r r rO rK r� ry r$ r* r> r? r" r" r" r# �<module> s>
�