File: //usr/local/lib/python3.10/dist-packages/platformdirs/__pycache__/unix.cpython-310.pyc
o
j�h�( � @ s� d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m
Z
m Z ddl m
Z
e
r2dd lmZ ejd
kr=dd
d�ZnddlmZ G dd� de
�Zd dd�Zd dd�ZdgZdS ) zUnix.� )� annotationsN)� ConfigParser)�Path)�
TYPE_CHECKING�NoReturn� )�PlatformDirsABC)�Iterator�win32�returnr c C s d} t | ��)Nzshould only be used on Unix)� RuntimeError)�msg� r �</usr/local/lib/python3.10/dist-packages/platformdirs/unix.py�getuid s r )r c @ sJ e Zd ZdZed6dd��Zed7dd��Zed6d d
��Zed6d d ��Zed7d
d��Z ed6dd��Z
ed6dd��Z ed6dd��Z ed6dd��Z
ed6dd��Zed6dd��Zed6dd ��Zed6d d ��Zed6d d ��Zed6d!d"��Zed6d#d$��Zed6d%d&��Zed6d'd(��Zed8d*d+��Zed8d,d-��Zed8d.d/��Zd9d1d2�Zd9d3d4�Zd5S ):�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 shown 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>`.
r �strc C �, t j�dd�}|�� st 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' �
zUnix.user_data_dir� list[str]c s> t j�dd�}|�� sdt j� d�}� fdd�|�t j�D �S )N�
XDG_DATA_DIRSr z/usr/local/sharez
/usr/sharec � g | ]}� � |��qS r �r ��.0�p�r r r �
<listcomp>7 � z(Unix._site_data_dirs.<locals>.<listcomp>)r r r r �pathsep�splitr r r) r �_site_data_dirs2 s zUnix._site_data_dirsc C � | j }| js
|d S tj�|�S )aZ
:return: data directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is
enabled and ``XDG_DATA_DIRS`` 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``
r )r. � multipathr r, �join�r �dirsr r r �
site_data_dir9 � zUnix.site_data_dirc C r )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_dirF r! zUnix.user_config_dirc s4 t j�dd�}|�� s
d}� fdd�|�t j�D �S )N�XDG_CONFIG_DIRSr z/etc/xdgc r$ r r% r& r) r r r* V r+ z*Unix._site_config_dirs.<locals>.<listcomp>)r r r r r- r, r r r) r �_site_config_dirsQ s zUnix._site_config_dirsc C r/ )a2
:return: config directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>`
is enabled and ``XDG_CONFIG_DIRS`` 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``
r )r9 r0 r r, r1 r2 r r r �site_config_dirX r5 zUnix.site_config_dirc C r )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_dire r! zUnix.user_cache_dirc C s
| � d�S )zO:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z
/var/cacher% r) r r r �site_cache_dirp �
zUnix.site_cache_dirc C r )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_diru r! 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 r1 � _optionally_create_directoryr r r r � user_log_dir� s
zUnix.user_log_dirc C �
t dd�S )zC:return: documents directory tied to the user, e.g. ``~/Documents``�XDG_DOCUMENTS_DIRz ~/Documents��_get_user_media_dirr) r r r �user_documents_dir� r> zUnix.user_documents_dirc C rE )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``�XDG_DOWNLOAD_DIRz ~/DownloadsrG r) r r r �user_downloads_dir� r> zUnix.user_downloads_dirc C rE )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``�XDG_PICTURES_DIRz
~/PicturesrG r) r r r �user_pictures_dir� r> zUnix.user_pictures_dirc C rE )z=:return: videos directory tied to the user, e.g. ``~/Videos``�XDG_VIDEOS_DIRz~/VideosrG r) r r r �user_videos_dir� r> zUnix.user_videos_dirc C rE )z;:return: music directory tied to the user, e.g. ``~/Music``�
XDG_MUSIC_DIRz~/MusicrG r) r r r �user_music_dir� r> zUnix.user_music_dirc C rE )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``�XDG_DESKTOP_DIRz ~/DesktoprG r) r r r �user_desktop_dir� r> zUnix.user_desktop_dirc C s^ t j�dd�}|�� s*tj�d�r$dt� � �}t|�� � s#dt� � �}ndt� � �}| �
|�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.
�XDG_RUNTIME_DIRr ��freebsd�openbsd�netbsdz/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_dirc C s6 t j�dd�}|�� stj�d�rd}nd}| �|�S )am
:return: runtime directory shared by users, e.g. ``/run/$appname/$version`` or ``$XDG_RUNTIME_DIR/$appname/$version``.
Note that this behaves almost exactly like `user_runtime_dir` if ``$XDG_RUNTIME_DIR`` is set, but will
fall back to paths associated to the root user instead of a regular logged-in user if it's not set.
If you wish to ensure that a logged-in root user path is returned e.g. ``/run/user/0``, use `user_runtime_dir`
instead.
For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/$appname/$version`` if ``$XDG_RUNTIME_DIR`` is not set.
rT r rU z/var/runz/run)r r r r rY rZ r[ r r r r r �site_runtime_dir� s
zUnix.site_runtime_dirr c C � | � | j�S )zh:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)� _first_item_as_path_if_multipathr4 r) r r r �site_data_path� � zUnix.site_data_pathc C r_ )zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)r` r: r) r r r �site_config_path� rb zUnix.site_config_pathc C r_ )zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r` r= r) r r r �site_cache_path� rb zUnix.site_cache_path�
Iterator[str]c c � � | j V | jE dH dS )z4:yield: all user and site configuration directories.N)r7 r9 r) r r r �iter_config_dirs� � �zUnix.iter_config_dirsc c rf )z+:yield: all user and site data directories.N)r r. r) r r r �iter_data_dirs� rh zUnix.iter_data_dirsN)r r )r r" )r r )r re ) �__name__�
__module__� __qualname__�__doc__�propertyr r. r4 r7 r9 r: r< r= r@ rD rI rK rM rO rQ rS r] r^ ra rc rd rg ri r r r r r s\
r �env_varr �fallback_tilde_pathc C s6 t | �}|d u rtj�| d��� }|stj�|�}|S )Nr )�_get_user_dirs_folderr r r r r r )ro rp � media_dirr r r rH � s rH �key�
str | Nonec C s� t t� j�d }|�� rHt� }|�� �}|�d|�� � �� W d � n1 s(w Y | |d vr5dS |d | �d�}|� dt
j � d��S dS )z{
Return 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 r7 r\ r �open� read_string�readr �replacer r r )rs �user_dirs_config_path�parser�streamr r r r rq � s
� rq )r r )ro r rp r r r )rs r r rt )rm �
__future__r r rY � configparserr �pathlibr �typingr r �apir �collections.abcr rZ r r rH rq �__all__r r r r �<module> s&
R
