o

;jW�@
sdZd
dl
mZ
d
dlZd
dlZd
dlmZ
ddlmZ
ddl	m
Z

ddl	mZ
er6d
d	l
mZ
d
d
lmZ
ejdkrBd
dlmZ
nejd
krNd
dlmZ
nd
dlmZ
dcdd�Zer^eZne�ZeZ					dddedd�Z					dddfd!d"�Z					ddded#d$�Z					dddfd%d&�Z				'	dgdhd)d*�Z				'	dgdhd+d,�Z 					ddded-d.�Z!				'	dgdhd/d0�Z"did1d2�Z#did3d4�Z$did5d6�Z%did7d8�Z&did9d:�Z'did;d<�Z(				'	dgdhd=d>�Z)				'	dgdhd?d@�Z*					dddjdBdC�Z+					dddkdDdE�Z,					dddjdFdG�Z-					dddkdHdI�Z.				'	dgdldJdK�Z/				'	dgdldLdM�Z0					dddjdNdO�Z1				'	dgdldPdQ�Z2dmdRdS�Z3dmdTdU�Z4dmdVdW�Z5dmdXdY�Z6dmdZd[�Z7dmd\d]�Z8				'	dgdld^d_�Z9				'	dgdld`da�Z:gdb�
Z;dS)nz�
Utilities for determining application-specific dirs.

See <https://github.com/platformdirs/platformdirs> for details and usage.

�)
�annotationsN)
�
TYPE_CHECKING�
)
�PlatformDirsABC)
�__version__)
�__version_tuple__)
�Path)
�Literal�win32)
�Windows�darwin)
�MacOS)
�Unix�return�type[PlatformDirsABC]cC
s^t�
d
�
dkr-t�
d�
dkr-t�
d�
st�
d�
rtSddlm}
|�du
r-dd	lm}

|
StS)
NZANDROID_DATAz/dataZANDROID_ROOTz/systemZSHELLZPREFIXr
)
�_android_folder)
�Android)�os�getenv�_ResultZplatformdirs.androidrr)rr�r�I/opt/saltstack/salt/lib/python3.10/site-packages/platformdirs/__init__.py�_set_platform_dir_classs




rF�appname�
str | None�	appauthor�str | Literal[False] | None�version�roaming�bool�
ensure_exists�strcC
�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
    �rrrrr )�PlatformDirs�
user_data_dirr#rrrr%5�




��r%�	multipathcC
r")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
    �rrrr'r )r$�
site_data_dirr(rrrr)Mr&r)cC
r")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#rrrr*er&r*cC
r")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(rrrr+}r&r+T�opinioncC
r")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
    �rrrr,r )r$�user_cache_dirr-rrrr.�r&r.cC
r"�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
    r-)r$�site_cache_dirr-rrrr0�r&r0cC
r")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#rrrr1�r&r1cC
r")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
    r-)r$�user_log_dirr-rrrr2�r&r2c
C
�t�j
S)
z.:returns: documents directory tied to the user)r$�user_documents_dirrrrrr4��r4c
C
r3)
z.:returns: downloads directory tied to the user)r$�user_downloads_dirrrrrr6�r5r6c
C
r3)
z-:returns: pictures directory tied to the user)r$�user_pictures_dirrrrrr7�r5r7c
C
r3)
z+:returns: videos directory tied to the user)r$�user_videos_dirrrrrr8
r5r8c
C
r3)
z*:returns: music directory tied to the user)r$�user_music_dirrrrrr9	
r5r9c
C
r3)
z,:returns: desktop directory tied to the user)r$�user_desktop_dirrrrrr:
r5r:cC
r")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
    r-)r$�user_runtime_dirr-rrrr;
r&r;cC
r")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
    r-)r$�site_runtime_dirr-rrrr<+
r&r<rcC
r")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#rrrr=C
r&r=cC
r")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(rrrr>[
r&r>cC
r")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#rrrr?s
r&r?cC
r")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(rrrr@�
r&r@cC
r"r/)r$�site_cache_pathr-rrrrA�
r&rAcC
r")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
    r-)r$�user_cache_pathr-rrrrB�
r&rBcC
r")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#rrrrC�
r&rCcC
r")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
    r-)r$�
user_log_pathr-rrrrD�
r&rDc
C
r3)
z+:returns: documents a path tied to the user)r$�user_documents_pathrrrrrEr5rEc
C
r3)
z):returns: downloads path tied to the user)r$�user_downloads_pathrrrrrFr5rFc
C
r3)
z(:returns: pictures path tied to the user)r$�user_pictures_pathrrrrrG
r5rGc
C
r3)
z&:returns: videos path tied to the user)r$�user_videos_pathrrrrrHr5rHc
C
r3)
z%:returns: music path tied to the user)r$�user_music_pathrrrrrIr5rIc
C
r3)
z':returns: desktop path tied to the user)r$�user_desktop_pathrrrrrJr5rJcC
r")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
    r-)r$�user_runtime_pathr-rrrrK!r&rKcC
r")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
    r-)r$�site_runtime_pathr-rrrrL9r&rL)%�AppDirsr$rr�__version_info__r0rAr+r@r)r>r<rLr.rBr*r?r%r=r:rJr4rEr6rFr2rDr9rIr7rGr;rKr1rCr8rH)rr)NNNFF)rrrrrrrrr rrr!)rrrrrrr'rr rrr!)NNNTF)rrrrrrr,rr rrr!)rr!)rrrrrrrrr rrr)rrrrrrr'rr rrr)rrrrrrr,rr rrr)rr)<�__doc__�
__future__rr�sys�typingrZapirrrrrN�pathlibrr	�platformZplatformdirs.windowsrrZplatformdirs.macosr
Zplatformdirs.unixrrr$rMr%r)r*r+r.r0r1r2r4r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrL�__all__rrrr�<module>
s4

















�



�



�



�



�



�



�



�









�



�



�



�



�



�



�



�



�



�









�



