R`ie% d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z ddl
m Z e rddl m
Z
G d d
e Zdd Zdd Zdd
ZddZddZ ed e Zd
gZy)zWindows. ) annotationsN) lru_cache)
TYPE_CHECKING )PlatformDirsABC)Callablec e Zd ZdZedd ZddddZedd Zedd Zedd Z edd Z
edd
Z edd Z edd Z
edd
Zedd Zedd Zedd Zedd Zedd Zy)Windowsa
`MSDN on where to store app data files
`_.
Makes use of the
`appname `,
`appauthor `,
`version `,
`roaming `,
`opinion `,
`ensure_exists `.
c | j rdnd}t j j t | }| j | 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 s /builddir/build/BUILDROOT/alt-python312-pip-23.3.1-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py
user_data_dirzWindows.user_data_dir s< $(<<5Jww u 56!!$'' N
opinion_valuec g }| j r| j dur+| j xs | j }|j | |j | j | | j r|j | | j r|j | j t j j |g| }| j | |S )NF) appname appauthorappendopinionversionr r join _optionally_create_directory)r r r paramsauthors r r zWindows._append_parts( s <<~~U* 74<<
f% MM$,, ' (T\\
m,||
dll+ww||D*6* ))$/ r c t t j j t d }| j | S )zT:return: data directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``CSIDL_COMMON_APPDATAr r r r r r r s r
site_data_dirzWindows.site_data_dir7 s/ ww /E FG!!$''r c | j S )zC:return: config directory tied to the user, same as `user_data_dir`r r s r user_config_dirzWindows.user_config_dir= !!!r c | j S )zF:return: config directory shared by the users, same as `site_data_dir`)r) r, s r site_config_dirzWindows.site_config_dirB r. r c x t j j t d }| j |d 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( s r user_cache_dirzWindows.user_cache_dirG s4 ww /D EF!!$g!>>r c x t j j t d }| j |d S )zd:return: cache directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname\Cache\$version``r& r2 r r' r( s r site_cache_dirzWindows.site_cache_dirP s4 ww /E FG!!$g!>>r c | j S )zB:return: state directory tied to the user, same as `user_data_dir`r+ r, s r user_state_dirzWindows.user_state_dirV r. r c | j }| j r1t j j |d }| j | |S )zg:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in itLogs)r r r r r! r" r( s r user_log_dirzWindows.user_log_dir[ s= !! <<77<<f-D - -d 3 r c R t j j t d S )zN:return: documents directory tied to the user e.g. ``%USERPROFILE%\Documents``CSIDL_PERSONALr r r r r, s r user_documents_dirzWindows.user_documents_dird s ww /? @AAr c R t j j t d S )zN:return: downloads directory tied to the user e.g. ``%USERPROFILE%\Downloads``CSIDL_DOWNLOADSr= r, s r user_downloads_dirzWindows.user_downloads_diri s ww /@ ABBr c R t j j t d S )zL:return: pictures directory tied to the user e.g. ``%USERPROFILE%\Pictures``CSIDL_MYPICTURESr= r, s r user_pictures_dirzWindows.user_pictures_dirn s ww /A BCCr c R t j j t d S )zH:return: videos directory tied to the user e.g. ``%USERPROFILE%\Videos``
CSIDL_MYVIDEOr= r, s r user_videos_dirzWindows.user_videos_dirs ww ?@@r c R t j j t d S )zF:return: music directory tied to the user e.g. ``%USERPROFILE%\Music``
CSIDL_MYMUSICr= r, s r user_music_dirzWindows.user_music_dirx rH r c t j j t j j t d d }| j | 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( s r user_runtime_dirzWindows.user_runtime_dir} s? ww ^ rA rD rG rK rN r r r
r
s5
( ( GK
( (
" " " " ? ? ? ?
" " B B C C D D A A A A ( (r r
c t | }||S ddddj | }|d| }t | t j j | }|d| }t | |S )z&Get folder from environment variables.APPDATAALLUSERSPROFILE LOCALAPPDATA)r r& r
Unknown CSIDL name: z Unset environment variable: )(get_win_folder_if_csidl_name_not_env_varget
ValueErrorr environ)
csidl_nameresult env_var_namemsgs r get_win_folder_from_env_varsre s
5j
AF
# 1 -
c*o
$ZL1o
ZZ^^L
)F
~,\N;o Mr c B | dk( rNt j j t j j t j d d S | dk( rNt j j t j j t j d d S | dk( rNt j j t j j t j d d S | dk( rNt j j t j j t j d d S | d
k( rNt j j t j j t j d d S y )
zKGet folder for a CSIDL name that does not exist as an environment variable.r< USERPROFILE Documentsr@ DownloadsrC PicturesrF VideosrJ MusicN)r r r! r r` )ra s r r] r] s %%ww||BGG , ,RZZ
-F GUU&&ww||BGG , ,RZZ
-F GUU''ww||BGG , ,RZZ
-F GTT_$ww||BGG , ,RZZ
-F GRR_$ww||BGG , ,RZZ
-F GQQ r c ddddddddd j | }|d | }t | t j d k7 rt d
d
l}|j
|j d }|j || \ }}t | S )z
Get folder from the registry.
This is a fallback technique at best. I'm not sure if using the registry for these guarantees us the correct answer
for all CSIDL_* names.
AppDatazCommon AppDataz
Local AppDataPersonalz&{374DE290-123F-4565-9164-39C4925E467B}z My PictureszMy VideozMy Music)r r& r
r< r@ rC rF rJ Nr\ win32r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)
r^ r_ sysplatformNotImplementedErrorwinregOpenKeyHKEY_CURRENT_USER QueryValueExrP )ra shell_folder_namerd rt key directory_s r get_win_folder_from_registryr| s # 0 .$C )##
c*o $ZL1o
||w !!
..113v
wC&&s,=>LIq y>r c ddddddddd j | }|d | }t | t j d }t t d
}|j
j
d
|d
d| t d |D r>t j d }|j j |j |d r|}| dk( r*t j j |j d S |j S )zGet folder with ctypes. # '
( )r r& r
r< rC rF rJ r@ Nr\ i windllr c 3 8 K | ] }t | d kD yw) N)ord).0cs r z,get_win_folder_via_ctypes.. s
%A3q6C<s r@ ri )r^ r_ ctypescreate_unicode_buffergetattrshell32SHGetFolderPathWanykernel32GetShortPathNameWvaluer r r! )ra csidl_constrd bufr buf2s r get_win_folder_via_ctypesr s " !
c*o $ZL1o
&
&t
,C
VX
&F
NN##D+tQD
%
%%++D1 ?? , ,SYYd CC&&ww||CII{33 99r c n t t d rt S dd l} t S # t
$ r t cY S w xY w)Nr r )hasattrr r rt r| ImportErrorre )rt s r _pick_get_win_folderr s9 vx ((, ,+ ,++,s " 44)maxsize)ra rP rO rP )ra rP rO rQ )rO zCallable[[str], str])rU
__future__r r r rq functoolsr typingr apir collections.abcr r
re r] r| r r r __all__rW r r r so "
(t(o t(n*&:!H, )4()=)?@ r