B
8r @ 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
dZ d d d
ddZ
ddddZedde ZdgZdS ) ) annotationsN) lru_cache)Callable )PlatformDirsABCc @ s e Zd ZdZeddddZdddddd d
d Zeddd d
ZeddddZeddddZ eddddZ
eddddZ eddddZ eddddZ
eddddZdS ) Windowsa `MSDN on where to store app data files
`_.
Makes use of the
`appname `,
`appauthor `,
`version `,
`roaming `,
`opinion `.str)returnc C s( | j r
dnd}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 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 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_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 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 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 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_dirU 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 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 jt jt jd dS dddd| }|dkrLtd | t j|}|dkrntd
| |S ) z&Get folder from environment variables.r) USERPROFILEZ DocumentsAPPDATAZALLUSERSPROFILEZ LOCALAPPDATA)r
r r NzUnknown CSIDL name: z Unset environment variable: )r
r r r environget
ValueError)r1 Z env_var_nameresultr r r get_win_folder_from_env_varsf s r8 c C sX ddddd | }|dkr*td| 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.
AppDatazCommon AppDataz
Local AppDataZPersonal)r
r r r) NzUnknown CSIDL name: r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)r5 r6 winregOpenKeyHKEY_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| td}ttd }|jd|dd
| td d |D rtd}|j |j
|dr|}|j
S )
zGet folder with ctypes. # )r
r r r) NzUnknown CSIDL name: i windllr c s s | ]}t |d kV qdS ) N)ord).0cr r r s z,get_win_folder_via_ctypes..) r5 r6 ctypescreate_unicode_buffergetattrshell32SHGetFolderPathWanykernel32GetShortPathNameWvalue)r1 csidl_constbufrG buf2r r r get_win_folder_via_ctypes s
rY zCallable[[str], str])r c C s8 t tdrtS 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 s [