§
    %P„jA  ã                  ó  — U d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl	m
Z
mZ ddlmZ e
rdd	lmZ d
Zded<    G d„ de¦  «        Zd)d„Zd*d„Zd)d„Zddddddddddd d!œZd"ed#<   ed+d%„¦   «         Zd)d&„Zd+d'„Z e¦   «         Zd)d(„ZdgZdS ),zWindows.é    )ÚannotationsN)Úcache)ÚPath)ÚTYPE_CHECKINGÚFinalé   )ÚPlatformDirsABC)ÚCallablei @  z
Final[int]Ú_KF_FLAG_DONT_VERIFYc                  ó¨  — e Zd ZdZed%d„¦   «         Zddœd&d
„Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Z	ed%d„¦   «         Z
ed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d„¦   «         Zed%d „¦   «         Zed%d!„¦   «         Zed%d"„¦   «         Zed%d#„¦   «         Zed%d$„¦   «         Z dS )'Ú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>`.

    ÚreturnÚstrc                óš   — | j         rdnd}t          j                             t	          |¦  «        ¦  «        }|                      |¦  «        S )z«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      úY/root/disk_3tb/conda_envs/Huy-visual/lib/python3.11/site-packages/platformdirs/windows.pyÚuser_data_dirzWindows.user_data_dir   sF   € ð $(¤<ÐJ��Ð5JˆÝŒw×Ò¥¨uÑ 5Ô 5Ñ6Ô6ˆØ×!Ò! $Ñ'Ô'Ð'ó    N©Úopinion_valuer   r   ú
str | Nonec               óz  — g }| j         r…| j        dur#| j        p| j         }|                     |¦  «         |                     | j         ¦  «         |�| j        r|                     |¦  «         | j        r|                     | j        ¦  «         t          j        j        |g|¢R Ž }|                      |¦  «         |S )NF)	ÚappnameÚ	appauthorÚappendÚopinionÚversionr   r   ÚjoinÚ_optionally_create_directory)r   r   r   ÚparamsÚauthors        r   r   zWindows._append_parts%   sÁ   € ØˆØŒ<ð 	,ØŒ~ UÐ*Ð*ØœÐ7¨4¬<�Ø—’˜fÑ%Ô%Ð%Ø�MŠM˜$œ,Ñ'Ô'Ð'ØÐ(¨T¬\Ð(Ø—’˜mÑ,Ô,Ð,ØŒ|ð ,Ø—’˜dœlÑ+Ô+Ð+ÝŒwŒ|˜DÐ* 6Ð*Ð*Ð*ˆØ×)Ò)¨$Ñ/Ô/Ð/Øˆr   c                ó„   — t           j                             t          d¦  «        ¦  «        }|                      |¦  «        S )zLData directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``.ÚCSIDL_COMMON_APPDATA©r   r   r   r   r   ©r   r   s     r   Úsite_data_dirzWindows.site_data_dir4   s6   € õ Œw×Ò¥Ð/EÑ FÔ FÑGÔGˆØ×!Ò! $Ñ'Ô'Ð'r   c                ó   — | j         S )z;Config directory tied to the user, same as `user_data_dir`.©r   ©r   s    r   Úuser_config_dirzWindows.user_config_dir:   ó   € ð Ô!Ð!r   c                ó   — | j         S )z:Config directory shared by users, same as `site_data_dir`.©r/   r2   s    r   Úsite_config_dirzWindows.site_config_dir?   r4   r   c                óˆ   — t           j                             t          d¦  «        ¦  «        }|                      |d¬¦  «        S )z¤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_dirzWindows.user_cache_dirD   s;   € õ Œw×Ò¥Ð/DÑ EÔ EÑFÔFˆØ×!Ò! $°gÐ!Ñ>Ô>Ð>r   c                óˆ   — t           j                             t          d¦  «        ¦  «        }|                      |d¬¦  «        S )z\Cache directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname\Cache\$version``.r,   r9   r   r-   r.   s     r   Úsite_cache_dirzWindows.site_cache_dirJ   s;   € õ Œw×Ò¥Ð/EÑ FÔ FÑGÔGˆØ×!Ò! $°gÐ!Ñ>Ô>Ð>r   c                ó   — | j         S )z:State directory tied to the user, same as `user_data_dir`.r1   r2   s    r   Úuser_state_dirzWindows.user_state_dirP   r4   r   c                ó   — | j         S )z9State directory shared by users, same as `site_data_dir`.r6   r2   s    r   Úsite_state_dirzWindows.site_state_dirU   r4   r   c                óŒ   — | j         }| j        r5t          j                             |d¦  «        }|                      |¦  «         |S )z_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_dirzWindows.user_log_dirZ   óD   € ð Ô!ˆØŒ<ð 	4Ý”7—<’<  fÑ-Ô-ˆDØ×-Ò-¨dÑ3Ô3Ð3Øˆr   c                óŒ   — | j         }| j        r5t          j                             |d¦  «        }|                      |¦  «         |S )z^Log directory shared by users, same as `site_data_dir` if not opinionated else ``Logs`` in it.rB   )r/   r%   r   r   r'   r(   r.   s     r   Úsite_log_dirzWindows.site_log_dirc   rD   r   c                óZ   — t           j                             t          d¦  «        ¦  «        S )zFDocuments directory tied to the user e.g. ``%USERPROFILE%\Documents``.ÚCSIDL_PERSONAL©r   r   r   r   r2   s    r   Úuser_documents_dirzWindows.user_documents_dirl   ó#   € õ Œw×Ò¥Ð/?Ñ @Ô @ÑAÔAÐAr   c                óZ   — t           j                             t          d¦  «        ¦  «        S )zFDownloads directory tied to the user e.g. ``%USERPROFILE%\Downloads``.ÚCSIDL_DOWNLOADSrI   r2   s    r   Úuser_downloads_dirzWindows.user_downloads_dirq   s#   € õ Œw×Ò¥Ð/@Ñ AÔ AÑBÔBÐBr   c                óZ   — t           j                             t          d¦  «        ¦  «        S )zDPictures directory tied to the user e.g. ``%USERPROFILE%\Pictures``.ÚCSIDL_MYPICTURESrI   r2   s    r   Úuser_pictures_dirzWindows.user_pictures_dirv   s#   € õ Œw×Ò¥Ð/AÑ BÔ BÑCÔCÐCr   c                óZ   — t           j                             t          d¦  «        ¦  «        S )z@Videos directory tied to the user e.g. ``%USERPROFILE%\Videos``.ÚCSIDL_MYVIDEOrI   r2   s    r   Úuser_videos_dirzWindows.user_videos_dir{   ó"   € õ Œw×Ò¥¨Ñ ?Ô ?Ñ@Ô@Ð@r   c                óZ   — t           j                             t          d¦  «        ¦  «        S )z>Music directory tied to the user e.g. ``%USERPROFILE%\Music``.ÚCSIDL_MYMUSICrI   r2   s    r   Úuser_music_dirzWindows.user_music_dir€   rU   r   c                óZ   — t           j                             t          d¦  «        ¦  «        S )zCDesktop directory tied to the user, e.g. ``%USERPROFILE%\Desktop``.ÚCSIDL_DESKTOPDIRECTORYrI   r2   s    r   Úuser_desktop_dirzWindows.user_desktop_dir…   s#   € õ Œw×Ò¥Ð/GÑ HÔ HÑIÔIÐIr   c                óz   — t           j                             t           j                             d¦  «        ¦  «        S )zEProjects directory tied to the user, e.g. ``%USERPROFILE%\Projects``.z
~/Projects)r   r   r   Ú
expanduserr2   s    r   Úuser_projects_dirzWindows.user_projects_dirŠ   s*   € õ Œw×Ò¥¤× 2Ò 2°<Ñ @Ô @ÑAÔAÐAr   c           
     óä   — t           j                             t           j                             dt          t          d¦  «                             ¦   «         j        dz  ¦  «        ¦  «        ¦  «        S )z0Public share directory e.g. ``C:\Users\Public``.ÚPUBLICú~ÚPublic)	r   r   r   ÚenvironÚgetr   r   r]   Úparentr2   s    r   Úuser_publicshare_dirzWindows.user_publicshare_dir�   sM   € õ Œw×Ò¥¤
