|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/platformdirs/__pycache__/ |
Upload File : |
o
�1b' � @ s� d dl mZ d dlZd dlZd dlmZ d dlmZ ddlm Z G dd� de �Z
dd d
�Z ddd�Z ddd�Z
ddd�Zedd�e� �ZdgZdS )� )� annotationsN)� lru_cache)�Callable� )�PlatformDirsABCc @ s� e Zd ZdZed dd��Zdd�d d d �Zed d
d��Zed dd��Zed dd��Z ed dd��Z
ed dd��Z ed dd��Z ed dd��Z
ed 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>`.�return�strc C s( | j rdnd}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 �6/usr/lib/python3/dist-packages/platformdirs/windows.py�
user_data_dir s
zWindows.user_data_dirN��
opinion_valuer r �
str | Nonec C st g }| j r0| jdur| jp| j }|�|� |�| j � |d ur'| jr'|�|� | jr0|�| j� tjj|g|�R � 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 � | j S )zC:return: config directory tied to the user, same as `user_data_dir`�r �r r r r �user_config_dir3 � zWindows.user_config_dirc C r& )zF:return: config directory shared by the users, same as `site_data_dir`)r% r( r r r �site_config_dir8 r* 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_dir= s zWindows.user_cache_dirc C r& )zB:return: state directory tied to the user, same as `user_data_dir`r' r( r r r �user_state_dirF r* zWindows.user_state_dirc C s | j }| jr
tj�|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 � 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 �Temp)r
r r r r r r$ r r r �user_runtime_dir\ s
zWindows.user_runtime_dir)r r )r r r r r r )�__name__�
__module__� __qualname__�__doc__�propertyr r r% r) r+ r- r. r0 r2 r4 r r r r r s*
r �
csidl_namer r c C sr | dkrt j�t j�t jd �d�S dddd��| �}|du r&td | � ���t j�|�}|du r7td
|� ���|S ) z&Get folder from environment variables.r1 � USERPROFILE� Documents�APPDATA�ALLUSERSPROFILE� LOCALAPPDATA)r
r" r N�Unknown CSIDL name: z Unset environment variable: )r
r r r �environ�get�
ValueError)r: � env_var_name�resultr r r � get_win_folder_from_env_varsf s �� rF c C sX ddddd�� | �}|du rtd| � ���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 AppData�Personal�r
r" r r1 Nr@ r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)rB rC �winreg�OpenKey�HKEY_CURRENT_USER� QueryValueExr )r: �shell_folder_namerJ �key� directory�_r r r � get_win_folder_from_registryx s ��rR c C s� ddddd�� | �}|du rtd| � ���t�d�}ttd �}|j�d|dd
|� td d � |D ��rBt�d�}|j� |j
|d�rB|}|j
S )
zGet folder with ctypes.� �# � � rI Nr@ 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>) rB rC �ctypes�create_unicode_buffer�getattr�shell32�SHGetFolderPathW�any�kernel32�GetShortPathNameW�value)r: � csidl_const�bufrW �buf2r r r �get_win_folder_via_ctypes� s" ��
ri �Callable[[str], str]c C s4 t td�rtS zdd l} W tS ty t Y S w )NrW r )�hasattrr] ri rJ � ImportErrorrF rR )rJ r r r �_pick_get_win_folder� s
��rm )�maxsize)r: r r r )r rj )�
__future__r r] r
� functoolsr �typingr �apir r rF rR ri rm r �__all__r r r r �<module> s
[
