a
    û"©b#7  ã                   @   s  d 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 ddlmZmZ ddlmZmZ ddlmZ er°dd	lmZmZmZmZmZmZmZ ejZed
eƒZe e ¡Z!dd„ Z"dd„ Z#edddddd�Z$erädndZ%dd„ Z&G dd„ de'ƒ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)Úconfigparser)ÚConfigurationErrorÚ!ConfigurationFileCouldNotBeLoaded)Úappdirs)ÚWINDOWSÚ
expanduser)Ú
ensure_dirÚenum)ÚMYPY_CHECK_RUNNING)ÚAnyÚDictÚIterableÚListÚNewTypeÚOptionalÚTupleÚKindc                 C   s*   |   ¡  dd¡} |  d¡r&| dd… } | S )zFMake a name consistent regardless of source (environment or file)
    Ú_ú-z--é   N)ÚlowerÚreplaceÚ
startswith)Úname© r   úd/home/yuhw/wc/wire-cell-python-pr-11/pr11/lib/python3.9/site-packages/pip/_internal/configuration.pyÚ_normalize_name*   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   Úerror_messager   r   r   Ú_disassemble_key4   s    ÿýr"   ÚuserÚglobalÚsiteÚenvzenv-var)ÚUSERÚGLOBALÚSITEÚENVÚENV_VARzpip.inizpip.confc                  C   sp   dd„ t  d¡D ƒ} tj tjt¡}tj tdƒt	r8d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>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 Zd ZdZd-‡ fdd„	Zdd„ Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ Zedd„ ƒZdd„ Zdd„ Zdd„ Zdd„ Zdd „ Zd!d"„ Zd#d$„ Zd%d&„ Zd'd(„ Zd)d*„ Zd+d,„ Z‡  ZS ).Ú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| ƒ ¡  tjtjtjd g}||vrJtd d 	t
t|d d… ƒ¡¡ƒ‚|| _|| _tjtjtjtjtjg| _ddg| _dd„ | jD ƒ| _dd„ | jD ƒ| _g | _d S )	Nz5Got invalid value for load_only - should be one of {}z, éÿÿÿÿÚversionÚhelpc                 S   s   i | ]
}|g “qS r   r   ©r0   Úvariantr   r   r   Ú
<dictcomp>‡   s   z*Configuration.__init__.<locals>.<dictcomp>c                 S   s   i | ]
}|i “qS 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   s(    ÿÿÿ
ÿÿzConfiguration.__init__c                 C   s   |   ¡  | js|  ¡  dS )zELoads configuration from configuration files and environment
        N)Ú_load_config_filesrI   Ú_load_environment_vars©rP   r   r   r   Úload�   s    zConfiguration.loadc                 C   s:   | j dusJ dƒ‚z|  ¡ d W S  ty4   Y dS 0 dS )z@Returns the file with highest priority in configuration
        Nz)Need to be specified a file to be editingr   )rJ   Ú_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    zConfiguration.itemsc                 C   s2   z| j | W S  ty,   td |¡ƒ‚Y n0 dS )z,Get a value from the configuration.
        úNo such key - {}N)r[   ÚKeyErrorr   r   )rP   Úkeyr   r   r   Ú	get_valueª   s    zConfiguration.get_valuec                 C   st   |   ¡  | jsJ ‚|  ¡ \}}|durTt|ƒ\}}| |¡sF| |¡ | |||¡ || j| j |< |  ||¡ dS )z-Modify a value in the configuration.
        N)	Ú_ensure_have_load_onlyrJ   rX   r"   Úhas_sectionÚadd_sectionÚsetrN   Ú_mark_as_modified)rP   r_   ÚvalueÚfnameÚparserÚsectionr   r   r   r   Ú	set_value³   s    