§¢¨x½½TÀ#¹Y¼Y×=QÒ=QÑ=SÔ=SÔ=ZÐ]eÑ=eÑ9fÔ9fÑ gÔ gÑhÔhÐhr   c           	     ó    — t           j                             t          t	          t          d¦  «        ¦  «        dz  dz  dz  ¦  «        ¦  «        S )zTTemplates directory tied to the user e.g. ``%APPDATA%\Microsoft\Windows\Templates``.r   Ú	Microsoftr   Ú	Templates©r   r   r   r   r   r   r2   s    r   Úuser_templates_dirzWindows.user_templates_dir”   sC   € õ Œw×Ò¥¥D­¸Ñ)HÔ)HÑ$IÔ$IÈKÑ$WÐZcÑ$cÐfqÑ$qÑ rÔ rÑsÔsÐsr   c           	     ó    — t           j                             t          t	          t          d¦  «        ¦  «        dz  dz  dz  ¦  «        ¦  «        S )zQFonts directory tied to the user e.g. ``%LOCALAPPDATA%\Microsoft\Windows\Fonts``.r   rh   r   ÚFontsrj   r2   s    r   Úuser_fonts_dirzWindows.user_fonts_dir™   sE   € õ Œw×Ò¥¥D­Ð8MÑ)NÔ)NÑ$OÔ$OÐR]Ñ$]Ð`iÑ$iÐlsÑ$sÑ tÔ tÑuÔuÐur   c                ó   — | j         S )zCPreference directory tied to the user, same as ``user_config_dir``.)r3   r2   s    r   Úuser_preference_dirzWindows.user_preference_dirž   s   € ð Ô#Ð#r   c                ó–   — t           j                             t           j                             t	          d¦  «        d¦  «        ¦  «        S )zABin directory tied to the user, e.g. ``%LOCALAPPDATA%\Programs``.r   ÚPrograms©r   r   r   r'   r   r2   s    r   Úuser_bin_dirzWindows.user_bin_dir£   s4   € õ Œw×Ò¥¤§¢­^Ð<QÑ-RÔ-RÐT^Ñ _Ô _Ñ`Ô`Ð`r   c                ó–   — t           j                             t           j                             t	          d¦  «        d¦  «        ¦  «        S )z;Bin directory shared by users, e.g. ``C:\ProgramData\bin``.r,   Úbinrs   r2   s    r   Úsite_bin_dirzWindows.site_bin_dir¨   s4   € õ Œw×Ò¥¤§¢­^Ð<RÑ-SÔ-SÐUZÑ [Ô [Ñ\Ô\Ð\r   c                óZ   — t           j                             t          d¦  «        ¦  «        S )zFApplications directory tied to the user, e.g. ``Start Menu\Programs``.ÚCSIDL_PROGRAMSrI   r2   s    r   Úuser_applications_dirzWindows.user_applications_dir­   rK   r   c                óZ   — t           j                             t          d¦  «        ¦  «        S )zfApplications directory shared by users, e.g. ``C:\ProgramData\Microsoft\Windows\Start Menu\Programs``.ÚCSIDL_COMMON_PROGRAMSrI   r2   s    r   Úsite_applications_dirzWindows.site_applications_dir²   s#   € õ Œw×Ò¥Ð/FÑ GÔ GÑHÔHÐHr   c                óÀ   — t           j                             t           j                             t	          d¦  «        d¦  «        ¦  «        }|                      |¦  «        S )zbRuntime 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_dirzWindows.user_runtime_dir·   sG   € õ Œw×Ò¥¤§¢­^Ð<QÑ-RÔ-RÐTZÑ [Ô [Ñ\Ô\ˆØ×!Ò! $Ñ'Ô'Ð'r   c                ó   — | j         S )z>Runtime directory shared by users, same as `user_runtime_dir`.)r€   r2   s    r   Úsite_runtime_dirzWindows.site_runtime_dir½   s   € ð Ô$Ð$r   )r   r   )r   r   r   r    r   r   )!Ú__name__Ú
__module__Ú__qualname__Ú__doc__Úpropertyr   r   r/   r3   r7   r:   r<   r>   r@   rC   rF   rJ   rN   rQ   rT   rX   r[   r^   rf   rk   rn   rp   rt   rw   rz   r}   r€   r‚   © r   r   r   r      sÛ  € € € € € ðð ð ð(ð (ð (ñ „Xð(ð GKð ð ð ð ð ð ð ð(ð (ð (ñ „Xð(ð
 ð"ð "ð "ñ „Xð"ð ð"ð "ð "ñ „Xð"ð ð?ð ?ð ?ñ „Xð?ð
 ð?ð ?ð ?ñ „Xð?ð
 ð"ð "ð "ñ „Xð"ð ð"ð "ð "ñ „Xð"ð ðð ð ñ „Xðð ðð ð ñ „Xðð ðBð Bð Bñ „XðBð ðCð Cð Cñ „XðCð ðDð Dð Dñ „XðDð ðAð Að Añ „XðAð ðAð Að Añ „XðAð ðJð Jð Jñ „XðJð ðBð Bð Bñ „XðBð ðið ið iñ „Xðið ðtð tð tñ „Xðtð ðvð vð vñ „Xðvð ð$ð $ð $ñ „Xð$ð ðað að añ „Xðað ð]ð ]ð ]ñ „Xð]ð ðBð Bð Bñ „XðBð ðIð Ið Iñ „XðIð ð(ð (ð (ñ „Xð(ð
 ð%ð %ð %ñ „Xð%ð %ð %r   r   Ú
csidl_namer   r   c                óô   — t          | ¦  «        }|�|S ddddœ                     | ¦  «        }|€d| › �}t          |¦  «        ‚t          j                             |¦  «        }|€d|› �}t          |¦  «        ‚|S )z&Get folder from environment variables.NÚAPPDATAÚALLUSERSPROFILEÚLOCALAPPDATA)r   r,   r   úUnknown CSIDL name: zUnset environment variable: )Ú(get_win_folder_if_csidl_name_not_env_varrd   Ú
ValueErrorr   rc   )r‰   ÚresultÚenv_var_nameÚmsgs       r   Úget_win_folder_from_env_varsr”   Ã   s˜   € å5°jÑAÔA€FØÐØˆð #Ø 1Ø-ðð ÷ 
‚cˆ*�o„oð	 ð
 ÐØ1 ZÐ1Ð1ˆÝ˜‰oŒoÐÝŒZ�^Š^˜LÑ)Ô)€FØ€~Ø;¨\Ð;Ð;ˆÝ˜‰oŒoÐØ€Mr   r    c                óš  — | dk    rMt           j                             t           j                             t           j        d         ¦  «        d¦  «        S | dk    rMt           j                             t           j                             t           j        d         ¦  «        d¦  «        S | dk    rMt           j                             t           j                             t           j        d         ¦  «        d¦  «        S | dk    rMt           j                             t           j                             t           j        d         ¦  «        d	¦  «        S | d
