Edit File: windows.cpython-37.pyc
B Ĥ�a' � @ s� d dl mZ d dlZd dlZd dlmZ d dlmZ ddlm Z G dd� de �Z d d d �d d �Z d d d �d d�Z d d d �dd�Z dd�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)�roaming�os�path�normpath�get_win_folder� _append_parts)�self�constr � r �E/opt/alt/python37/lib/python3.7/site-packages/platformdirs/windows.py� user_data_dir s zWindows.user_data_dirN)� opinion_valuez str | None)r r r c C sr 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)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_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_dir3 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_dir8 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_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_dirF 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 �Logs)r r r r r )r r r r r � user_log_dirK 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_dirU 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 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��| �}|dkrLtd | � ���t j�|�}|dkrntd |� ���|S ) z&Get folder from environment variables.r) � USERPROFILEZ Documents�APPDATAZALLUSERSPROFILEZ LOCALAPPDATA)r r r NzUnknown 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_varsf s r8 c C sX ddddd�� | �}|dkr*td| � ���ddl}|�|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. �AppDatazCommon AppDataz Local AppDataZPersonal)r r r r) NzUnknown CSIDL name: r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)r5 r6 �winreg�OpenKey�HKEY_CURRENT_USER� QueryValueExr )r1 �shell_folder_namer: �key� directory�_r r r � get_win_folder_from_registryx s rB c C s� ddddd�� | �}|dkr*td| � ���t�d�}ttd �}|j�d|dd |� td d � |D ��r�t�d�}|j� |j |d�r�|}|j S ) zGet folder with ctypes.� �# � � )r r r 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>) r5 r6 �ctypes�create_unicode_buffer�getattr�shell32�SHGetFolderPathW�any�kernel32�GetShortPathNameW�value)r1 � csidl_const�bufrG �buf2r r r �get_win_folder_via_ctypes� s rY zCallable[[str], str])r c C s8 t td�rtS y dd l} W n tk r. tS X tS d S )NrG r )�hasattrrM rY r: � ImportErrorr8 rB )r: r r r �_pick_get_win_folder� s r\ )�maxsize)� __future__r rM r � functoolsr �typingr Zapir r r8 rB rY r\ r �__all__r r r r �<module> s [