1j) d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m
Z
m Z ddl m
Z
ej d k rdd Zndd
lmZ G d de
ZddZddZdgZdS )zUnix. ) annotationsN) ConfigParser)Path)IteratorNoReturn )PlatformDirsABCwin32returnr c $ d} t | )Nzshould only be used on Unix) RuntimeError)msgs o/builddir/build/BUILD/cloudlinux-venv-1.0.11/venv/lib/python3.11/site-packages/pip/_vendor/platformdirs/unix.pygetuidr s +3 )r c " e Zd ZdZed!d Zed"d Zed!d Zed!d Zed"d Z ed!d
Z
ed!d Z ed!d Z ed!d
Z
ed!d Zed!d Zed!d Zed!d Zed!d Zed!d Zed!d Zed!d Zed!d Zed#d Zed#d Zed#d Zd$d Zd%d Zd%d Z d S )&Unixa
On Unix/Linux, we follow the `XDG Basedir Spec `_.
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
`, `version `, `multipath
`, `opinion `, `ensure_exists
`.
r strc 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/shareosenvirongetstrippath
expanduser _append_app_name_and_versionselfr s r
user_data_dirzUnix.user_data_dir$ sS z~~or22zz|| 87%%&677D00666r list[str]c t j dd }| sdt j d} fd| t j D S )N
XDG_DATA_DIRSr z/usr/local/sharez
/usr/sharec : g | ]} | S r .0pr! s r
z(Unix._site_data_dirs..4 ' UUU11!44UUUr )r r r r pathsepsplitr s ` r _site_data_dirszUnix._site_data_dirs/ sb z~~or22zz|| =T>TUUUUr c l | j }| j s|d S t j | S )aZ
:return: data directories shared by users (if `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 )r0 multipathr r. joinr! dirss r
site_data_dirzUnix.site_data_dir6 s3 #~ 7Nzt$$$r c 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 s r user_config_dirzUnix.user_config_dirC sS z~~ /44zz|| 37%%k22D00666r c t j dd }| sd} fd| t j D S )NXDG_CONFIG_DIRSr z/etc/xdgc : g | ]} | S r' r( r) s r r, z*Unix._site_config_dirs..S r- r )r r r r r/ r. r s ` r _site_config_dirszUnix._site_config_dirsN sV z~~ /44zz|| DUUUUdjj>T>TUUUUr c l | j }| j s|d S t j | S )a2
:return: config directories shared by users (if `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 )r= r2 r r. r3 r4 s r site_config_dirzUnix.site_config_dirU s3 %~ 7Nzt$$$r c 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 s r user_cache_dirzUnix.user_cache_dirb sS z~~ .33zz|| 27%%j11D00666r c , | d S )zO:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z
/var/cacher( r! s r site_cache_dirzUnix.site_cache_dirm s 00 >>>r c 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 s r user_state_dirzUnix.user_state_dirr sT z~~ .33zz|| 87%%&677D00666r c | j }| j r5t j |d }| | |S )zg:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in itlog)rH opinionr r r3 _optionally_create_directoryr s r user_log_dirzUnix.user_log_dir} sD " < 47<<e,,D - -d 3 3 3 r c " t dd S )zC:return: documents directory tied to the user, e.g. ``~/Documents``XDG_DOCUMENTS_DIRz ~/Documents_get_user_media_dirrD s r user_documents_dirzUnix.user_documents_dir s ##6
FFFr c " t dd S )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``XDG_DOWNLOAD_DIRz ~/DownloadsrP rD s r user_downloads_dirzUnix.user_downloads_dir s ##5}EEEr c " t dd S )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``XDG_PICTURES_DIRz
~/PicturesrP rD s r user_pictures_dirzUnix.user_pictures_dir s ##5|DDDr c " t dd S )z=:return: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/VideosrP rD s r user_videos_dirzUnix.user_videos_dir s ##3Z@@@r c " t dd S )z;:return: music directory tied to the user, e.g. ``~/Music``
XDG_MUSIC_DIRz~/MusicrP rD s r user_music_dirzUnix.user_music_dir s #?I>>>r c " t dd S )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/DesktoprP rD s r user_desktop_dirzUnix.user_desktop_dir s ##4kBBBr c | t j dd }| stt j d rDdt }t | sdt }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 freebsdopenbsdnetbsdz/var/run/user/z
/tmp/runtime-z
/run/user/) r r r r sysplatform
startswithr r existsr r s r user_runtime_dirzUnix.user_runtime_dir s z~~ /44zz|| /|&&'GHH
/222Dzz((** 6568855D.FHH..00666r c t j dd }| s$t j 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.
rc r rd z/var/runz/run)r r r r rh ri rj r r s r site_runtime_dirzUnix.site_runtime_dir sc z~~ /44zz|| |&&'GHH
! 00666r r c 6 | | 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_multipathr6 rD s r site_data_pathzUnix.site_data_path s 44T5GHHHr c 6 | | j S )zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)rp r? rD s r site_config_pathzUnix.site_config_path s 44T5IJJJr c 6 | | j S )zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rp rE rD s r site_cache_pathzUnix.site_cache_path s 44T5HIIIr directoryc x | j r%| t j d }t | S )Nr )r2 r/ r r. r )r! rv s r rp z%Unix._first_item_as_path_if_multipath s0 > 7!
33A6II r
Iterator[str]c # 6 K | j V | j E d{V dS )z4:yield: all user and site configuration directories.N)r9 r= rD s r iter_config_dirszUnix.iter_config_dirs s6 """"))))))))))r c # 6 K | j V | j E d{V dS )z+:yield: all user and site data directories.N)r" r0 rD s r iter_data_dirszUnix.iter_data_dirs s6 ''''''''''r N)r r )r r# )r r )rv r r r )r rx ) __name__
__module__ __qualname____doc__propertyr" r0 r6 r9 r= r? rB rE rH rM rR rU rX r[ r^ ra rl rn rq rs ru rp rz r| r' r r r r s"
7 7 7 X7 V V V XV
%
%
% X
% 7 7 7 X7 V V V XV
%
%
% X
% 7 7 7 X7 ? ? ? X? 7 7 7 X7 X G G G XG F F F XF E E E XE A A A XA ? ? ? X? C C C XC 7 7 7 X7& 7 7 7 X7* I I I XI K K K XK J J J XJ * * * *
( ( ( ( ( (r r env_varr fallback_tilde_pathc t | }|St j | d }|s t j | }|S )Nr )_get_user_dirs_folderr r r r r r )r r media_dirs r rQ rQ s[ %g..IJNN7B//5577 @**+>??I r key
str | Nonec t t j dz }| rt }| 5 }| d| ddd n # 1 swxY w Y | |d vrdS |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]
Ntop"z$HOME~)
r r r9 rk r open read_stringreadr replacer r r )r user_dirs_config_pathparserstreamr s r r r s !!7 8 8;K K ##%% >
"
'
'
)
) :V 8 8 8 9 9 9 : : : : : : : : : : : : : : : fUm # #4e}S!'',,||GRW%7%7%<%<=== 4s +BBB)r r )r r r r r r )r r r r )r
__future__r r rh configparserr pathlibr typingr r apir ri r r rQ r __all__r' r r r s! " " " " " "
% % % % % % % % % % % % % % <7
T( T( T( T( T(? T( T( T(n 4 r