k    rMt           j                             t           j                             t           j        d         ¦  «        d¦  «        S | dk    rMt           j                             t           j                             t           j        d         ¦  «        d¦  «        S | dk    rPt           j                             t           j                             t           j        d         ¦  «        dddd¦  «        S | dk    r|t           j                             t           j                             t           j                             dt           j                             dd¦  «        ¦  «        ¦  «        dddd¦  «        S dS )zMGet a folder for a CSIDL name that does not exist as an environment variable.rH   ÚUSERPROFILEÚ	DocumentsrM   Ú	DownloadsrP   ÚPicturesrS   ÚVideosrW   ÚMusicrZ   ÚDesktopry   r‹   rh   r   z
Start Menurr   r|   ÚPROGRAMDATArŒ   zC:\ProgramDataN)r   r   r'   r   rc   rd   ©r‰   s    r   r�   r�   Ø   s  € àÐ%Ò%Ð%ÝŒw�|Š|�BœG×,Ò,­R¬Z¸Ô-FÑGÔGÈÑUÔUÐUàÐ&Ò&Ð&ÝŒw�|Š|�BœG×,Ò,­R¬Z¸Ô-FÑGÔGÈÑUÔUÐUàÐ'Ò'Ð'ÝŒw�|Š|�BœG×,Ò,­R¬Z¸Ô-FÑGÔGÈÑTÔTÐTà�_Ò$Ð$ÝŒw�|Š|�BœG×,Ò,­R¬Z¸Ô-FÑGÔGÈÑRÔRÐRà�_Ò$Ð$ÝŒw�|Š|�BœG×,Ò,­R¬Z¸Ô-FÑGÔGÈÑQÔQÐQàÐ-Ò-Ð-ÝŒw�|Š|�BœG×,Ò,­R¬Z¸Ô-FÑGÔGÈÑSÔSÐSàÐ%Ò%Ð%ÝŒw�|Š|ÝŒG×Ò�RœZ¨	Ô2Ñ3Ô3ØØØØñ
ô 
ð 	
ð Ð,Ò,Ð,ÝŒw�|Š|ÝŒG×Ò�RœZŸ^š^¨M½2¼:¿>º>ÐJ[Ð]nÑ;oÔ;oÑpÔpÑqÔqØØØØñ
ô 
ð 	
ð ˆ4r   c                ó~  — ddh}ddddddd	d
ddddœ                      | ¦  «        }|€d| › �}t          |¦  «        ‚t          j        dk    rt          ‚ddl}| |v r|j        n|j        }|                     |d¦  «        5 }| 	                    ||¦  «        \  }}ddd¦  «         n# 1 swxY w Y   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,   r|   ÚAppDatazCommon AppDatazLocal AppDataÚPersonalú&{374DE290-123F-4565-9164-39C4925E467B}zMy PictureszMy VideozMy Musicrœ   rr   zCommon Programs)r   r,   r   rH   rM   rP   rS   rW   rZ   ry   r|   NrŽ   Úwin32r   z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)rd   r�   ÚsysÚplatformÚNotImplementedErrorÚwinregÚHKEY_LOCAL_MACHINEÚHKEY_CURRENT_USERÚOpenKeyÚQueryValueExr   )	r‰   Úmachine_namesÚshell_folder_namer“   r§   ÚhkeyÚkeyÚ	directoryÚ_s	            r   Úget_win_folder_from_registryr²      sG  € ð 	Øð€Mð
 #Ø 0Ø.Ø$ØCØ)Ø#Ø#Ø"+Ø$Ø!2ðð ÷ 
