uf d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m
Z
m Z ddl m
Z
e
rdd lmZ ej d
k rdd
ZnddlmZ G d de
ZddZddZdgZdS )zUnix. ) annotationsN) ConfigParser)Path)
TYPE_CHECKINGNoReturn )PlatformDirsABC)Iteratorwin32returnr c $ d} t | )Nzshould only be used on Unix) RuntimeError)msgs o/builddir/build/BUILD/cloudlinux-venv-1.0.10/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 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..7 ' UUU11!44UUUr )r r r r pathsepsplitr! s ` r _site_data_dirszUnix._site_data_dirs2 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 )r1 multipathr r/ joinr" dirss r
site_data_dirzUnix.site_data_dir9 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_dirF 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..V r. r )r r r r r0 r/ r! s ` r _site_config_dirszUnix._site_config_dirsQ 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> r3 r r/ r4 r5 s r site_config_dirzUnix.site_config_dirX 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_dire 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_dirp 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_diru 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)rI opinionr r r4 _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_dirrE 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 ~/DownloadsrQ rE 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
~/PicturesrQ rE 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~/VideosrQ rE 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~/MusicrQ rE 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 ~/DesktoprQ rE 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.
rd r re z/var/runz/run)r r r r ri rj rk 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_multipathr7 rE 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``)rq r@ rE 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``)rq rF rE s r site_cache_pathzUnix.site_cache_path s 44T5HIIIr
Iterator[str]c # 6 K | j V | j E d{V dS )z4:yield: all user and site configuration directories.N)r: r> rE 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# r1 rE s r iter_data_dirszUnix.iter_data_dirs s6 ''''''''''r N)r r )r r$ )r r )r rw ) __name__
__module__ __qualname____doc__propertyr# r1 r7 r: r> r@ rC rF rI rN rS rV rY r\ r_ rb rm ro rr rt rv ry 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 rR rR 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 r: rl 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 ri configparserr pathlibr typingr r apir collections.abcr
rj r r rR r __all__r( r r r s; " " " " " "
% % % % % % * * * * * * * * )((((((<7
N( N( N( N( N(? N( N( N(b 4 r