o ⹏i. @sUdZddlmZddlZddlZddlmZddlmZm Z ddl m Z er-ddl m Z d Zd ed <Gd d d e Zd*ddZd+ddZd*ddZddddddddd d! Zd"ed#<d*d$d%Zd,d'd(Zedd)eZd gZdS)-zWindows.) annotationsN) lru_cache) TYPE_CHECKINGFinal)PlatformDirsABC)Callablei@z Final[int]_KF_FLAG_DONT_VERIFYc@seZdZdZed+ddZddd,d d Zed+d dZed+ddZed+ddZ ed+ddZ ed+ddZ ed+ddZ ed+ddZ ed+ddZed+ddZed+dd Zed+d!d"Zed+d#d$Zed+d%d&Zed+d'd(Zed+d)d*ZdS)-Windowsa `MSDN on where to store app data files `_. Makes use of the `appname `, `appauthor `, `version `, `roaming `, `opinion `, `ensure_exists `. returnstrcCs(|jrdnd}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)selfconstrrQ/home/ubuntu/veenaModal/venv/lib/python3.10/site-packages/platformdirs/windows.py user_data_dirs zWindows.user_data_dirN opinion_valuerr str | NonecCsg}|jr0|jdur|jp|j}||||j|dur'|jr'|||jr0||jtjj|g|R}|||S)NF) appname appauthorappendopinionversionrrjoin_optionally_create_directory)rrrparamsauthorrrrr)s       zWindows._append_partscCstjtd}||S)zT:return: data directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``CSIDL_COMMON_APPDATArrrrrrrrrr site_data_dir8s zWindows.site_data_dircC|jS)zC:return: config directory tied to the user, same as `user_data_dir`rrrrruser_config_dir>zWindows.user_config_dircCr*)zB:return: config directory shared by users, same as `site_data_dir`)r)r,rrrsite_config_dirCr.zWindows.site_config_dircCtjtd}|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`` rCacherr'r(rrruser_cache_dirHszWindows.user_cache_dircCr0)zd:return: cache directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname\Cache\$version``r&r1rr'r(rrrsite_cache_dirQszWindows.site_cache_dircCr*)zB:return: state directory tied to the user, same as `user_data_dir`r+r,rrruser_state_dirWr.zWindows.user_state_dircCs(|j}|jrtj|d}|||S)zg:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in itLogs)rr rrr"r#r(rrr user_log_dir\s  zWindows.user_log_dircCtjtdS)zN:return: documents directory tied to the user e.g. ``%USERPROFILE%\Documents``CSIDL_PERSONALrrrrr,rrruser_documents_direzWindows.user_documents_dircCr7)zN:return: downloads directory tied to the user e.g. ``%USERPROFILE%\Downloads``CSIDL_DOWNLOADSr9r,rrruser_downloads_dirjr;zWindows.user_downloads_dircCr7)zL:return: pictures directory tied to the user e.g. ``%USERPROFILE%\Pictures``CSIDL_MYPICTURESr9r,rrruser_pictures_diror;zWindows.user_pictures_dircCr7)zH:return: videos directory tied to the user e.g. ``%USERPROFILE%\Videos`` CSIDL_MYVIDEOr9r,rrruser_videos_dirtr;zWindows.user_videos_dircCr7)zF:return: music directory tied to the user e.g. ``%USERPROFILE%\Music`` CSIDL_MYMUSICr9r,rrruser_music_diryr;zWindows.user_music_dircCr7)zK:return: desktop directory tied to the user, e.g. ``%USERPROFILE%\Desktop``CSIDL_DESKTOPDIRECTORYr9r,rrruser_desktop_dir~r;zWindows.user_desktop_dircCs$tjtjtdd}||S)z :return: runtime directory tied to the user, e.g. ``%USERPROFILE%\AppData\Local\Temp\$appauthor\$appname`` rTemp)rrrr"rrr(rrruser_runtime_dirs zWindows.user_runtime_dircCr*)zF:return: runtime directory shared by users, same as `user_runtime_dir`)rGr,rrrsite_runtime_dirr.zWindows.site_runtime_dir)r r )rr rrr r )__name__ __module__ __qualname____doc__propertyrrr)r-r/r2r3r4r6r:r=r?rArCrErGrHrrrrr sF                r csidl_namer r cCsjt|}|dur |Sdddd|}|dur d|}t|tj|}|dur3d|}t||S)z&Get folder from environment variables.NAPPDATAALLUSERSPROFILE LOCALAPPDATA)r r&rUnknown CSIDL name: zUnset environment variable: )(get_win_folder_if_csidl_name_not_env_varget ValueErrorrenviron)rNresult env_var_namemsgrrrget_win_folder_from_env_varss"   rZrcCs|dkrtjtjtjddS|dkr$tjtjtjddS|dkr6tjtjtjddS|dkrHtjtjtjdd S|d krZtjtjtjdd Sd S) zMGet a folder for a CSIDL name that does not exist as an environment variable.r8 USERPROFILE Documentsr< Downloadsr>Picturesr@VideosrBMusicN)rrr"rrV)rNrrrrSsrSc Csdh}dddddddd d |}|d urd |}t|tjd kr%tdd l}||vr0|jn|j}||d}| ||\}}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. r&AppDatazCommon AppDataz Local AppDataPersonal&{374DE290-123F-4565-9164-39C4925E467B}z My PictureszMy VideozMy Music)r r&rr8r<r>r@rBNrRwin32rz@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders) rTrUsysplatformNotImplementedErrorwinregHKEY_LOCAL_MACHINEHKEY_CURRENT_USEROpenKey QueryValueExr ) rN machine_namesshell_folder_namerYrhhkeykey directory_rrrget_win_folder_from_registrys.     rsz&{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}rcz&{B4BFCC3A-DB2C-424C-B029-7FE99A87C641}) r r&rr8r>r@rBr<rDzdict[str, str]_KNOWN_FOLDER_GUIDScstjdkrtddlm}m}m}m}m}m }m Gfddd|}|d}||j _ j ||g|j _d|j_ jg|j_|d} || j_ ||jj|jg| j_|d } j| j_ jjjg| j_t|} | durzd |} t| |} | | || }| || td|||j}|||durd |} t| td d |Dr|d}| ||dr|j}|S)z Get folder via :func:`SHGetKnownFolderPath`. See https://learn.microsoft.com/en-us/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderpath. rdr)HRESULTPOINTER StructureWinDLLbyrefcreate_unicode_bufferwintypescs4eZdZdjfdjfdjfdjdfgZdS)z(get_win_folder_via_ctypes.._GUIDData1Data2Data3Data4N)rIrJrKDWORDWORDBYTE_fields_rr{rr_GUIDs  role32Nshell32kernel32rRz'SHGetKnownFolderPath returned NULL for css|] }t|dkVqdS)N)ord).0crrr sz,get_win_folder_via_ctypes..i)rerfrgctypesrurvrwrxryrzr{CLSIDFromStringrestype LPCOLESTRargtypes CoTaskMemFreeLPVOIDSHGetKnownFolderPathrHANDLELPWSTRGetShortPathNameWrtrTrUr valueany)rNrurvrwrxryrzrrrr folder_guidrYguidpath_ptrrWbufrrrget_win_folder_via_ctypessB $      rCallable[[str], str]cCsHzddl}WtStyYnwzddl}WtSty#tYSw)zjSelect the best method to resolve Windows folder paths: ctypes, then registry, then environment variables.rN)r ImportErrorrrhrZrs)rrhrrr_pick_get_win_folder%s    r)maxsize)rNr r r )rNr r r)r r)rL __future__rrre functoolsrtypingrrapircollections.abcrr __annotations__r rZrSrsrtrrr__all__rrrrs:        % :