‚cˆ*�o„oð ð Ð Ø1 ZÐ1Ð1ˆÝ˜‰oŒoÐÝ
„|�wÒÐÝ!Ð!Ø€M€M€Mð )3°mÐ(CÐ(Cˆ6Ô$Ð$ÈÔIa€Dà	�Š˜ÐaÑ	bÔ	bð CÐfiØ×*Ò*¨3Ð0AÑBÔB‰ˆ	�1ðCð Cð Cñ Cô Cð Cð Cð Cð Cð Cð Cøøøð Cð Cð Cð Cåˆy‰>Œ>Ðs   Á?B%Â%B)Â,B)z&{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}r¢   z&{B4BFCC3A-DB2C-424C-B029-7FE99A87C641}z&{A77F5D77-2E2B-44C3-A6A2-ABA601054A51}z&{0139D44E-6AFE-49F2-8690-3DAFCAE6FFB8})r   r,   r   rH   rP   rS   rW   rM   rZ   ry   r|   zdict[str, str]Ú_KNOWN_FOLDER_GUIDSúCallable[[str], str]c                 óD  ‡‡‡‡‡	‡
‡— t           j        dk    rt          ‚ddlm} m}m}m}mŠm	Šm
Š  G ˆfd„d|¦  «        Š |d¦  «        Š	| ‰	j        _        ‰j         |‰¦  «        g‰	j        _        d‰	j        _        ‰j        g‰	j        _         |d¦  «        Š
| ‰
j        _         |‰¦  «        ‰j        ‰j         |‰j        ¦  «        g‰
j        _         |d	¦  «        Š‰j        ‰j        _        ‰j        ‰j        ‰j        g‰j        _        dˆˆˆˆˆ	ˆ
ˆfd„}|S )z’Build the resolver once; a fresh ``_GUID`` per call leaks ctypes pointer types.

    See https://github.com/tox-dev/platformdirs/issues/501.

    r£   r   )ÚHRESULTÚPOINTERÚ	StructureÚWinDLLÚbyrefÚcreate_unicode_bufferÚwintypesc                  óZ   •— e Zd Zd” j        fd” j        fd” j        fd” j        dz  fgZdS )ú/_build_get_win_folder_via_ctypes.<locals>._GUIDÚData1ÚData2ÚData3ÚData4é   N)rƒ   r„   r…   ÚDWORDÚWORDÚBYTEÚ_fields_)r¼   s   €r   Ú_GUIDr¾   I  sC   ø€ € € € € à�h”nÐ%Ø�h”mÐ$Ø�h”mÐ$Ø�h”m aÑ'Ð(ð	
