o
    f}”ea3  ã                   @   sB  d Z ddlZddlZddlZddlZddlmZmZmZm	Z	m
Z
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rRd
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edefdd„Z(dede	e fdd„Z)deee	e f f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
é    N)ÚAnyÚDictÚIterableÚListÚNewTypeÚOptionalÚTuple)ÚConfigurationErrorÚ!ConfigurationFileCouldNotBeLoaded)Úappdirs)ÚWINDOWS)Ú	getLogger)Ú
ensure_dirÚenumÚKindzpip.inizpip.conf)ÚversionÚhelpÚuserÚglobalZsiteÚenvzenv-var)ÚUSERÚGLOBALÚSITEÚENVÚENV_VARÚ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#   úd/Users/abhinavbhinder/Documents/map/venv/lib/python3.10/site-packages/pip/_internal/configuration.pyÚ_normalize_name2   s   
r%   c                 C   s&   d| vrd  | ¡}t|ƒ‚|  dd¡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_key:   s   ý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>E   s    ÿz+get_configuration_files.<locals>.<listcomp>Úpipú~z.pip)r   Zsite_config_dirsr+   r,   r-   ÚsysÚprefixr.   Ú
expanduserr   Zuser_config_dirÚkindsr   r   r   )Zglobal_config_filesZsite_config_fileZlegacy_config_fileZnew_config_filer#   r#   r$   Úget_configuration_filesD   s   ÿ

ý
ýr7   c                       sÄ  e Zd ZdZd7dedee ddf‡ fdd„Zd8dd	„Zdee	 fd
d„Z
deee	ef  fdd„Zde	defdd„Zde	deddfdd„Zde	ddfdd„Zd8dd„Zd8dd„Zedee	ef fdd„ƒZd8dd„Zdede	defd d!„Zde	defd"d#„Zd8d$d%„Zd&e	d'eee	ef  dee	ef fd(d)„Zdeee	e	f  fd*d+„Zdeeeee	 f  fd,d-„Zdedee	ef fd.d/„Z dee	ef fd0d1„Z!de	d2eddfd3d4„Z"de	fd5d6„Z#‡  Z$S )9Ú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Ú	load_onlyr   c                    sj   t ƒ  ¡  |d ur|tvrt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>r   ó    ÿz*Configuration.__init__.<locals>.<dictcomp>c                 S   s   i | ]}|i “qS r#   r#   r;   r#   r#   r$   r=   u   r>   )ÚsuperÚ__init__ÚVALID_LOAD_ONLYr	   r(   r-   ÚmapÚreprr9   r:   ÚOVERRIDE_ORDERÚ_parsersÚ_configÚ_modified_parsers)Úselfr9   r:   ©Ú	__class__r#   r$   r@   e   s    
ÿÿÿÿ
zConfiguration.__init__c                 C   s   |   ¡  | js|  ¡  dS dS )z<Loads configuration from configuration files and environmentN)Ú_load_config_filesr9   Ú_load_environment_vars©rH   r#   r#   r$   Úloadz   s   ÿzConfiguration.loadc                 C   s6   | j dus	J dƒ‚z|  ¡ d W S  ty   Y dS w )z7Returns the file with highest priority in configurationNz)Need to be specified a file to be editingr   )r:   Ú_get_parser_to_modifyÚ
IndexErrorrM   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ÚitemsrM   r#   r#   r$   rS   ‰   s   
zConfiguration.itemsÚkeyc                 C   s*   z| j | W S  ty   td|› �ƒ‚w )z#Get a value from the configuration.úNo such key - )rR   ÚKeyErrorr	   )rH   rT   r#   r#   r$   Ú	get_value�   s
   ÿzConfiguration.get_valueÚvaluec                 C   st   |   ¡  | js	J ‚|  ¡ \}}|dur*t|ƒ\}}| |¡s#| |¡ | |||¡ || j| j |< |  ||¡ dS )z$Modify a value in the configuration.N)	Ú_ensure_have_load_onlyr:   rO   r*   Úhas_sectionZadd_sectionÚsetrF   Ú_mark_as_modified)rH   rT   rX   ÚfnameÚparserÚsectionr   r#   r#   r$   Ú	set_value–   s   


zConfiguration.set_valuec                 C   s    |   ¡  | js	J ‚|| j| j vrtd|› �ƒ‚|  ¡ \}}|durGt|ƒ\}}| |¡r3| ||¡s7tdƒ‚| |¡sA| 	|¡ |  
||¡ | j| j |= dS )z#Unset a value in the configuration.rU   Nz4Fatal Internal error [id=1]. Please report as a bug.)rY   r:   rF   r	   rO   r*   rZ   Úremove_optionrS   Zremove_sectionr\   )rH   rT   r]   r^   r_   r   r#   r#   r$   Úunset_value¨   s$   
ÿ
ÿÿ

