їj@JUdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z m Z ddl mZe rdd lmZd Zd ed <Gd deZd5dZd6dZdddddddddd Zded<d7dZd5dZdd d!d"d#d$d%d&d'd(d)d*d+d,d-Zd.ed/<ed8d0Zd5d1Zd8d2ZeZd5d3Zd9d4ZdgZ y):zWindows.) annotationsN)cache)Path) TYPE_CHECKINGFinal)PlatformDirsABC)Callablei@z Final[int]_KF_FLAG_DONT_VERIFYceZdZdZed dZddd!dZed dZed dZed dZ ed d Z ed d Z ed d Z ed d Z ed d Zed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZ y)"Windowsa`MSDN on where to store app data files `_. Makes use of the `appname `, `appauthor `, `version `, `roaming `, `opinion `, `ensure_exists `. c|jrdnd}tjjt |}|j |S)zData 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)selfconstrs YC:\Users\pivot\Documents\cueki\casual-preloader\Lib\site-packages\platformdirs/windows.py user_data_dirzWindows.user_data_dirs<$(<<5Jwwu 56!!$''N opinion_valuecg}|jr|jdur+|jxs |j}|j||j|j||jr|j||jr|j|jt j j|g|}|j|d|S)NFprivate) appname appauthorappendopinionversionrrjoin_optionally_create_directory)rrrparamsauthors rrzWindows._append_parts&s <<~~U*74<< f% MM$,, '(T\\ m,|| dll+ww||D*6* ))$)> rcttjjtd}|j |S)zLData directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``.CSIDL_COMMON_APPDATArrrrrrrs r site_data_dirzWindows.site_data_dir5s/ww/E FG!!$''rc|jS)z;Config directory tied to the user, same as `user_data_dir`.rrs ruser_config_dirzWindows.user_config_dir;!!!rc|jS)z:Config directory shared by users, same as `site_data_dir`.r.r1s rsite_config_dirzWindows.site_config_dir@r3rcxtjjtd}|j |dS)zCache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g. ``%USERPROFILE%\AppData\Local\$appauthor\$appname\Cache\$version``.rCacherr,r-s ruser_cache_dirzWindows.user_cache_dirEs4ww/D EF!!$g!>>rcxtjjtd}|j |dS)z\Cache directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname\Cache\$version``.r+r8rr,r-s rsite_cache_dirzWindows.site_cache_dirKs4ww/E FG!!$g!>>rc|jS)z:State directory tied to the user, same as `user_data_dir`.r0r1s ruser_state_dirzWindows.user_state_dirQr3rc|jS)z9State directory shared by users, same as `site_data_dir`.r5r1s rsite_state_dirzWindows.site_state_dirVr3rc|j}|jr3tjj |d}|j |d|S)z_Log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it.LogsFr)rr$rrr&r'r-s r user_log_dirzWindows.user_log_dir[B!! <<77<<f-D  - -dE - B rc|j}|jr3tjj |d}|j |d|S)z^Log directory shared by users, same as `site_data_dir` if not opinionated else ``Logs`` in it.rAFr)r.r$rrr&r'r-s r site_log_dirzWindows.site_log_dirdrCrcRtjjtdS)zFDocuments directory tied to the user e.g. ``%USERPROFILE%\Documents``.CSIDL_PERSONALrrrrr1s ruser_documents_dirzWindows.user_documents_dirmww/? @AArcRtjjtdS)zFDownloads directory tied to the user e.g. ``%USERPROFILE%\Downloads``.CSIDL_DOWNLOADSrHr1s ruser_downloads_dirzWindows.user_downloads_dirrww/@ ABBrcRtjjtdS)zDPictures directory tied to the user e.g. ``%USERPROFILE%\Pictures``.CSIDL_MYPICTURESrHr1s ruser_pictures_dirzWindows.user_pictures_dirwsww/A BCCrcRtjjtdS)z@Videos directory tied to the user e.g. ``%USERPROFILE%\Videos``. CSIDL_MYVIDEOrHr1s ruser_videos_dirzWindows.user_videos_dir|ww ?@@rcRtjjtdS)z>Music directory tied to the user e.g. ``%USERPROFILE%\Music``. CSIDL_MYMUSICrHr1s ruser_music_dirzWindows.user_music_dirrUrcRtjjtdS)zCDesktop directory tied to the user, e.g. ``%USERPROFILE%\Desktop``.CSIDL_DESKTOPDIRECTORYrHr1s ruser_desktop_dirzWindows.user_desktop_dirsww/G HIIrcztjjtjjdS)zEProjects directory tied to the user, e.g. ``%USERPROFILE%\Projects``.z ~/Projects)rrr expanduserr1s ruser_projects_dirzWindows.user_projects_dirs(ww 2 2< @AArcRtjjtdS)z0Public share directory e.g. ``C:\Users\Public``. CSIDL_PUBLICrHr1s ruser_publicshare_dirzWindows.user_publicshare_dirsww~ >??rcRtjjtdS)zTTemplates directory tied to the user e.g. ``%APPDATA%\Microsoft\Windows\Templates``.CSIDL_TEMPLATESrHr1s ruser_templates_dirzWindows.user_templates_dirrNrc tjjtt t ddz dz dz S)zQFonts directory tied to the user e.g. ``%LOCALAPPDATA%\Microsoft\Windows\Fonts``.r Microsoftr Fonts)rrrstrrrr1s ruser_fonts_dirzWindows.user_fonts_dirs;wwD8M)N$OR]$]`i$ils$s tuurc|jS)zCPreference directory tied to the user, same as ``user_config_dir``.)r2r1s ruser_preference_dirzWindows.user_preference_dirs###rcRtjjtdS)zABin directory tied to the user, e.g. ``%LOCALAPPDATA%\Programs``.CSIDL_USER_PROGRAM_FILESrHr1s r user_bin_dirzWindows.user_bin_dirsww/I JKKrctjjtjjt ddS)z;Bin directory shared by users, e.g. ``C:\ProgramData\bin``.r+bin)rrrr&rr1s r site_bin_dirzWindows.site_bin_dirs/ww ^Runtime directory shared by users, same as `user_runtime_dir`.)rzr1s rsite_runtime_dirzWindows.site_runtime_dirs$$$r)returnrh)rrhr str | Noner}rh)!__name__ __module__ __qualname____doc__propertyrrr.r2r6r9r;r=r?rBrErIrMrQrTrXr[r^rardrirkrnrqrtrwrzr|rrr r sK(( GK (( """"?? ?? """"BBCCDDAAAAJJBB@@CCvv$$LL]]BBII(( %%rr ct|}||Sddddj|}|d|}t|tjj|x}sd|}t||S)z&Get folder from environment variables.APPDATAALLUSERSPROFILE LOCALAPPDATA)rr+rUnknown CSIDL name: zUnset environment variable: )(get_win_folder_if_csidl_name_not_env_varget ValueErrorrenviron) csidl_nameresult env_var_namemsgs rget_win_folder_from_env_varsrs 5j AF  # 1- c*o  $ZL1ojjnn\2 2F 2,\N;o Mrc~tj|x}J|^}}tjjtjj t |g|S|dk(rPtjjdxs/ttdjjdz S|dk(rtjj tjj tjjdxs#tjjdxsd d d d d Sy)zMGet a folder for a CSIDL name that does not exist as an environment variable.Nr`PUBLIC~Publicrv PROGRAMDATArzC:\ProgramDatarfr Start MenuPrograms) _ENV_VAR_SUBFOLDERSrrrr&r_non_empty_envrrhrr]parent)renv_var_and_partsenv_varpartss rrrs044Z@@M+%ww||BGG,,^G-DENNN^#zz~~h'X3tCy/C/C/E/L/Lx/W+XX,,ww|| GG  RZZ^^M:tbjjnnM^>_tct u        r) USERPROFILE Documents)r Downloads)rPictures)rVideos)rMusic)rDesktop)rrfr rr)rrfr Templates)rr) rGrLrPrSrWrZrsrcrmz!Final[dict[str, tuple[str, ...]]]rc^tjj|x}r|St|)N)rrrKeyError)namevalues rrrs) t$$u$ 4.rc tddh}ddddddd d d d d dd j|}| t|Stjdk7rtddl}||vr |j n |j}|j|d5}|j||\}}dddt|S#1swYtSxYw)zGet 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. r+rvAppDatazCommon AppDataz Local AppDataPersonal&{374DE290-123F-4565-9164-39C4925E467B}z My PictureszMy VideozMy MusicrrzCommon Programsr) rr+rrGrLrPrSrWrZrsrvrcNwin32rz@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders) rrsysplatformNotImplementedErrorwinregHKEY_LOCAL_MACHINEHKEY_CURRENT_USEROpenKey QueryValueExrh)r machine_namesshell_folder_namerhkeykey directory_s rget_win_folder_from_registryrs M # 0.$C)##"+$!2&  c*o +J77 ||w!!)3m(C6 $ $IaIaD a bfi**30AB 1 c y> c y>s ;B$$B7z&{3EB685DB-65F9-4CF6-A03A-E3EF65729F3D}z&{62AB5D82-FDC1-4DC3-A9DD-070D1D495D97}z&{F1B32785-6FBA-4FCF-9D55-7B8E7F157091}z&{FDD39AD0-238F-46AF-ADB4-6C85480369C7}z&{33E28130-4E1E-4676-835A-98395C3BC3BB}z&{18989B1D-99B5-455B-841C-AB7C74E4DDFC}z&{4BD8D571-6D19-48D3-BE97-422220080E43}rz&{B4BFCC3A-DB2C-424C-B029-7FE99A87C641}z&{A77F5D77-2E2B-44C3-A6A2-ABA601054A51}z&{0139D44E-6AFE-49F2-8690-3DAFCAE6FFB8}z&{A63293E8-664E-48DB-A079-DF759E0509F7}z&{DFDF76A2-C82A-4D63-906A-5644AC457385}z&{5CD7AEE2-2219-4A67-B85D-6C9CE15660CB})rr+rrGrPrSrWrLrZrsrvrcr`rmzdict[str, str]_KNOWN_FOLDER_GUIDSc tjdk7rtddlm}m}m}m}mm G fdd||d|j_ j|gj_ dj_ jgj_ |d|j _ | j" j$| j&gj _ d  fd }|S) zBuild the resolver once; a fresh ``_GUID`` per call leaks ctypes pointer types. See https://github.com/tox-dev/platformdirs/issues/501. rr)HRESULTPOINTER StructureWinDLLbyrefwintypesceZdZdWjfdWjfdWjfdWj dzfgZy)/_build_get_win_folder_via_ctypes.._GUIDData1Data2Data3Data4N)rrrDWORDWORDBYTE_fields_)rsr_GUIDrJs? hnn % hmm $ hmm $ hmma' (  rrole32Nshell32cZtj|}|d|}t|}j|| j } j |t d||j}j||d|}t||S)Nrz'SHGetKnownFolderPath returned NULL for ) rrrCLSIDFromStringLPWSTRSHGetKnownFolderPathr r CoTaskMemFree) r folder_guidrguidpath_ptrrrrrrrs rresolvez1_build_get_win_folder_via_ctypes..resolve\s)--j9  ( 5CS/ !w k5;7??$$$U4[2FeT\o^ H% >;J<HCS/ ! rrrhr}rh)rrrctypesrrrrrrrrestype LPCOLESTRargtypesrLPVOIDrrHANDLEr) rrrrrrrrrrs @@@@@r _build_get_win_folder_via_ctypesr8s ||w!!   7OE$+E!&.&8&8'%.%IE""&E$,OO#4E YG+2G  (-4U^X^^X__^efnfufu^v,wG  )( Nrc"t|S)zGet folder via :func:`SHGetKnownFolderPath`. See https://learn.microsoft.com/en-us/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderpath. )r)rs rget_win_folder_via_ctypesrss . + -j 99rcv ddl}tS#t$rYnwxYw ddl}tS#t$r t cYSwxYw)zjSelect the best method to resolve Windows folder paths: ctypes, then registry, then environment variables.rN)rr ImportErrorrrr)rrs r_pick_get_win_folderr|sM))(    ,,+ ,++,s &88cd|jd}ttjj |dj x}r|St |S)zGet a Windows folder path, checking for ``WIN_PD_OVERRIDE_*`` environment variable overrides first. For example, ``CSIDL_LOCAL_APPDATA`` can be overridden by setting ``WIN_PD_OVERRIDE_LOCAL_APPDATA``. WIN_PD_OVERRIDE_CSIDL_) removeprefix_is_fully_qualifiedrrrstrip_resolve_win_folder)rroverrides rrrsQ !!8!8!B CDGrzz~~gr'B'H'H'JJ8K z **rctj|\}}|jdxst|xr|jdS)N)\/)ntpath splitdrive startswithbool)rdrivetails rrrs>##D)KE4   K ( ZT%[-YT__[=YZrr)rrhr}r~)rrhr}rh)r}zCallable[[str], str])rrhr}r)!r __future__rrrr functoolsrpathlibrtypingrrapir collections.abcr r __annotations__r rrrrrrrrrrrr__all__rrrrs" ' ($.j-l%ol%^(*333.-8SG < :6  $P>DC>@==?F>E?< H'^$77t: , +, +[ r