zConfiguration.set_valuec                 C   s    |   ¡  | jsJ ‚|| j| j vr0td |¡ƒ‚|  ¡ \}}|durŽt|ƒ\}}| |¡rf| ||¡sntdƒ‚| 	|¡s‚| 
|¡ |  ||¡ | j| j |= dS )z#Unset a value in the configuration.r]   Nz4Fatal Internal error [id=1]. Please report as a bug.)ra   rJ   rN   r   r   rX   r"   rb   Úremove_optionr\   Úremove_sectionre   )rP   r_   rg   rh   ri   r   r   r   r   Úunset_valueÇ   s"    


ÿÿ

zConfiguration.unset_valuec              	   C   sl   |   ¡  | jD ]X\}}t d|¡ ttj |¡ƒ t|dƒ�}| 	|¡ W d  ƒ q1 s\0    Y  qdS )z*Save the current in-memory state.
        zWriting to %sÚwN)
ra   rO   ÚloggerÚinfor   r,   r-   ÚdirnameÚopenÚwrite)rP   rg   rh   Ú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)rJ   r   ro   ÚdebugrV   r   r   r   ra   õ   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    
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 )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,   Údevnullro   rv   r\   rJ   Ú
_load_filerM   Úappend)rP   Úconfig_filesrC   Úfilesrg   rh   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')ro   rv   Ú_construct_parserÚsectionsr\   rN   rw   Ú_normalized_keys)rP   rC   rg   rh   ri   r\   r   r   r   r|   $  s    

zConfiguration._load_filec              
   C   s€   t  ¡ }tj |¡r|z| |¡ W nX tyL   td t	 
d¡¡|d�‚Y n0 t jyz } zt|d�‚W Y d }~n
d }~0 0 |S )Nzcontains invalid {} charactersF)Úreasonrg   )Úerror)r   ÚRawConfigParserr,   r-   ÚexistsÚreadÚUnicodeDecodeErrorr   r   ÚlocaleÚgetpreferredencodingÚError)rP   rg   rh   r„   r   r   r   r€   /  s    ÿü
 zConfiguration._construct_parserc                 C   s"   | j tj  |  d|  ¡ ¡¡ dS )z7Loads configuration from environment variables
        z:env:N)rN   r8   r+   rw   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   ri   r\   Ú
normalizedr   Úvalr_   r   r   r   r‚   N  s
    
zConfiguration._normalized_keysc                 c   sR   t j ¡ D ]B\}}| d¡o0|dd…  ¡ | jv}|r
|dd…  ¡ |fV  q
dS )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 dd¡}|dur&tj|gfV  ntjg fV  tƒ }tj|tj fV  | j ob|o`t j 	|¡ }|rzt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.
        ÚPIP_CONFIG_FILEN)r,   r‘   Úgetr8   r*   r=   r(   rI   r-   r†   r'   r)   )rP   Úconfig_filer~   Úshould_load_user_configr   r   r   rz   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
J ‚| j| j  }|s"tdƒ‚|d S )Nz4Fatal Internal error [id=2]. Please report as a bug.r?   )rJ   rM   r   )rP   Úparsersr   r   r   rX   ‹  s    
ÿz#Configuration._get_parser_to_modifyc                 C   s"   ||f}|| j vr| j  |¡ d S )N)rO   r}   )rP   rg   rh   Úfile_parser_tupler   r   r   re   š  s    
zConfiguration._mark_as_modifiedc                 C   s   d  | jj| j¡S )Nz{}({!r}))r   rS   Ú__name__r[   rV   r   r   r   Ú__repr__   s    zConfiguration.__repr__)N)rš   Ú
__module__Ú__qualname__Ú__doc__rF   rW   rZ   r\   r`   rj   rm   ru   ra   Úpropertyr[   rT   r|   r€   rU   r‚   rŒ   rz   r—   rX   re   r›   Ú__classcell__r   r   rR   r   r>   c   s.   	
r>   ))rž   r‰   Úloggingr,   r5   Úpip._vendor.six.movesr   Úpip._internal.exceptionsr   r   Zpip._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š   ro   r   r"   r8   r/   r=   Úobjectr>   r   r   r   r   Ú<module>   s6   $


û	