File: //usr/local/lib/python3.7/site-packages/pip/_vendor/platformdirs/__pycache__/unix.cpython-37.pyc
B
L��gi" � @ 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-hv55ucu3/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>`.
�str)r 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_path)r r 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 ~/.config)r r r r r r r )r 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 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~/.cache)r r r r r r r )r 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/state)r r r r r r r )r 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)r/ �opinionr r 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_dir)r 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 ~/Downloads)r3 )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
~/Pictures)r3 )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~/Videos)r3 )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~/Music)r3 )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 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``)r> 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``)r> r- )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 rB r r r
r> � s z%Unix._first_item_as_path_if_multipathN)�__name__�
__module__� __qualname__�__doc__�propertyr r r r( r* r, r- r/ r2 r4 r5 r6 r7 r8 r= r? r@ rA r> r r r r
r s(
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 )rH rI Z media_dirr r r
r3 � s r3 z
str | None)�keyr c C s� t t� j�d }|�� r|t� }|�� �}|�d|�� � �� W dQ 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]
N�top�"z$HOME�~)
r r r( r< r �open� read_string�readr �replacer r r )rK Zuser_dirs_config_path�parser�streamr r r r
rJ � s
rJ )rF �
__future__r r r9 � configparserr �pathlibr �apir r: r r r3 rJ �__all__r r r r
�<module> s
+