File: //usr/local/lib/python3.7/site-packages/pip/_vendor/platformdirs/__pycache__/windows.cpython-37.pyc
B
L��ge% � @ s� d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z ddl
m Z e r\ddl m
Z
G d d
� d
e �Zd d d �d
d�Zd dd �dd�Zd d d �dd�Zd d d �dd�Zdd�dd�Zedd�e� �Zd
gZdS )zWindows.� )� annotationsN)� lru_cache)�
TYPE_CHECKING� )�PlatformDirsABC)�Callablec @ s$ e Zd ZdZedd�dd��Zdd�dddd �d
d �Zedd�d d
��Zedd�dd��Zedd�dd��Z edd�dd��Z
edd�dd��Z edd�dd��Z edd�dd��Z
edd�dd��Zedd�d d ��Zedd�d d ��Zedd�d d!��Zedd�d"d#��Zedd�d$d%��ZdS )&�Windowsa
`MSDN on where to store app data files
<http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120>`_.
Makes use of the
`appname <platformdirs.api.PlatformDirsABC.appname>`,
`appauthor <platformdirs.api.PlatformDirsABC.appauthor>`,
`version <platformdirs.api.PlatformDirsABC.version>`,
`roaming <platformdirs.api.PlatformDirsABC.roaming>`,
`opinion <platformdirs.api.PlatformDirsABC.opinion>`,
`ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
�str)�returnc C s( | j r
dnd}tj�t|��}| �|�S )z�
:return: data directory tied to the user, e.g.
``%USERPROFILE%\AppData\Local\$appauthor\$appname`` (not roaming) or
``%USERPROFILE%\AppData\Roaming\$appauthor\$appname`` (roaming)
�
CSIDL_APPDATA�CSIDL_LOCAL_APPDATA)�roaming�os�path�normpath�get_win_folder�
_append_parts)�self�constr � r �D/tmp/pip-unpacked-wheel-hv55ucu3/pip/_vendor/platformdirs/windows.py�
user_data_dir s zWindows.user_data_dirN)�
opinion_valuez
str | None)r r r
c C s� g }| j r`| jdk r*| jp | j }|�|� |�| j � |d k rN| jrN|�|� | jr`|�| j� tjj|f|�� }| �|� |S )NF) �appname� appauthor�append�opinion�versionr r �join� _optionally_create_directory)r r r �params�authorr r r r ( s
zWindows._append_partsc C s t j�td��}| �|�S )zT:return: data directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``�CSIDL_COMMON_APPDATA)r r r r r )r r r r r �
site_data_dir7 s zWindows.site_data_dirc C s | j S )zC:return: config directory tied to the user, same as `user_data_dir`)r )r r r r �user_config_dir= s zWindows.user_config_dirc C s | j S )zF:return: config directory shared by the users, same as `site_data_dir`)r# )r r r r �site_config_dirB s zWindows.site_config_dirc C s t j�td��}| j|dd�S )z�
:return: cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g.
``%USERPROFILE%\AppData\Local\$appauthor\$appname\Cache\$version``
r �Cache)r )r r r r r )r r r r r �user_cache_dirG s zWindows.user_cache_dirc C s t j�td��}| j|dd�S )zd:return: cache directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname\Cache\$version``r" r& )r )r r r r r )r r r r r �site_cache_dirP s zWindows.site_cache_dirc C s | j S )zB:return: state directory tied to the user, same as `user_data_dir`)r )r r r r �user_state_dirV s zWindows.user_state_dirc C s( | j }| jr$tj�|d�}| �|� |S )zg:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it�Logs)r r r r r r )r r r r r � user_log_dir[ s
zWindows.user_log_dirc C s t j�td��S )zN:return: documents directory tied to the user e.g. ``%USERPROFILE%\Documents``�CSIDL_PERSONAL)r r r r )r r r r �user_documents_dird s zWindows.user_documents_dirc C s t j�td��S )zN:return: downloads directory tied to the user e.g. ``%USERPROFILE%\Downloads``�CSIDL_DOWNLOADS)r r r r )r r r r �user_downloads_diri s zWindows.user_downloads_dirc C s t j�td��S )zL:return: pictures directory tied to the user e.g. ``%USERPROFILE%\Pictures``�CSIDL_MYPICTURES)r r r r )r r r r �user_pictures_dirn s zWindows.user_pictures_dirc C s t j�td��S )zH:return: videos directory tied to the user e.g. ``%USERPROFILE%\Videos``�
CSIDL_MYVIDEO)r r r r )r r r r �user_videos_dirs s zWindows.user_videos_dirc C s t j�td��S )zF:return: music directory tied to the user e.g. ``%USERPROFILE%\Music``�
CSIDL_MYMUSIC)r r r r )r r r r �user_music_dirx s zWindows.user_music_dirc C s$ t j�t j�td�d��}| �|�S )z�
:return: runtime directory tied to the user, e.g.
``%USERPROFILE%\AppData\Local\Temp\$appauthor\$appname``
r ZTemp)r r r r r r )r r r r r �user_runtime_dir} s zWindows.user_runtime_dir)�__name__�
__module__� __qualname__�__doc__�propertyr r r# r$ r% r' r( r) r+ r- r/ r1 r3 r5 r6 r r r r r s r r )�
csidl_namer
c C sj t | �}|dk r|S dddd��| �}|dkr@d| � �}t|��tj�|�}|dkrfd|� �}t|��|S )z&Get folder from environment variables.N�APPDATAZALLUSERSPROFILE� LOCALAPPDATA)r r" r zUnknown CSIDL name: z Unset environment variable: )�(get_win_folder_if_csidl_name_not_env_var�get�
ValueErrorr �environ)r< �resultZ env_var_name�msgr r r � get_win_folder_from_env_vars� s
rE z
str | Nonec C s� | dkr$t j�t j�t jd �d�S | dkrHt j�t j�t jd �d�S | dkrlt j�t j�t jd �d�S | dkr�t j�t j�t jd �d �S | d
kr�t j�t j�t jd �d �S d S )
zKGet folder for a CSIDL name that does not exist as an environment variable.r, � USERPROFILEZ Documentsr. � Downloadsr0 ZPicturesr2 ZVideosr4 ZMusicN)r r r r rB )r< r r r r? � s r? c C sr ddddddddd �� | �}|d
kr6d | � �}t|��tjd krDt�d
d
l}|�|jd�}|�||�\}}t |�S )z�
Get folder from the registry.
This is a fallback technique at best. I'm not sure if using the registry for these guarantees us the correct answer
for all CSIDL_* names.
�AppDatazCommon AppDataz
Local AppDataZPersonalz&{374DE290-123F-4565-9164-39C4925E467B}z My PictureszMy VideozMy Music)r r" r r, r. r0 r2 r4 NzUnknown CSIDL name: �win32r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)
r@ rA �sys�platform�NotImplementedError�winreg�OpenKey�HKEY_CURRENT_USER� QueryValueExr )r< �shell_folder_namerD rM �key� directory�_r r r � get_win_folder_from_registry� s$
rU c C s� ddddddddd �� | �}|d
kr6d | � �}t|��t�d �}ttd
�}|j�d
|d
d|� tdd� |D ��r�t�d �}|j� |j
|d �r�|}| dkr�t j �
|j
d�S |j
S )zGet folder with ctypes.� �# � � �' � �
�( )r r" r r, r0 r2 r4 r. NzUnknown CSIDL name: i �windllr c s s | ]}t |�d kV qdS )� N)�ord)�.0�cr r r � <genexpr>� s z,get_win_folder_via_ctypes.<locals>.<genexpr>r. rG )r@ rA �ctypes�create_unicode_buffer�getattr�shell32�SHGetFolderPathW�any�kernel32�GetShortPathNameW�valuer r r )r< � csidl_constrD �bufr^ �buf2r r r �get_win_folder_via_ctypes� s,
rp zCallable[[str], str])r
c C s8 t td�rtS y dd l} W n tk
r. tS X tS d S )Nr^ r )�hasattrrd rp rM � ImportErrorrE rU )rM r r r �_pick_get_win_folder� s
rs )�maxsize)r: �
__future__r rd r rJ � functoolsr �typingr �apir �collections.abcr r rE r? rU rp rs r �__all__r r r r �<module> s" w $