zConfiguration.unset_valuec              	   C   sl   |   ¡  | jD ],\}}t d|¡ ttj |¡ƒ t|dƒ�}| 	|¡ W d  ƒ n1 s.w   Y  qdS )z!Save the current in-memory state.zWriting to %sÚwN)
rY   rG   ÚloggerÚinfor   r+   r,   ÚdirnameÚopenÚwrite)rH   r]   r^   Úfr#   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)r:   r	   rd   ÚdebugrM   r#   r#   r$   rY   Ô   s   
z$Configuration._ensure_have_load_onlyc                 C   s"   i }t D ]
}| | j| ¡ q|S )z3A dictionary representing the loaded configuration.)rD   ÚupdaterF   )rH   Zretvalr<   r#   r#   r$   rR   Ù   s   zConfiguration._dictionaryc                 C   s˜   t |  ¡ ƒ}|tj dd… tjgkrt d¡ dS | ¡ D ]+\}}|D ]$}| j	dur8|| j	kr8t d||¡ q$|  
||¡}| j|  ||f¡ q$q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_filesr6   r   r+   Údevnullrd   rk   rS   r:   Ú
_load_filerE   Úappend)rH   Úconfig_filesr<   Úfilesr]   r^   r#   r#   r$   rK   å   s   ÿöÿz Configuration._load_config_filesr<   r]   c                 C   sL   t  d||¡ |  |¡}| ¡ D ]}| |¡}| j|  |  ||¡¡ q|S )Nz'For variant '%s', will try loading '%s')rd   ÚverboseÚ_construct_parserZsectionsrS   rF   rl   Ú_normalized_keys)rH   r<   r]   r^   r_   rS   r#   r#   r$   rp   ü   s   

zConfiguration._load_filec              
   C   sr   t  ¡ }tj |¡r7z| |¡ W |S  ty%   td t	 
d¡¡|d�‚ t jy6 } zt|d�‚d }~ww |S )Nzcontains invalid {} charactersF)Úreasonr]   )Úerror)ÚconfigparserÚRawConfigParserr+   r,   ÚexistsÚreadÚUnicodeDecodeErrorr
   r(   ÚlocaleÚgetpreferredencodingÚError)rH   r]   r^   rx   r#   r#   r$   ru     s"   õÿü
€þzConfiguration._construct_parserc                 C   s"   | j tj  |  d|  ¡ ¡¡ dS )z.Loads configuration from environment variablesz:env:N)rF   r6   r   rl   rv   Úget_environ_varsrM   r#   r#   r$   rL     s   ÿz$Configuration._load_environment_varsr_   rS   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%   )rH   r_   rS   Z
normalizedr   ÚvalrT   r#   r#   r$   rv   "  s
   
zConfiguration._normalized_keysc                 c   sF   � t j ¡ D ]\}}| d¡r |dd…  ¡ }|tvr ||fV  qdS )z@Returns a generator with all environmental vars with prefix PIP_ZPIP_é   N)r+   ÚenvironrS   r"   r    ÚENV_NAMES_IGNORED)rH   rT   r‚   r   r#   r#   r$   r�   0  s   €

€üzConfiguration.get_environ_varsc                 c   s’   � t j dd¡}|durtj|gfV  ntjg fV  tƒ }tj|tj fV  | j o2|o1t j 	|¡ }|r>tj
|tj
 fV  tj|tj fV  dS )zYields variant and configuration files associated with it.

        This should be treated like items of a dictionary.
        ZPIP_CONFIG_FILEN)r+   r„   Úgetr6   r   r7   r   r9   r,   r{   r   r   )rH   Zconfig_filerr   Zshould_load_user_configr#   r#   r$   rn   9  s   €ÿzConfiguration.iter_config_filesc                 C   s
   | j | S )z#Get values present in a config file)rF   )rH   r<   r#   r#   r$   Úget_values_in_configW  s   
z"Configuration.get_values_in_configc                 C   s*   | j sJ ‚| j| j  }|stdƒ‚|d S )Nz4Fatal Internal error [id=2]. Please report as a bug.éÿÿÿÿ)r:   rE   r	   )rH   Zparsersr#   r#   r$   rO   [  s   
ÿz#Configuration._get_parser_to_modifyr^   c                 C   s&   ||f}|| j vr| j  |¡ d S d S ©N)rG   rq   )rH   r]   r^   Zfile_parser_tupler#   r#   r$   r\   i  s   
ÿzConfiguration._mark_as_modifiedc                 C   s   | j j› d| j›d�S )Nú(ú))rJ   Ú__name__rR   rM   r#   r#   r$   Ú__repr__n  s   zConfiguration.__repr__r‰   )r   N)%rŒ   Ú
__module__Ú__qualname__Ú__doc__Úboolr   r   r@   rN   ÚstrrQ   r   r   r   rS   rW   r`   rb   rj   rY   Úpropertyr   rR   rK   rz   rp   ru   rL   rv   r�   r   rn   r‡   rO   r\   r�   Ú__classcell__r#   r#   rI   r$   r8   W   s<     
	




ÿÿ

þ	r8   ),r�   ry   r~   r+   r3   Útypingr   r   r   r   r   r   r   Úpip._internal.exceptionsr	   r
   Úpip._internal.utilsr   Zpip._internal.utils.compatr   Zpip._internal.utils.loggingr   Úpip._internal.utils.miscr   r   rz   r’   r   r.   r…   r6   r   r   r   r   r   rD   rA   rŒ   rd   r%   r*   r7   r8   r#   r#   r#   r$   Ú<module>   s:    $
û
