File: //opt/python38/lib/python3.8/site-packages/pip/_vendor/platformdirs/__pycache__/unix.cpython-38.pyc
U
�{�ei" � @ s� d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m
Z
ej dkr^d d
�d d �Z n dd
lm Z G dd� de
�Z
dddd�dd�Zddd�dd�ZdgZdS )zUnix.� )� annotationsN)� ConfigParser)�Path� )�PlatformDirsABC�win32�int��returnc C s d} t | ��d S )Nzshould only be used on Unix)� RuntimeError)�msg� r
�A/tmp/pip-unpacked-wheel-_0scjqea/pip/_vendor/platformdirs/unix.py�getuid
s r )r c @ sb e Zd ZdZedd�dd��Zedd�dd��Zddd�d d
�Zedd�d d ��Zedd�d
d��Z edd�dd��Z
edd�dd��Z edd�dd��Z edd�dd��Z
edd�dd��Zedd�dd��Zedd�dd ��Zedd�d d ��Zedd�d d ��Zedd�d!d"��Zed#d�d$d%��Zed#d�d&d'��Zed#d�d(d)��Zdd#d*�d+d,�Zd-S ).�Unixa�
On Unix/Linux, we follow the
`XDG Basedir Spec <https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html>`_. The spec allows
overriding directories with environment variables. The examples show are the default values, alongside the name of
the environment variable that overrides them. Makes use of the
`appname <platformdirs.api.PlatformDirsABC.appname>`,
`version <platformdirs.api.PlatformDirsABC.version>`,
`multipath <platformdirs.api.PlatformDirsABC.multipath>`,
`opinion <platformdirs.api.PlatformDirsABC.opinion>`,
`ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
�strr c C s, t j�dd�}|�� s"t j�d�}| �|�S )z�
:return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or
``$XDG_DATA_HOME/$appname/$version``
�
XDG_DATA_HOME� z~/.local/share��os�environ�get�strip�path�
expanduser� _append_app_name_and_version��selfr r
r
r �
user_data_dir" s zUnix.user_data_dirc C s. t j�dd�}|�� s$dt j� d�}| �|�S )aY
:return: data directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is
enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS
path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version``
�
XDG_DATA_DIRSr z/usr/local/sharez
/usr/share)r r r r �pathsep�_with_multi_pathr r
r
r �
site_data_dir- s zUnix.site_data_dir)r r
c s< |� tj�}� js |dd� }� fdd�|D �}tj�|�S )Nr r c s g | ]}� � tj�|���qS r
)r r r r )�.0�p�r r
r �
<listcomp>> s z)Unix._with_multi_path.<locals>.<listcomp>)�splitr r � multipath�join)r r � path_listr
r% r r! : s
zUnix._with_multi_pathc C s, t j�dd�}|�� s"t j�d�}| �|�S )z�
:return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or
``$XDG_CONFIG_HOME/$appname/$version``
�XDG_CONFIG_HOMEr z ~/.configr r r
r
r �user_config_dirA s zUnix.user_config_dirc C s$ t j�dd�}|�� sd}| �|�S )a/
:return: config directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>`
is enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS
path separator), e.g. ``/etc/xdg/$appname/$version``
�XDG_CONFIG_DIRSr z/etc/xdg)r r r r r! r r
r
r �site_config_dirL s zUnix.site_config_dirc C s, t j�dd�}|�� s"t j�d�}| �|�S )z�
:return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or
``~/$XDG_CACHE_HOME/$appname/$version``
�XDG_CACHE_HOMEr z~/.cacher r r
r
r �user_cache_dirY s zUnix.user_cache_dirc C s
| � d�S )zM:return: cache directory shared by users, e.g. ``/var/tmp/$appname/$version``z/var/tmp)r r% r
r
r �site_cache_dird s zUnix.site_cache_dirc C s, t j�dd�}|�� s"t j�d�}| �|�S )z�
:return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or
``$XDG_STATE_HOME/$appname/$version``
�XDG_STATE_HOMEr z~/.local/stater r r
r
r �user_state_diri s zUnix.user_state_dirc C s | j }| jrtj�|d�}|S )zg:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it�log)r3 �opinionr r r) r r
r
r � user_log_dirt s zUnix.user_log_dirc C s
t dd�S )zC:return: documents directory tied to the user, e.g. ``~/Documents``ZXDG_DOCUMENTS_DIRz ~/Documents��_get_user_media_dirr% r
r
r �user_documents_dir| s zUnix.user_documents_dirc C s
t dd�S )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``ZXDG_DOWNLOAD_DIRz ~/Downloadsr7 r% r
r
r �user_downloads_dir� s zUnix.user_downloads_dirc C s
t dd�S )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``ZXDG_PICTURES_DIRz
~/Picturesr7 r% r
r
r �user_pictures_dir� s zUnix.user_pictures_dirc C s
t dd�S )z=:return: videos directory tied to the user, e.g. ``~/Videos``ZXDG_VIDEOS_DIRz~/Videosr7 r% r
r
r �user_videos_dir� s zUnix.user_videos_dirc C s
t dd�S )z;:return: music directory tied to the user, e.g. ``~/Music``Z
XDG_MUSIC_DIRz~/Musicr7 r% r
r
r �user_music_dir� s zUnix.user_music_dirc C s^ t j�dd�}|�� sTtj�d�rHdt� � �}t|�� � sTdt� � �}n dt� � �}| �
|�S )az
:return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or
``$XDG_RUNTIME_DIR/$appname/$version``.
For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/user/$(id -u)/$appname/$version`` if
exists, otherwise ``/tmp/runtime-$(id -u)/$appname/$version``, if``$XDG_RUNTIME_DIR``
is not set.
ZXDG_RUNTIME_DIRr )ZfreebsdZopenbsdZnetbsdz/var/run/user/z
/tmp/runtime-z
/run/user/) r r r r �sys�platform�
startswithr r �existsr r r
r
r �user_runtime_dir� s
zUnix.user_runtime_dirr c C s | � | j�S )zd:return: data path shared by users. Only return first item, even if ``multipath`` is set to ``True``)� _first_item_as_path_if_multipathr" r% r
r
r �site_data_path� s zUnix.site_data_pathc C s | � | j�S )zj:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``)rC r. r% r
r
r �site_config_path� s zUnix.site_config_pathc C s | � | j�S )ze:return: cache path shared by users. Only return first item, even if ``multipath`` is set to ``True``)rC r1 r% r
r
r �site_cache_path� s zUnix.site_cache_path)� directoryr
c C s | j r|�tj�d }t|�S )Nr )r( r' r r r )r rG r
r
r rC � s z%Unix._first_item_as_path_if_multipathN)�__name__�
__module__� __qualname__�__doc__�propertyr r" r! r, r. r0 r1 r3 r6 r9 r: r; r< r= rB rD rE rF rC r
r
r
r r sJ
r r )�env_var�fallback_tilde_pathr
c C s6 t | �}|d kr2tj�| d��� }|s2tj�|�}|S )Nr )�_get_user_dirs_folderr r r r r r )rM rN Z media_dirr
r
r r8 � s r8 z
str | None)�keyr
c C s� t t� j�d }|�� r|t� }|�� �}|�d|�� � �� W 5 Q R X | |d krVdS |d | �d�}|� dt
j � d��S dS )zkReturn directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/.zuser-dirs.dirsz[top]
�topN�"z$HOME�~)
r r r, rA r �open� read_string�readr �replacer r r )rP Zuser_dirs_config_path�parser�streamr r
r
r rO � s
rO )rK �
__future__r r r> � configparserr �pathlibr �apir r? r r r8 rO �__all__r
r
r
r �<module> s
+
