a
    h8                     @  s2  d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl	m
Z
mZ ddlmZmZ ddlmZ ddlmZ dd	lmZ dd
lmZmZ ejZedeZerdndZdZeddddddZejejej ej!ej"fZ#ejejej fZ$ee%Z&dddddZ'dddddZ(ddddZ)G d d! d!Z*dS )"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Kindzpip.inizpip.conf)versionhelpuserglobalsiteenvzenv-var)USERGLOBALSITEENVENV_VARstr)namereturnc                 C  s*   |   dd} | dr&| dd } | S )zAMake a name consistent regardless of source (environment or file)_-z--   N)lowerreplace
startswith)r    r"   ^/var/www/html/llm_bihealth/app/venv/lib/python3.9/site-packages/pip/_internal/configuration.py_normalize_name5   s    
r$   z	list[str]c                 C  s(   d| vrd|  d}t || dd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)   zdict[Kind, list[str]]r   c                  C  st   dd t dD } tjtjt}tjtjdt	r<dndt}tjt 
dt}tj| tj|gtj||giS )Nc                 S  s   g | ]}t j|tqS 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 Zd ZdZdDdddd fddZdd	d
dZdd	ddZdd	ddZdddddZddddddZ	dddddZ
dd	ddZdd	ddZed d	d!d"Zdd	d#d$Zd%dd&d'd(d)Zdd&d*d+d,Zdd	d-d.Zddd/d0d1d2Zd3d	d4d5Zd6d	d7d8Zd%d/d9d:d;Zd<d	d=d>Zdd&dd?d@dAZdd	dBdCZ  ZS )E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boolzKind | NoneNone)isolated	load_onlyr   c                   sj   t    |d ur4|tvr4tddttt|| _|| _	dd t
D | _dd t
D | _g | _d S )Nz5Got invalid value for load_only - should be one of {}z, c                 S  s   i | ]
}|g qS r"   r"   r/   variantr"   r"   r#   
<dictcomp>u   s   z*Configuration.__init__.<locals>.<dictcomp>c                 S  s   i | ]
}|i qS r"   r"   rC   r"   r"   r#   rE   x   s   )super__init__VALID_LOAD_ONLYr   formatr-   mapreprrA   rB   OVERRIDE_ORDER_parsers_config_modified_parsers)selfrA   rB   	__class__r"   r#   rG   h   s     
zConfiguration.__init__r*   c                 C  s   |    | js|   dS )z<Loads configuration from configuration files and environmentN)_load_config_filesrA   _load_environment_varsrP   r"   r"   r#   load}   s    zConfiguration.loadz
str | Nonec                 C  s:   | j dusJ dz|  d W S  ty4   Y dS 0 dS )z7Returns the file with highest priority in configurationNz)Need to be specified a file to be editingr   )rB   _get_parser_to_modify
IndexErrorrU   r"   r"   r#   get_file_to_edit   s
    zConfiguration.get_file_to_editzIterable[tuple[str, Any]]c                 C  s
   | j  S )z`Returns key-value pairs like dict.items() representing the loaded
        configuration
        )_dictionaryitemsrU   r"   r"   r#   r[      s    zConfiguration.itemsr   r   )keyr   c                 C  sb   |}t |}z(i }| j D ]}|| q|| W S  ty\   t| td| Y n0 dS )z#Get a value from the configuration.No such key - N)r$   rZ   valuesupdateKeyErrorr)   r   )rP   r\   orig_keyZclean_configZfile_valuesr"   r"   r#   	get_value   s    
zConfiguration.get_value)r\   valuer   c                 C  s   t |}|   | jsJ |  \}}|dur\t|\}}||sN|| |||| | j| j 	|i  || j| j | |< | 
|| dS )z$Modify a value in the configuration.N)r$   _ensure_have_load_onlyrB   rW   r)   has_sectionadd_sectionsetrN   
setdefault_mark_as_modified)rP   r\   rc   fnameparsersectionr   r"   r"   r#   	set_value   s    


zConfiguration.set_valuec                 C  s   |}t |}|   | jsJ |  \}}|| j| j | vr\|| j| j vr\td| |durt|\}}||r|||std|	|s|
| | || z| j| j | |= W n  ty   | j| j |= Y n0 dS )z#Unset a value in the configuration.r]   Nz4Fatal Internal error [id=1]. Please report as a bug.)r$   rd   rB   rW   rN   r   r)   re   remove_optionr[   remove_sectionri   r`   )rP   r\   ra   rj   rk   rl   r   r"   r"   r#   unset_value   s4    



