a
    ö£BeW  ã                   @  sX  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
 ddl	mZ er„dd	lmZ ejd
krxddlmZ nddlmZ ddœdd„Zeƒ ZeZd[dddddddœdd„Zd\dddddddœdd„Zd]dddddddœdd„Zd^dddddddœdd„Zd_ddddddd œd!d"„Zd`ddddddd œd#d$„Zdadddddddœd%d&„Zdbddddddd œd'd(„Zddœd)d*„Zddœd+d,„Zddœd-d.„Zddœd/d0„Z ddœd1d2„Z!ddœd3d4„Z"dcddddddd œd5d6„Z#ddddddddd œd7d8„Z$dedddddd9dœd:d;„Z%dfdddddd9dœd<d=„Z&dgdddddd9dœd>d?„Z'dhdddddd9dœd@dA„Z(didddddd9d œdBdC„Z)djdddddd9d œdDdE„Z*dkdddddd9dœdFdG„Z+dldddddd9d œdHdI„Z,d9dœdJdK„Z-d9dœdLdM„Z.d9dœdNdO„Z/d9dœdPdQ„Z0d9dœdRdS„Z1d9dœdTdU„Z2dmdddddd9d œdVdW„Z3dndddddd9d œdXdY„Z4g dZ¢Z5dS )oz€
Utilities for determining application-specific dirs. See <https://github.com/platformdirs/platformdirs> for details and
usage.
é    )ÚannotationsN)ÚTYPE_CHECKINGé   )ÚPlatformDirsABC)Ú__version__)Ú__version_tuple__)ÚPath)é   é   )ÚLiteralztype[PlatformDirsABC])Úreturnc                  C  sš   t jdkrddlm}  n$t jdkr0ddlm}  nddlm}  t 	d¡dkr–t 	d	¡d
kr–t 	d¡slt 	d¡rp| S ddl
m} |ƒ d ur–ddl
m} |S | S )NÚwin32r   )ÚWindowsÚdarwin)ÚMacOS)ÚUnixÚANDROID_DATAz/dataÚANDROID_ROOTz/systemÚSHELLÚPREFIX)Ú_android_folder)ÚAndroid)ÚsysÚplatformZplatformdirs.windowsr   Zplatformdirs.macosr   Zplatformdirs.unixr   ÚosÚgetenvZplatformdirs.androidr   r   )ÚResultr   r   © r   úX/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/platformdirs/__init__.pyÚ_set_platform_dir_class   s    


