o
ai @ s d dl Z d dlZd dlmZ d dlmZmZ ddlmZ G dd deZ de
d e
fd
d Z de
d e
fd d
Z de
d e
fddZ
d ee
ge
f fddZedde ZdgZdS ) N) lru_cache)CallableOptional )PlatformDirsABCc @ s e Zd ZdZedefddZdddedee defd d
Zedefd d Z edefd
dZ
edefddZ edefddZ edefddZ
edefddZedefddZedefddZdS )Windowsa `MSDN on where to store app data files
`_.
Makes use of the
`appname `,
`appauthor `,
`version `,
`roaming `,
`opinion `.returnc C s( | j rdnd}tjt|}| |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_APPDATACSIDL_LOCAL_APPDATA)roamingospathnormpathget_win_folder
_append_parts)selfconstr
r /builddir/build/BUILDROOT/alt-python310-pip-21.3.1-5.el8.x86_64/opt/alt/python310/lib/python3.10/site-packages/pip/_vendor/platformdirs/windows.py
user_data_dir s
zWindows.user_data_dirN
opinion_valuer
r c C st g }| j r0| jdur| jp| j }|| || j |d ur'| jr'|| | jr0|| j tjj|g|R S )NF)appname appauthorappendopinionversionr r
join)r r
r paramsauthorr r r r s
zWindows._append_partsc C s t jtd}| |S )zT:return: data directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``CSIDL_COMMON_APPDATAr 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_dir1 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_dir6 r( zWindows.site_config_dirc C s t jtd}| j|ddS )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_dirD 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
ZLogs)r r r r
r r" r r r user_log_dirI s zWindows.user_log_dirc C s t jtdS )z`
:return: documents directory tied to the user e.g. ``%USERPROFILE%\Documents``
CSIDL_PERSONAL)r r
r r r& r r r user_documents_dirS s zWindows.user_documents_dirc C s$ t jt jtdd}| |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_dirZ s
zWindows.user_runtime_dir)__name__
__module__ __qualname____doc__propertystrr r r r# r' r) r+ r, r- r/ r0 r r r r r s*
r
csidl_namer c C sr | dkrt jt jt jd dS dddd| }|du r&td | t j|}|du r7td
| |S ) z&Get folder from environment variables.r. USERPROFILEZ DocumentsAPPDATAZALLUSERSPROFILE LOCALAPPDATA)r r r
NUnknown CSIDL name: z Unset environment variable: )r r
r r environget
ValueError)r7 Z env_var_nameresultr r r get_win_folder_from_env_varsd s r@ c C sX ddddd | }|du rtd| ddl}||jd }|||\}}t|S )
zGet 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 AppDataZPersonalr r r
r. Nr; r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)r= r> winregOpenKeyHKEY_CURRENT_USER QueryValueExr6 )r7 Zshell_folder_namerB key directory_r r r get_win_folder_from_registryv s rI c C s ddddd | }|du rtd| td}ttd }|jd|dd
| td d |D rBtd}|j |j
|drB|}|j
S )
zGet folder with ctypes. # rA Nr; i windllr c s s | ] }t |d kV qdS ) N)ord).0cr r r s z,get_win_folder_via_ctypes..) r= r> ctypescreate_unicode_buffergetattrZshell32ZSHGetFolderPathWanyZkernel32ZGetShortPathNameWvalue)r7 Z csidl_constbufrN Zbuf2r r r get_win_folder_via_ctypes s"
rZ c C s4 t tdrtS zdd l} W tS ty t Y S w )NrN r )hasattrrT rZ rB ImportErrorr@ rI )rB r r r _pick_get_win_folder s
r] )maxsize)rT r functoolsr typingr r apir r r6 r@ rI rZ r] r __all__r r r r s [