관리-도구
편집 파일: windows.cpython-38.pyc
U &?�f�' � @ s� d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m Z erTddl m Z G d d � d e �Z d 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 @ sH 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%��Zedd�d&d'��Zedd�d(d)��ZdS )*�Windowsa� `MSDN on where to store app data files <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid>`_. 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 �N/opt/hc_python/lib/python3.8/site-packages/pip/_vendor/platformdirs/windows.py� user_data_dir s zWindows.user_data_dirN�� opinion_value� 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_dir5 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_dir@ 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 �Cacher r& r' r r r �user_cache_dirE 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 �site_cache_dirN 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_dirT 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 itZLogs)r r r r r! r" r' r r r � user_log_dirY 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_dirb s zWindows.user_documents_dirc C s t j�td��S )zN:return: downloads directory tied to the user e.g. ``%USERPROFILE%\Downloads``�CSIDL_DOWNLOADSr3 r* r r r �user_downloads_dirg s zWindows.user_downloads_dirc C s t j�td��S )zL:return: pictures directory tied to the user e.g. ``%USERPROFILE%\Pictures``�CSIDL_MYPICTURESr3 r* r r r �user_pictures_dirl s zWindows.user_pictures_dirc C s t j�td��S )zH:return: videos directory tied to the user e.g. ``%USERPROFILE%\Videos``� CSIDL_MYVIDEOr3 r* r r r �user_videos_dirq s zWindows.user_videos_dirc C s t j�td��S )zF:return: music directory tied to the user e.g. ``%USERPROFILE%\Music``� CSIDL_MYMUSICr3 r* r r r �user_music_dirv s zWindows.user_music_dirc C s t j�td��S )zK:return: desktop directory tied to the user, e.g. ``%USERPROFILE%\Desktop``�CSIDL_DESKTOPDIRECTORYr3 r* r r r �user_desktop_dir{ s zWindows.user_desktop_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 �user_runtime_dir� s zWindows.user_runtime_dirc C s | j S )zF:return: runtime directory shared by users, same as `user_runtime_dir`)r? r* r r r �site_runtime_dir� s zWindows.site_runtime_dir)�__name__� __module__� __qualname__�__doc__�propertyr r r( r+ r, r. r/ r0 r1 r4 r6 r8 r: r< r> r? r@ r r r r r sD 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 �Unknown CSIDL name: z Unset environment variable: )�(get_win_folder_if_csidl_name_not_env_var�get� ValueErrorr �environ)rF �resultZ env_var_name�msgr r r � get_win_folder_from_env_vars� s" �� rP r c 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 ) zMGet a folder for a CSIDL name that does not exist as an environment variable.r2 � USERPROFILEZ Documentsr5 � Downloadsr7 ZPicturesr9 ZVideosr; ZMusicN)r r r! r rM )rF r r r rJ � s rJ 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. ZAppDatazCommon AppDataz Local AppDataZPersonalz&{374DE290-123F-4565-9164-39C4925E467B}z My PictureszMy VideozMy Music)r r% r r2 r5 r7 r9 r; NrI �win32r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders) rK rL �sys�platform�NotImplementedError�winreg�OpenKey�HKEY_CURRENT_USER� QueryValueExr )rF Zshell_folder_namerO rW �key� directory�_r r r � get_win_folder_from_registry� s( � � r^ c C s� ddl }ddddddd d d d � �| �}|dkr@d | � �}t|��|�d�}t|d�}|j�d|dd|� tdd� |D ��r�|�d�}|j� |j |d�r�|}| dkr�t j � |j d�S |j S )zGet folder with ctypes.r N� �# � � �' � � �( � ) r r% r r2 r7 r9 r; r5 r= rI i �windllc s s | ]}t |�d kV qdS )� N)�ord)�.0�cr r r � <genexpr>� s z,get_win_folder_via_ctypes.<locals>.<genexpr>r5 rR )�ctypesrK rL Zcreate_unicode_buffer�getattrZshell32ZSHGetFolderPathW�any�kernel32ZGetShortPathNameW�valuer r r! )rF rn Z csidl_constrO �bufrh Zbuf2r r r �get_win_folder_via_ctypes� s4 � � rt zCallable[[str], str]r c C s^ z dd l } W n tk r Y nX t| d�r0tS z dd l}W n tk rT t Y S X tS d S )Nr rh )rn � ImportError�hasattrrt rW rP r^ )rn rW r r r �_pick_get_win_folder� s rw )�maxsize)rD � __future__r r rT � functoolsr �typingr �apir �collections.abcr r rP rJ r^ rt rw r �__all__r r r r �<module> s" '