o 6i(@sdZddlmZddlZddlZddlmZddlmZddl m Z m Z ddl m Z e r2dd lmZejd kr=dd dZnddlmZGddde ZdddZdddZdgZdS)zUnix.) annotationsN) ConfigParser)Path) TYPE_CHECKINGNoReturn)PlatformDirsABC)Iteratorwin32returnrcCs d}t|)Nzshould only be used on Unix) RuntimeError)msgr\/root/parts/websockify/install/lib/python3.10/site-packages/pip/_vendor/platformdirs/unix.pygetuidsr)rc@sJeZdZdZed6ddZed7ddZed6d d Zed6d d Zed7d dZ ed6ddZ ed6ddZ ed6ddZ ed6ddZ ed6ddZed6ddZed6ddZed6ddZed6dd Zed6d!d"Zed6d#d$Zed6d%d&Zed6d'd(Zed8d*d+Zed8d,d-Zed8d.d/Zd9d1d2Zd9d3d4Zd5S):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 strcC,tjdd}|stjd}||S)z :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version`` XDG_DATA_HOMEz~/.local/shareosenvirongetstrippath expanduser_append_app_name_and_versionselfrrrr user_data_dir'  zUnix.user_data_dir list[str]cs>tjdd}|sdtjd}fdd|tjDS)N XDG_DATA_DIRSrz/usr/local/sharez /usr/sharecg|]}|qSrr.0prrr 7z(Unix._site_data_dirs..)rrrrpathsepsplitrrr)r_site_data_dirs2szUnix._site_data_dirscC |j}|js |dStj|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)r. multipathrr,joinrdirsrrr site_data_dir9 zUnix.site_data_dircCr)z :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` XDG_CONFIG_HOMErz ~/.configrrrrruser_config_dirFr!zUnix.user_config_dircs4tjdd}|s d}fdd|tjDS)NXDG_CONFIG_DIRSrz/etc/xdgcr$rr%r&r)rrr*Vr+z*Unix._site_config_dirs..)rrrrr-r,rrr)r_site_config_dirsQszUnix._site_config_dirscCr/)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)r9r0rr,r1r2rrrsite_config_dirXr5zUnix.site_config_dircCr)z :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``~/$XDG_CACHE_HOME/$appname/$version`` XDG_CACHE_HOMErz~/.cacherrrrruser_cache_direr!zUnix.user_cache_dircCs |dS)zO:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cacher%r)rrrsite_cache_dirp zUnix.site_cache_dircCr)z :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version`` XDG_STATE_HOMErz~/.local/staterrrrruser_state_dirur!zUnix.user_state_dircCs(|j}|jrtj|d}|||S)zg:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in itlog)r@opinionrrr1_optionally_create_directoryrrrr user_log_dirs  zUnix.user_log_dircC tddS)zC:return: documents directory tied to the user, e.g. ``~/Documents``XDG_DOCUMENTS_DIRz ~/Documents_get_user_media_dirr)rrruser_documents_dirr>zUnix.user_documents_dircCrE)zC:return: downloads directory tied to the user, e.g. ``~/Downloads``XDG_DOWNLOAD_DIRz ~/DownloadsrGr)rrruser_downloads_dirr>zUnix.user_downloads_dircCrE)zA:return: pictures directory tied to the user, e.g. ``~/Pictures``XDG_PICTURES_DIRz ~/PicturesrGr)rrruser_pictures_dirr>zUnix.user_pictures_dircCrE)z=:return: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/VideosrGr)rrruser_videos_dirr>zUnix.user_videos_dircCrE)z;:return: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/MusicrGr)rrruser_music_dirr>zUnix.user_music_dircCrE)z?:return: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/DesktoprGr)rrruser_desktop_dirr>zUnix.user_desktop_dircCs^tjdd}|s*tjdr$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_DIRrfreebsdopenbsdnetbsdz/var/run/user/z /tmp/runtime-z /run/user/) rrrrsysplatform startswithrrexistsrrrrruser_runtime_dirs       zUnix.user_runtime_dircCs6tjdd}|stjdrd}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. rTrrUz/var/runz/run)rrrrrYrZr[rrrrrsite_runtime_dirs   zUnix.site_runtime_dirrcC ||jS)zh:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``) _first_item_as_path_if_multipathr4r)rrrsite_data_path zUnix.site_data_pathcCr_)zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)r`r:r)rrrsite_config_pathrbzUnix.site_config_pathcCr_)zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r`r=r)rrrsite_cache_pathrbzUnix.site_cache_path Iterator[str]cc|jV|jEdHdS)z4:yield: all user and site configuration directories.N)r7r9r)rrriter_config_dirszUnix.iter_config_dirsccrf)z+:yield: all user and site data directories.N)r r.r)rrriter_data_dirsrhzUnix.iter_data_dirsN)r r)r r")r r)r re)__name__ __module__ __qualname____doc__propertyr r.r4r7r9r:r<r=r@rDrIrKrMrOrQrSr]r^rarcrdrgrirrrrrs\                      renv_varrfallback_tilde_pathcCs6t|}|durtj|d}|stj|}|S)Nr)_get_user_dirs_folderrrrrrr)rorp media_dirrrrrHs  rHkey str | NonecCsttjd}|rHt}|}|d|Wdn1s(wY||dvr5dS|d|d}| dt j dSdS)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~) rrr7r\ropen read_stringreadrreplacerrr)rsuser_dirs_config_pathparserstreamrrrrrqs  rq)r r)rorrprr r)rsrr rt)rm __future__rrrY configparserrpathlibrtypingrrapircollections.abcr rZrrrHrq__all__rrrrs&         R