r   Fz
str | Nonezstr | None | Literal[False]ÚboolÚstr)ÚappnameÚ	appauthorÚversionÚroamingÚensure_existsr   c                 C  s   t | ||||d�jS )aÑ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: data directory tied to the user
    ©r"   r#   r$   r%   r&   )ÚPlatformDirsÚuser_data_dirr'   r   r   r   r)   2   s    ûr)   )r"   r#   r$   Ú	multipathr&   r   c                 C  s   t | ||||d�jS )aÔ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: data directory shared by users
    ©r"   r#   r$   r*   r&   )r(   Úsite_data_dirr+   r   r   r   r,   J   s    ûr,   c                 C  s   t | ||||d�jS )aÓ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: config directory tied to the user
    r'   )r(   Úuser_config_dirr'   r   r   r   r-   b   s    ûr-   c                 C  s   t | ||||d�jS )aÚ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: config directory shared by the users
    r+   )r(   Úsite_config_dirr+   r   r   r   r.   z   s    ûr.   T)r"   r#   r$   Úopinionr&   r   c                 C  s   t | ||||d�jS )aÒ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: cache directory tied to the user
    ©r"   r#   r$   r/   r&   )r(   Úuser_cache_dirr0   r   r   r   r1   ’   s    ûr1   c                 C  s   t | ||||d�jS ©aÒ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: cache directory tied to the user
    r0   )r(   Úsite_cache_dirr0   r   r   r   r3   ª   s    ûr3   c                 C  s   t | ||||d�jS )aÒ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: state directory tied to the user
    r'   )r(   Úuser_state_dirr'   r   r   r   r4   Â   s    ûr4   c                 C  s   t | ||||d�jS )aÐ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: log directory tied to the user
    r0   )r(   Úuser_log_dirr0   r   r   r   r5   Ú   s    ûr5   c                   C  s   t ƒ jS )z.:returns: documents directory tied to the user)r(   Úuser_documents_dirr   r   r   r   r6   ò   s    r6   c                   C  s   t ƒ jS )z.:returns: downloads directory tied to the user)r(   Úuser_downloads_dirr   r   r   r   r7   ÷   s    r7   c                   C  s   t ƒ jS )z-:returns: pictures directory tied to the user)r(   Úuser_pictures_dirr   r   r   r   r8   ü   s    r8   c                   C  s   t ƒ jS )z+:returns: videos directory tied to the user)r(   Úuser_videos_dirr   r   r   r   r9     s    r9   c                   C  s   t ƒ jS )z*:returns: music directory tied to the user)r(   Úuser_music_dirr   r   r   r   r:     s    r:   c                   C  s   t ƒ jS )z,:returns: desktop directory tied to the user)r(   Úuser_desktop_dirr   r   r   r   r;     s    r;   c                 C  s   t | ||||d�jS )aÔ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: runtime directory tied to the user
    r0   )r(   Úuser_runtime_dirr0   r   r   r   r<     s    ûr<   c                 C  s   t | ||||d�jS )aÓ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: runtime directory shared by users
    r0   )r(   Úsite_runtime_dirr0   r   r   r   r=   (  s    ûr=   r   c                 C  s   t | ||||d�jS )aÌ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: data path tied to the user
    r'   )r(   Úuser_data_pathr'   r   r   r   r>   @  s    ûr>   c                 C  s   t | ||||d�jS )aÑ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param multipath: See `multipath <platformdirs.api.PlatformDirsABC.multipath>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: data path shared by users
    r+   )r(   Úsite_data_pathr+   r   r   r   r?   X  s    ûr?   c                 C  s   t | ||||d�jS )aÎ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: config path tied to the user
    r'   )r(   Úuser_config_pathr'   r   r   r   r@   p  s    ûr@   c                 C  s   t | ||||d�jS )aÕ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: config path shared by the users
    r+   )r(   Úsite_config_pathr+   r   r   r   rA   ˆ  s    ûrA   c                 C  s   t | ||||d�jS r2   )r(   Úsite_cache_pathr0   r   r   r   rB      s    ûrB   c                 C  s   t | ||||d�jS )aÍ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: cache path tied to the user
    r0   )r(   Úuser_cache_pathr0   r   r   r   rC   ¸  s    ûrC   c                 C  s   t | ||||d�jS )aÍ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: state path tied to the user
    r'   )r(   Úuser_state_pathr'   r   r   r   rD   Ð  s    ûrD   c                 C  s   t | ||||d�jS )aË  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: log path tied to the user
    r0   )r(   Úuser_log_pathr0   r   r   r   rE   è  s    ûrE   c                   C  s   t ƒ jS )z):returns: documents path tied to the user)r(   Úuser_documents_pathr   r   r   r   rF      s    rF   c                   C  s   t ƒ jS )z):returns: downloads path tied to the user)r(   Úuser_downloads_pathr   r   r   r   rG     s    rG   c                   C  s   t ƒ jS )z(:returns: pictures path tied to the user)r(   Úuser_pictures_pathr   r   r   r   rH   
  s    rH   c                   C  s   t ƒ jS )z&:returns: videos path tied to the user)r(   Úuser_videos_pathr   r   r   r   rI     s    rI   c                   C  s   t ƒ jS )z%:returns: music path tied to the user)r(   Úuser_music_pathr   r   r   r   rJ     s    rJ   c                   C  s   t ƒ jS )z':returns: desktop path tied to the user)r(   Úuser_desktop_pathr   r   r   r   rK     s    rK   c                 C  s   t | ||||d�jS )aÏ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: runtime path tied to the user
    r0   )r(   Úuser_runtime_pathr0   r   r   r   rL     s    ûrL   c                 C  s   t | ||||d�jS )aÎ  
    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
    :returns: runtime path shared by users
    r0   )r(   Úsite_runtime_pathr0   r   r   r   rM   6  s    ûrM   )%r   Ú__version_info__r(   ÚAppDirsr   r)   r-   r1   r4   r5   r6   r7   r8   r9   r:   r;   r<   r,   r.   r3   r=   r>   r@   rC   rD   rE   rF   rG   rH   rI   rJ   rK   rL   r?   rA   rB   rM   )NNNFF)NNNFF)NNNFF)NNNFF)NNNTF)NNNTF)NNNFF)NNNTF)NNNTF)NNNTF)NNNFF)NNNFF)NNNFF)NNNFF)NNNTF)NNNTF)NNNFF)NNNTF)NNNTF)NNNTF)6Ú__doc__Ú
__future__r   r   r   Útypingr   Úapir   r$   r   r   rN   Úpathlibr   Úversion_infor   Ztyping_extensionsr   r(   rO   r)   r,   r-   r.   r1   r3   r4   r5   r6   r7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rA   rB   rC   rD   rE   rF   rG   rH   rI   rJ   rK   rL   rM   Ú__all__r   r   r   r   Ú<module>   s(  
     û     û     û     û     û     û     û     û     û     û     û     û     û     û     û     û     û     û     û     û