j8 UdZddlmZddlZddlZddlmZmZddlm Z erddl m Z dZ d e d <Gd d e Zd&dZd'dZd&dZdddddddddddd Zd e d!<d&d"Zd(d$ZeZd&d%Zd gZdS))zWindows.) annotationsN) TYPE_CHECKINGFinal)PlatformDirsABC)Callablei@z Final[int]_KF_FLAG_DONT_VERIFYc0eZdZdZed dZddd!d Zed d Zed d Zed d Z ed dZ ed dZ ed dZ ed dZ ed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZed dZdS)"Windowsa`MSDN on where to store app data files `_. Makes use of the `appname `, `appauthor `, `version `, `roaming `, `opinion `, `ensure_exists `. returnstrc|jrdnd}tjt |}||S)z:returns: 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)selfconstrs a/var/www/finuniver-perm.ru/html/student/venv/lib/python3.11/site-packages/platformdirs/windows.py user_data_dirzWindows.user_data_dirsF$(<J5Jwu 5 566!!$'''N opinion_valuerr str | Noneczg}|jr|jdur#|jp|j}||||j||jr|||jr||jt jj|g|R}|||S)NF) appname appauthorappendopinionversionrrjoin_optionally_create_directory)rrrparamsauthors rrzWindows._append_parts#s < ,~U**74< f%%% MM$, ' ' '(T\( m,,,| , dl+++w|D*6*** ))$/// rctjtd}||S)zU:returns: data directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``CSIDL_COMMON_APPDATArrrrrrrs r site_data_dirzWindows.site_data_dir2s6w/E F FGG!!$'''rc|jS)zD:returns: config directory tied to the user, same as `user_data_dir`rrs ruser_config_dirzWindows.user_config_dir8 !!rc|jS)zC:returns: config directory shared by users, same as `site_data_dir`r-r0s rsite_config_dirzWindows.site_config_dir=r2rctjtd}||dS)z:returns: cache 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_dirBs;w/D E EFF!!$g!>>>rctjtd}||dS)ze:returns: cache directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname\Cache\$version``r*r7rr+r,s rsite_cache_dirzWindows.site_cache_dirHs;w/E F FGG!!$g!>>>rc|jS)zC:returns: state directory tied to the user, same as `user_data_dir`r/r0s ruser_state_dirzWindows.user_state_dirNr2rc|jS)zB:returns: state directory shared by users, same as `site_data_dir`r4r0s rsite_state_dirzWindows.site_state_dirSr2rc|j}|jr5tj|d}|||S)zh:returns: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in itLogs)rr#rrr%r&r,s r user_log_dirzWindows.user_log_dirXD! < 47<<f--D  - -d 3 3 3 rc|j}|jr5tj|d}|||S)zg:returns: log directory shared by users, same as `site_data_dir` if not opinionated else ``Logs`` in itr@)r-r#rrr%r&r,s r site_log_dirzWindows.site_log_dirarBrcZtjtdS)zO:returns: documents directory tied to the user e.g. ``%USERPROFILE%\Documents``CSIDL_PERSONALrrrrr0s ruser_documents_dirzWindows.user_documents_dirj#w/? @ @AAArcZtjtdS)zO:returns: downloads directory tied to the user e.g. ``%USERPROFILE%\Downloads``CSIDL_DOWNLOADSrGr0s ruser_downloads_dirzWindows.user_downloads_diros#w/@ A ABBBrcZtjtdS)zM:returns: pictures directory tied to the user e.g. ``%USERPROFILE%\Pictures``CSIDL_MYPICTURESrGr0s ruser_pictures_dirzWindows.user_pictures_dirts#w/A B BCCCrcZtjtdS)zI:returns: videos directory tied to the user e.g. ``%USERPROFILE%\Videos`` CSIDL_MYVIDEOrGr0s ruser_videos_dirzWindows.user_videos_diry"w ? ?@@@rcZtjtdS)zG:returns: music directory tied to the user e.g. ``%USERPROFILE%\Music`` CSIDL_MYMUSICrGr0s ruser_music_dirzWindows.user_music_dir~rSrcZtjtdS)zL:returns: desktop directory tied to the user, e.g. ``%USERPROFILE%\Desktop``CSIDL_DESKTOPDIRECTORYrGr0s ruser_desktop_dirzWindows.user_desktop_dirs#w/G H HIIIrctjtjt ddS)zJ:returns: bin directory tied to the user, e.g. ``%LOCALAPPDATA%\Programs``rProgramsrrrr%rr0s r user_bin_dirzWindows.user_bin_dirs4w ^rArDrHrLrOrRrVrYr]r`rcrfrirkrrr r s+(((X( GK      (((X( """X""""X"???X? ???X? """X""""X"XXBBBXBCCCXCDDDXDAAAXAAAAXAJJJXJaaaXa]]]X]BBBXBIIIXI(((X( %%%X%%%rr csidl_namer r ct|}||Sdddd|}|d|}t|tj|}|d|}t||S)z&Get folder from environment variables.NAPPDATAALLUSERSPROFILE LOCALAPPDATA)rr*rUnknown CSIDL name: zUnset environment variable: )(get_win_folder_if_csidl_name_not_env_varget ValueErrorrenviron)rrresult env_var_namemsgs rget_win_folder_from_env_varsrs 5j A AF  # 1- c*oo  1Z11oo Z^^L ) )F ~;\;;oo Mrrc |dkrMtjtjtjddS|dkrMtjtjtjddS|dkrMtjtjtjddS|dkrMtjtjtjdd S|d krMtjtjtjdd S|d krPtjtjtjd ddddS|dkr|tjtjtjdtjddddddSdS)zMGet a folder for a CSIDL name that does not exist as an environment variable.rF USERPROFILE DocumentsrK DownloadsrNPicturesrQVideosrUMusicrbrt Microsoftr z Start Menur[re PROGRAMDATAruzC:\ProgramDataN)rrr%rr{ry)rrs rrxrxs%%%w||BG,,RZ -FGGUUU&&&w||BG,,RZ -FGGUUU'''w||BG,,RZ -FGGTTT_$$w||BG,,RZ -FGGRRR_$$w||BG,,RZ -FGGQQQ%%%w|| G  RZ 2 3 3        ,,,w|| G  RZ^^M2:>>J[]n;o;opp q q         4rc Lddh}ddddddd d d d d |}|d|}t|tjdkrtddl}||vr|jn|j}||d}| ||\}}t|S)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*reAppDatazCommon AppDataz Local AppDataPersonal&{374DE290-123F-4565-9164-39C4925E467B}z My PictureszMy VideozMy Musicr[zCommon Programs) rr*rrFrKrNrQrUrbreNrwwin32rz@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders) ryrzsysplatformNotImplementedErrorwinregHKEY_LOCAL_MACHINEHKEY_CURRENT_USEROpenKey QueryValueExr ) rr machine_namesshell_folder_namer~rhkeykey directory_s rget_win_folder_from_registryrs M # 0.$C)##$!2   c*oo 1Z11oo |w!!MMM)3m(C(C6 $ $IaD ..b c cC&&s,=>>LIq y>>rz&{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}) rr*rrFrNrQrUrKrXrbrezdict[str, str]_KNOWN_FOLDER_GUIDSc@tjdkrtddlm}m}m}m}m}m }m Gfdd|}|d}||j _ j ||g|j _d|j_ jg|j_|d} || j_ ||jj|jg| j_|d } j| j_ jjjg| j_t,|} | d |} t1| |} | | || }| || t2d|||j}|||d |} t1| t7d |Dr)|d }| ||d r|j}|S)zGet folder via :func:`SHGetKnownFolderPath`. See https://learn.microsoft.com/en-us/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderpath. rr)HRESULTPOINTER StructureWinDLLbyrefcreate_unicode_bufferwintypescZeZdZdjfdjfdjfdjdzfgZdS)(get_win_folder_via_ctypes.._GUIDData1Data2Data3Data4N)rlrmrnDWORDWORDBYTE_fields_)rsr_GUIDr!sC hn % hm $ hm $ hma' (  rrole32Nshell32kernel32rwz'SHGetKnownFolderPath returned NULL for c3<K|]}t|dkVdS)N)ord).0cs r z,get_win_folder_via_ctypes..Hs, ( (A3q66C< ( ( ( ( ( (ri)rrrctypesrrrrrrrCLSIDFromStringrestype LPCOLESTRargtypes CoTaskMemFreeLPVOIDSHGetKnownFolderPathrHANDLELPWSTRGetShortPathNameWrryrzr valueany)rrrrrrrrrrrr folder_guidr~guidpath_ptrr|bufrs @rget_win_folder_via_ctypesrst  |w!!bbbbbbbbbbbbbbbbbb           F7OOE$+E!&.&8''%..%IE""&E$,O#4E fYG+2G (-4WU^^X^X_^e^efnfu^v^v,wG )vj!!H)1H&+3?HOX^*\H'%))*55K1Z11oo 577D +uuT{{333  H   t.BD%%PX//ZZZ ^F !!! ~D DDoo ( ( ( ( (((##D))  % %fc4 8 8 YF MrCallable[[str], str]c 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_folderrPsy) )(      , ,+ ,,,++++,s )==cd|d}tj|dx}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_) removeprefixrr{rystrip_resolve_win_folder)rrenv_varoverrides rrrcs\ E!8!8!B!BDDG:>>'2..44666x z * **r)rrr r r )rrr r r)r r)ro __future__rrrtypingrrapircollections.abcrr __annotations__r rrxrrrrrr__all__rqrrrs"""""" '''''''' )(((((($.----S%S%S%S%S%oS%S%S%l*""""J####N>DC>@==?F>E ' '    6666r , , , , +*,, + + + + r