zConfiguration.unset_valuec                 C  s   |    | jD ]\}}td| ttj| z8t|d}|	| W d   n1 s^0    Y  W q t
y } z td| d| W Y d}~qd}~0 0 qdS )z!Save the current in-memory state.zWriting to %swNz:An error occurred while writing to the configuration file z: )rd   rO   loggerinfor   r+   r,   dirnameopenwriteOSErrorr   )rP   rj   rk   ferrorr"   r"   r#   save   s    ,zConfiguration.savec                 C  s$   | j d u rtdtd| j  d S )Nz'Needed a specific file to be modifying.z$Will be working with %s variant only)rB   r   rr   debugrU   r"   r"   r#   rd      s    
z$Configuration._ensure_have_load_onlyzdict[str, dict[str, Any]]c                 C  s"   i }t D ]}|| j|  q|S )z3A dictionary representing the loaded configuration.)rL   r_   rN   )rP   retvalrD   r"   r"   r#   rZ      s    zConfiguration._dictionaryc                 C  s   t |  }|tj dd tjgkr4td dS | D ]V\}}|D ]H}| j	durp|| j	krptd|| qH| 
||}| j| ||f qHq<dS )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_filesr8   r   r+   devnullrr   r{   r[   rB   
_load_filerM   append)rP   config_filesrD   filesrj   rk   r"   r"   r#   rS      s    z Configuration._load_config_filesr   RawConfigParser)rD   rj   r   c                 C  sb   t d|| | |}| D ]<}||}| j| |i  | j| | | || q |S )Nz'For variant '%s', will try loading '%s')	rr   verbose_construct_parsersectionsr[   rN   rh   r_   _normalized_keys)rP   rD   rj   rk   rl   r[   r"   r"   r#   r     s    

zConfiguration._load_file)rj   r   c              
   C  s   t  }tj|rtd}z|j||d W nT tyV   t	d| d|dY n0 t j
y } zt	|dW Y d }~n
d }~0 0 |S )NF)encodingzcontains invalid z characters)reasonrj   )ry   )configparserr   r+   r,   existslocalegetpreferredencodingreadUnicodeDecodeErrorr   Error)rP   rj   rk   Zlocale_encodingry   r"   r"   r#   r   "  s    


 zConfiguration._construct_parserc                 C  s:   | j tj di  | j tj d | d|   dS )z.Loads configuration from environment variablesz:env:N)rN   r8   r   rh   r_   r   get_environ_varsrU   r"   r"   r#   rT   7  s    z$Configuration._load_environment_varszdict[str, Any])rl   r[   r   c                 C  s.   i }|D ] \}}|d t | }|||< q|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$   )rP   rl   r[   
normalizedr   valr\   r"   r"   r#   r   >  s
    
zConfiguration._normalized_keyszIterable[tuple[str, str]]c                 c  sD   t j D ]4\}}|dr
|dd  }|tvr
||fV  q
dS )z@Returns a generator with all environmental vars with prefix PIP_PIP_   N)r+   environr[   r!   r   ENV_NAMES_IGNORED)rP   r\   r   r   r"   r"   r#   r   L  s
    
zConfiguration.get_environ_varsz Iterable[tuple[Kind, list[str]]]c                 c  s   t jdd}t }tj|tj fV  | j o>|o<t j| }|rVtj	|tj	 fV  tj
|tj
 fV  |durtj|gfV  ntjg fV  dS )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=   r8   r   rA   r,   r   r   r   r   )rP   Zenv_config_filer   should_load_user_configr"   r"   r#   r~   U  s    zConfiguration.iter_config_files)rD   r   c                 C  s
   | j | S )z#Get values present in a config file)rN   )rP   rD   r"   r"   r#   get_values_in_configu  s    z"Configuration.get_values_in_configztuple[str, RawConfigParser]c                 C  s*   | j s
J | j| j  }|s"td|d S )Nz4Fatal Internal error [id=2]. Please report as a bug.)rB   rM   r   )rP   parsersr"   r"   r#   rW   y  s    
z#Configuration._get_parser_to_modify)rj   rk   r   c                 C  s"   ||f}|| j vr| j | d S )N)rO   r   )rP   rj   rk   file_parser_tupler"   r"   r#   ri     s    
zConfiguration._mark_as_modifiedc                 C  s   | j j d| jdS )N())rR   __name__rZ   rU   r"   r"   r#   __repr__  s    zConfiguration.__repr__)N)r   
__module____qualname____doc__rG   rV   rY   r[   rb   rm   rp   rz   rd   propertyrZ   rS   r   r   rT   r   r   r~   r   rW   ri   r   __classcell__r"   r"   rQ   r#   r>   Z   s.   	"	 r>   )+r   
__future__r   r   r   r+   r4   collections.abcr   typingr   r   pip._internal.exceptionsr   r   Zpip._internal.utilsr   pip._internal.utils.compatr	   pip._internal.utils.loggingr
   pip._internal.utils.miscr   r   r   r   r   r.   r   r8   r   r   r   r   r   rL   rH   r   rr   r$   r)   r=   r>   r"   r"   r"   r#   <module>   s<   