ˆˆˆr   rÈ   Úole32NÚshell32Úkernel32r‰   r   r   c                ó(  •— t                                | ¦  «        }|€d| › �}t          |¦  «        ‚ ‰¦   «         }‰                     | ‰|¦  «        ¦  «         ‰                     ¦   «         }‰                      ‰|¦  «        t          d  ‰|¦  «        ¦  «         |j        }‰                     |¦  «         |€d| › �}t          |¦  «        ‚t          d„ |D ¦   «         ¦  «        r) ‰	d¦  «        }‰
 
                    ||d¦  «        r|j        }|S )NrŽ   z'SHGetKnownFolderPath returned NULL for c              3  ó<   K  — | ]}t          |¦  «        d k    V — ŒdS )éÿ   N)Úord)Ú.0Úcs     r   ú	<genexpr>zD_build_get_win_folder_via_ctypes.<locals>.resolve.<locals>.<genexpr>q  s,   è è € Ð,Ð, �s�1‰vŒv˜Š|Ð,Ð,Ð,Ð,Ð,Ð,r   i   )r³   rd   r�   ÚCLSIDFromStringÚLPWSTRÚSHGetKnownFolderPathr   ÚvalueÚCoTaskMemFreeÚanyÚGetShortPathNameW)r‰   Úfolder_guidr“   ÚguidÚpath_ptrr‘   ÚbufrÈ   rº   r»   rË   rÉ   rÊ   r¼   s          €€€€€€€r   Úresolvez1_build_get_win_folder_via_ctypes.<locals>.resolve_  s'  ø€ Ý)×-Ò-¨jÑ9Ô9ˆØÐØ5¨Ð5Ð5ˆCÝ˜S‘/”/Ð!àˆu‰wŒwˆØ×Ò˜k¨5¨5°©;¬;Ñ7Ô7Ð7à—?’?Ñ$Ô$ˆØ×$Ò$ U U¨4¡[¤[Õ2FÈÈeÈeÐT\ÉoÌoÑ^Ô^Ð^Ø”ˆØ×Ò˜HÑ%Ô%Ð%àˆ>ØH¸JÐHÐHˆCÝ˜S‘/”/Ð!åÐ,Ð, VÐ,Ñ,Ô,Ñ,Ô,ð 	#Ø'Ð'¨Ñ-Ô-ˆCØ×)Ò)¨&°#°tÑ<Ô<ð #Øœ�àˆr   ©r‰   r   r   r   )r¤   r¥   r¦   Úctypesr¶   r·   r¸   r¹   rº   r»   r¼   rÓ   ÚrestypeÚ	LPCOLESTRÚargtypesr×   ÚLPVOIDrÕ   rÄ   ÚHANDLErÔ   rÙ   )r¶   r·   r¸   r¹   rÞ   rÈ   rº   r»   rË   rÉ   rÊ   r¼   s        @@@@@@@r   Ú _build_get_win_folder_via_ctypesræ   6  s½  øøøøøøø€ õ „|�wÒÐÝ!Ð!ðð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð
ð 
ð 
ð 
ð 
ð 
ð 
�	ñ 
ô 
ð 
ð ˆF�7‰OŒO€EØ$+€EÔÔ!Ø&.Ô&8¸'¸'À%¹.¼.Ð%I€EÔÔ"Ø"&€EÔÔØ$,¤OÐ#4€EÔÔ àˆf�YÑÔ€GØ+2€GÔ Ô(Ø-4¨W°U©^¬^¸X¼^ÈXÌ_Ð^eÐ^eÐfnÔfuÑ^vÔ^vÐ,w€GÔ Ô)àˆv�jÑ!Ô!€HØ)1¬€HÔÔ&Ø+3¬?¸H¼OÈXÌ^Ð*\€HÔÔ'ðð ð ð ð ð ð ð ð ð ð ð ð2 €Nr   c                ó0   —  t          ¦   «         | ¦  «        S )z Get folder via :func:`SHGetKnownFolderPath`.

    See https://learn.microsoft.com/en-us/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderpath.

    )ræ   rž   s    r   Úget_win_folder_via_ctypesrè   {  s   € ð .Õ+Ñ-Ô-¨jÑ9Ô9Ð9r   c                 ó€   — 	 ddl } t          S # t          $ r Y nw xY w	 ddl}t          S # t          $ r
 t
          cY S w xY w)zjSelect the best method to resolve Windows folder paths: ctypes, then registry, then environment variables.r   N)rà   rè   ÚImportErrorr§   r²   r”   )rà   r§   s     r   Ú_pick_get_win_folderrë   „  sy   € ð)Øˆˆˆõ )Ð(øõ ð ð ð Øˆðøøøð,Øˆˆˆõ ,Ð+øõ ð ,ð ,ð ,Ý+Ð+Ð+Ð+ð,øøøs   ‚ �
™ž) ©=¼=c                ó¼   — d|                       d¦  «        › �}t          j                             |d¦  «                             ¦   «         x}r|S t          | ¦  «        S )zÓGet 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_Ú )Úremoveprefixr   rc   rd   ÚstripÚ_resolve_win_folder)r‰   Úenv_varÚoverrides      r   r   r   —  s\   € ð E ×!8Ò!8¸Ñ!BÔ!BÐDÐD€GÝ”:—>’> '¨2Ñ.Ô.×4Ò4Ñ6Ô6Ð6€xð ØˆÝ˜zÑ*Ô*Ð*r   rß   )r‰   r   r   r    )r   r´   )r†   Ú
__future__r   r   r¤   Ú	functoolsr   Úpathlibr   Útypingr   r   Úapir	   Úcollections.abcr
   r   Ú__annotations__r   r”   r�   r²   r³   ræ   rè   rë   rò   r   Ú__all__rˆ   r   r   ú<module>rý      sã  ðØ €€à "Ð "Ð "Ð "Ð "Ð "à 	€	€	€	Ø 
€
€
€
Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'à  Ð  Ð  Ð  Ð  Ð  àð )Ø(Ð(Ð(Ð(Ð(Ð(ð $.Ð Ð -Ð -Ð -Ñ -ðl%ð l%ð l%ð l%ð l%ˆoñ l%ô l%ð l%ð^ð ð ð ð*%ð %ð %ð %ðP$ð $ð $ð $ðP >ØDØCØ>Ø@Ø=Ø=Ø?ØFØ>ØEð'ð 'Ð ð ð ð ñ ð ðAð Að Añ „ðAðH:ð :ð :ð :ð,ð ,ð ,ð ,ð  +Ð*Ñ,Ô,Ð ð	+ð 	+ð 	+ð 	+ð ð€€€r   