Ë
|
ñúh' ã óÄ d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m
|
Z
|
erddl m Z G d d
|
e
|
« Z dd 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« Zedd« Zedd« Zy)ÚWindowsað
|
`MSDN on where to store app data files <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid>`_.
|
|
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>`, `ensure_exists
|
<platformdirs.api.PlatformDirsABC.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_APPDATAÚCSIDL_LOCAL_APPDATA)ÚroamingÚosÚpathÚnormpathÚget_win_folderÚ _append_parts)ÚselfÚconstr s úSH:\Change_password\venv_build\Lib\site-packages\pip/_vendor/platformdirs/windows.pyÚ user_data_dirzWindows.user_data_dir s< ð $(§<¢<Ð5JÜww× Ñ ¤¨uÓ 5Ó6Ø×!Ñ! $Ó'Ð'ó 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Ú appauthorÚappendÚopinionÚversionr r ÚjoinÚ _optionally_create_directory)r r r ÚparamsÚauthors r r zWindows._append_parts& s¡ ØØ <<Ø~~ UÑ*Ø Ò7¨4¯<©<Ø 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_APPDATA©r r r r r ©r r s r Ú site_data_dirzWindows.site_data_dir5 s/ ô ww× Ñ ¤Ð/EÓ FÓGØ×!Ñ! $Ó'Ð'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_dir@ 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_dirE s4 ô ww× Ñ ¤Ð/DÓ EÓFØ×!Ñ! $°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_dirN s4 ô ww× Ñ ¤Ð/EÓ FÓGØ×!Ñ! $°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_dirT 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 itÚLogs)r r r r r! r" r( s r Ú user_log_dirzWindows.user_log_dirY 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_PERSONAL©r r r r r, s r Úuser_documents_dirzWindows.user_documents_dirb s ô ww× Ñ ¤Ð/?Ó @ÓAÐAr 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_dirg s ô ww× Ñ ¤Ð/@Ó AÓBÐBr 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_dirl s ô ww× Ñ ¤Ð/AÓ BÓCÐCr 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_dirq ó ô 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_dirv rH r c óR t j j t d« « S )zK:return: desktop directory tied to the user, e.g. ``%USERPROFILE%\Desktop``ÚCSIDL_DESKTOPDIRECTORYr= r, s r Úuser_desktop_dirzWindows.user_desktop_dir{ s ô ww× Ñ ¤Ð/GÓ HÓIÐIr 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× Ñ ¤§¡§ ¡ ¬^Ð<QÓ-RÐTZÓ [Ó\Ø×!Ñ! $Ó'Ð'r c ó | j S )zF:return: runtime directory shared by users, same as `user_runtime_dir`)rQ r, s r Úsite_runtime_dirzWindows.site_runtime_dir s ð ×$Ñ$Ð$r )ÚreturnÚstr)r rU r ú
|
str | NonerT rU )Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__Úpropertyr r r) r- r0 r3 r5 r7 r: r> rA rD rG rK rN rQ rS © r r r
|
r
|
s_ ñð ò(ó ð(ð GKõ ð ò(ó ð(ð
|
ò"ó ð"ð ò"ó ð"ð ò?ó ð?ð ò?ó ð?ð
|
ò"ó ð"ð òó ðð òBó ðBð òCó ðCð òDó ðDð òAó ðAð òAó ðAð òJó ðJð ò(ó ð(ð ò%ó ñ%r r
|
c óÔ t | « }||S ddddj | « }|d| }t |« t j j |« }|d| }t |« |S )z&Get folder from environment variables.ÚAPPDATAÚALLUSERSPROFILEÚ LOCALAPPDATA)r r& r úUnknown CSIDL name: z Unset environment variable: )Ú(get_win_folder_if_csidl_name_not_env_varÚgetÚ
|
ValueErrorr Úenviron)Ú
|
csidl_nameÚresultÚ env_var_nameÚmsgs r Ú get_win_folder_from_env_varsrj s ä 5°jÓ AFØ ÐØ ð #Ø 1Ø -ñ÷
|
c*oð ð
|
ÐØ$ Z LÐ1ÜoÐ Ü 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 ) zMGet a folder for a CSIDL name that does not exist as an environment variable.r< Ú USERPROFILEÚ Documentsr@ Ú DownloadsrC ÚPicturesrF ÚVideosrJ ÚMusicN)r r r! r re )rf s r rb rb ¤ s àÐ%Ò%Üww||BGG× ,Ñ ,¬R¯Z©Z¸ Ñ-FÓ GÈÓUÐUàÐ&Ò&Üww||BGG× ,Ñ ,¬R¯Z©Z¸ Ñ-FÓ GÈÓUÐUàÐ'Ò'Üww||BGG× ,Ñ ,¬R¯Z©Z¸ Ñ-FÓ GÈÓTÐTà_Ò$Üww||BGG× ,Ñ ,¬R¯Z©Z¸ Ñ-FÓ GÈÓRÐRà_Ò$Üww||BGG× ,Ñ ,¬R¯Z©Z¸ Ñ-FÓ GÈÓQÐQØ 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 AppDataÚPersonalz&{374DE290-123F-4565-9164-39C4925E467B}z My PictureszMy VideozMy Music)r r& r r< r@ rC rF rJ Nra Úwin32r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)
|
rc rd ÚsysÚplatformÚNotImplementedErrorÚwinregÚOpenKeyÚHKEY_CURRENT_USERÚ QueryValueExrU )rf Úshell_folder_nameri ry ÚkeyÚ directoryÚ_s r Ú get_win_folder_from_registryr · s ð #Ø 0Ø .Ø$ØCØ )Ø#Ø#ñ ÷
|
c*oð ð Ð Ø$ Z LÐ1ÜoÐ Ü
|
||wÒ Ü!Ð!Ûà
|
..×1Ñ1Ð3vÓ
|
wCØ×&Ñ& sÐ,=Ó>LIqÜ y>Ðr c
|
óê ddl }ddddddd d
|
d d j | « }|d | }t |« |j d« }t |d« }|j
|
j d|dd|« t d |D « « r:|j d« }|j j |j |d« r|}| dk( r*t j j |j d« S |j S )zGet folder with ctypes.r Né é# é é é' é é é( é ) r r& r r< rC rF rJ r@ rM ra i Úwindllc 3 ó8 K | ] }t |« d kD yw)éÿ N)Úord)Ú.0Úcs r ú <genexpr>z,get_win_folder_via_ctypes.<locals>.<genexpr>ñ s è ø Ò
|
%A3q6C<Ñ
|
%ùs r@ rn )Úctypesrc rd Úcreate_unicode_bufferÚgetattrÚshell32ÚSHGetFolderPathWÚanyÚkernel32ÚGetShortPathNameWÚvaluer r r! )rf r Ú csidl_constri Úbufr Úbuf2s r Úget_win_folder_via_ctypesr Õ sø ó ð Ø "Ø !ØØ ØØØ Ø"$ñ
|
÷
|
c*oð ð ÐØ$ Z LÐ1ÜoÐ à
|
×
|
&Ñ
|
& tÓ
|
,CÜ VXÓ &FØ
|
NN×#Ñ# D¨+°t¸QÀÔDô Ñ
|
% Ô
|
%Ô%Ø×+Ñ+¨DÓ1Ø ??× ,Ñ ,¨S¯Y©Y¸¸dÔ CØCàÐ&Ò&Üww||CII {Ó3Ð3à 99Ðr c ó dd l } t | d« rt S dd l}t
|
S # t $ r Y w xY w# t $ r t cY S w xY w)Nr r )r Úhasattrr Ú ImportErrorry r rj )r ry s r Ú_pick_get_win_folderr£ ü sV ð-Ûô 68Ô $Ü,Ð ,ð,Ûô ,Ð+øô ò Ù ð ûô ò ,Ü+Ò+ð,ús # 2 £ /®/²AÁA)Úmaxsize)rf rU rT rU )rf rU rT rV )rT zCallable[[str], str])rZ Ú
|
__future__r r rv Ú functoolsr Útypingr Úapir Úcollections.abcr r
|
rj rb r r r£ r Ú__all__r\ r r ú<module>r« sl ðÙ å "ã Û
|
Ý Ý å áÝ(ô|%oô |%ó~ó*ó&ó<$óN ,ð ) 4Ô(Ñ)=Ó)?Ó@ð ð r
|
