B
qC?>j @ s d dl mZ d dlZd dlZd dlmZ d dlmZ ddlm Z ej
drZd dlm Z nd d
d d Z G d
d de Z
dddddZdgZdS ) ) annotationsN) ConfigParser)Path )PlatformDirsABClinux)getuidint)returnc C s t dd S )Nz should only be used on Linux) RuntimeError r r B/opt/alt/python37/lib/python3.7/site-packages/platformdirs/unix.pyr s r c @ s e Zd ZdZeddddZeddddZdddd d
Zeddd d Zeddd
dZ eddddZ
eddddZ eddddZ eddddZ
eddddZeddddZeddd d Zddd d d Zd!S )"UnixaD
On Unix/Linux, we follow the
`XDG Basedir Spec `_. 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 `,
`version `,
`multipath `,
`opinion `.
str)r
c C s, t jdd}| s"t jd}| |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)osenvirongetstrippath
expanduser _append_app_name_and_version)selfr r r r
user_data_dir s zUnix.user_data_dirc C s. t jdd}| s$dt j d}| |S )aY
:return: data directories shared by users (if `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 ).0p)r r r
: s z)Unix._with_multi_path..)splitr r multipathjoin)r r path_listr )r r
r 6 s
zUnix._with_multi_pathc C s, t jdd}| s"t jd}| |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_dir= s zUnix.user_config_dirc C s$ t jdd}| sd}| |S )a/
:return: config directories shared by users (if `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_dirH s zUnix.site_config_dirc C s, t jdd}| s"t jd}| |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_dirU s zUnix.user_cache_dirc C s, t jdd}| s"t jd}| |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_dir` s zUnix.user_state_dirc C s | j }| jrtj|d}|S )zx
:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``log`` in it
log)r+ opinionr r r$ )r r r r r
user_log_dirk s zUnix.user_log_dirc C s6 t d}|dkr2tjdd }|s2tjd}|S )zU
:return: documents directory tied to the user, e.g. ``~/Documents``
ZXDG_DOCUMENTS_DIRNr z ~/Documents)_get_user_dirs_folderr r r r r r )r Z
documents_dirr r r
user_documents_diru s zUnix.user_documents_dirc C s, t jdd}| s"dt }| |S )z
:return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or
``$XDG_RUNTIME_DIR/$appname/$version``
ZXDG_RUNTIME_DIRr z
/run/user/)r r r r r r )r r r r r
user_runtime_dir s zUnix.user_runtime_dirr c C s | | jS )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 | | jS )zj:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``)r4 r) )r r r r
site_config_path s zUnix.site_config_path) directoryr
c C s | j r|tjd }t|S )Nr )r# r" r r r )r r7 r r r
r4 s z%Unix._first_item_as_path_if_multipathN)__name__
__module__ __qualname____doc__propertyr r r r' r) r+ r- r0 r2 r3 r5 r6 r4 r r r r
r s
r r z
str | None)keyr
c C s t jt jd}t j|rt }t|}|d| W dQ R X | |d kr\dS |d |
d}| dt j d}|S dS )zjReturn directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/zuser-dirs.dirsz[top]
Ntop"z$HOME~)
r r r$ r r' existsr open read_stringreadr replacer )r= Zuser_dirs_config_pathparserstreamr r r r
r1 s
r1 )
__future__r r sys configparserr Zpathlibr Zapir platform
startswithr r r1 __all__r r r r
s