a oe@sddlmZddlZddlZddlZddlmZddlmZddl m Z Gddde Z d d d d d Z d d d d dZ d d d ddZddddZeddeZdgZdS)) annotationsN) lru_cache)Callable)PlatformDirsABCc@seZdZdZeddddZdddddd d d Zeddd d ZeddddZeddddZ eddddZ eddddZ eddddZ eddddZ eddddZdS)Windowsa`MSDN on where to store app data files `_. Makes use of the `appname `, `appauthor `, `version `, `roaming `, `opinion `.strreturncCs(|jr dnd}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)Zroamingospathnormpathget_win_folder _append_parts)selfconstrrKC:\Program Files\Certbot\pkgs\pkg_resources\_vendor\platformdirs\windows.py user_data_dirszWindows.user_data_dirN opinion_valuez str | None)rrr cCstg}|jr`|jdur*|jp|j}||||j|durN|jrN|||jr`||jtjj|g|RS)NF)ZappnameZ appauthorappendopinionversionr rjoin)rrrparamsZauthorrrrr!s      zWindows._append_partscCstjtd}||S)zT:return: data directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``CSIDL_COMMON_APPDATAr rrrrrrrrr site_data_dir.szWindows.site_data_dircCs|jS)zC:return: config directory tied to the user, same as `user_data_dir`rrrrruser_config_dir4szWindows.user_config_dircCs|jS)zF:return: config directory shared by the users, same as `site_data_dir`)r!r#rrrsite_config_dir9szWindows.site_config_dircCstjtd}|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`` r ZCacherrr rrruser_cache_dir>szWindows.user_cache_dircCs|jS)zB:return: state directory tied to the user, same as `user_data_dir`r"r#rrruser_state_dirGszWindows.user_state_dircCs|j}|jrtj|d}|S)zy :return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it ZLogs)rrr rrr rrr user_log_dirLszWindows.user_log_dircCstjtdS)z` :return: documents directory tied to the user e.g. ``%USERPROFILE%\Documents`` CSIDL_PERSONAL)r rrrr#rrruser_documents_dirVszWindows.user_documents_dircCs$tjtjtdd}||S)z :return: runtime directory tied to the user, e.g. ``%USERPROFILE%\AppData\Local\Temp\$appauthor\$appname`` r ZTemp)r rrrrrr rrruser_runtime_dir]szWindows.user_runtime_dir)__name__ __module__ __qualname____doc__propertyrrr!r$r%r&r'r(r*r+rrrrr s(    rr) csidl_namer cCsr|dkr$tjtjtjddSdddd|}|durLtd |tj|}|durntd ||S) z&Get folder from environment variables.r) USERPROFILEZ DocumentsAPPDATAZALLUSERSPROFILEZ LOCALAPPDATA)r rr NUnknown CSIDL name: zUnset environment variable: )r rrrenvironget ValueError)r1Z env_var_nameresultrrrget_win_folder_from_env_varsgs r9cCsfddddd|}|dur*td|tjdkr8td dl}||jd }|||\}}t |S) zGet folder from the registry. This is a fallback technique at best. I'm not sure if using the registry for this guarantees us the correct answer for all CSIDL_* names. ZAppDatazCommon AppDataz Local AppDataZPersonalr rr r)Nr4win32rz@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders) r6r7sysplatformNotImplementedErrorwinregOpenKeyHKEY_CURRENT_USER QueryValueExr)r1Zshell_folder_namer?keyZ directory_rrrget_win_folder_from_registryys rEcCsddddd|}|dur*td|td}ttd }|jd|dd |td d |Drtd}|j |j |dr|}|j S) zGet folder with ctypes.#r:Nr4iwindllrcss|]}t|dkVqdS)N)ord).0crrr z,get_win_folder_via_ctypes..) r6r7ctypesZcreate_unicode_buffergetattrZshell32ZSHGetFolderPathWanyZkernel32ZGetShortPathNameWvalue)r1Z csidl_constbufrJZbuf2rrrget_win_folder_via_ctypess"   rVzCallable[[str], str]r cCs:ttdrtSz ddl}Wnty0tYS0tSdS)NrJr)hasattrrQrVr? ImportErrorr9rE)r?rrr_pick_get_win_folders    rY)maxsize)Z __future__rrQr r< functoolsrtypingrZapirrr9rErVrYr__all__rrrrs    [