U
ʗRe @ 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)getuidintreturnc C s t dd S )Nz should only be used on Linux) RuntimeError r
r
/builddir/build/BUILDROOT/alt-python38-pip-22.2.1-2.el8.x86_64/opt/alt/python38/lib/python3.8/site-packages/pip/_vendor/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 `.
strr
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/shareosenvirongetstrippath
expanduser _append_app_name_and_versionselfr 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_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 ).0pr 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 ~/.configr 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 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~/.cacher 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/stater 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 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``
XDG_DOCUMENTS_DIRNr z ~/Documents)_get_user_dirs_folderr r r r r r )r
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``
XDG_RUNTIME_DIRr z
/run/user/)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``)r; 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 r> r
r
r r; s z%Unix._first_item_as_path_if_multipathN)__name__
__module__ __qualname____doc__propertyr r! r r+ r- r/ r1 r4 r8 r: r< r= r; r
r
r
r r s2
r r z
str | None)keyr c C s t jt jd}t j|rt }t|}|d| W 5 Q 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]
topN"z$HOME~)
r r r( r r+ existsr open read_stringreadr replacer )rD user_dirs_config_pathparserstreamr r
r
r r6 s
r6 )
__future__r r sys configparserr pathlibr apir platform
startswithr r r6 __all__r
r
r
r s