/
lib
/
python3.9
/
site-packages
/
platformdirs
/
__pycache__
/
Upload File
HOME
a y��d� � @ s� d dl mZ d dlZd dlZd dlZd dlmZ d dlmZ ddl m Z G dd� de �Z d d d �d d �Z d d d �d d�Z d d d �dd�Zdd�dd�Zedd�e� �ZdgZdS )� )� annotationsN)� lru_cache)�Callable� )�PlatformDirsABCc @ 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��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>`.�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)Zroaming�os�path�normpath�get_win_folder� _append_parts)�self�constr � r �8/usr/lib/python3.9/site-packages/platformdirs/windows.py� user_data_dir s zWindows.user_data_dirN�� opinion_valuez str | None)r r r c C st g }| j r`| jdur*| jp | j }|�|� |�| j � |d urN| jrN|�|� | jr`|�| j� tjj|g|�R � S )NF)ZappnameZ appauthor�append�opinion�versionr r �join)r r r �paramsZauthorr 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_dir. 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_dir4 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_dir9 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 ZCacher r r r r r �user_cache_dir> s zWindows.user_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_dirG s zWindows.user_state_dirc C s | j }| jrtj�|d�}|S )zy :return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it ZLogs)r r r r r r r r r � user_log_dirL s zWindows.user_log_dirc C s t j�td��S )z` :return: documents directory tied to the user e.g. ``%USERPROFILE%\Documents`` �CSIDL_PERSONAL)r r r r r# r r r �user_documents_dirV s zWindows.user_documents_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_dir)�__name__� __module__� __qualname__�__doc__�propertyr r r! r$ r% r& r' r( r* r+ r r r r r s( r r )� csidl_namer c C sr | dkr$t j�t j�t jd �d�S dddd��| �}|du rLtd | � ���t j�|�}|du rntd |� ���|S ) z&Get folder from environment variables.r) � USERPROFILEZ Documents�APPDATAZALLUSERSPROFILEZ LOCALAPPDATA)r r r N�Unknown CSIDL name: z Unset environment variable: )r r r r �environ�get� ValueError)r1 Z env_var_name�resultr r r � get_win_folder_from_env_varsg s �� r9 c C sf ddddd�� | �}|du r*td| � ���tjdkr8t�d dl}|�|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 this guarantees us the correct answer for all CSIDL_* names. ZAppDatazCommon AppDataz Local AppDataZPersonal�r r r r) Nr4 �win32r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders) r6 r7 �sys�platform�NotImplementedError�winreg�OpenKey�HKEY_CURRENT_USERZ QueryValueExr )r1 Zshell_folder_namer? �keyZ directory�_r r r � get_win_folder_from_registryy s �� rD c C s� ddddd�� | �}|du r*td| � ���t�d�}ttd �}|j�d|dd |� td d � |D ��r�t�d�}|j� |j |d�r�|}|j S ) zGet folder with ctypes.� �# � � r: Nr4 i �windllr c s s | ]}t |�d kV qdS )� N)�ord)�.0�cr r r � <genexpr>� � z,get_win_folder_via_ctypes.<locals>.<genexpr>) r6 r7 �ctypesZcreate_unicode_buffer�getattrZshell32ZSHGetFolderPathW�anyZkernel32ZGetShortPathNameW�value)r1 Z csidl_const�bufrI Zbuf2r r r �get_win_folder_via_ctypes� s" �� rU zCallable[[str], str]r c C s: t td�rtS z dd l} W n ty0 t Y S 0 tS d S )NrI r )�hasattrrP rU r? � ImportErrorr9 rD )r? r r r �_pick_get_win_folder� s rX )�maxsize)Z __future__r rP r r< � functoolsr �typingr Zapir r r9 rD rU rX r �__all__r r r r �<module> s [ �