o Zh:'@sdZddlmZddlZddlZddlmZddlmZddl m Z ej dkr-dd d Z ndd lm Z Gddde Z dddZdddZdgZdS)zUnix.) annotationsN) ConfigParser)Path)PlatformDirsABCwin32returnintcCs d}t|)Nzshould only be used on Unix) RuntimeError)msgr H/var/www/html/lang_env/lib/python3.10/site-packages/platformdirs/unix.pygetuid sr)rc@s.eZdZdZed2ddZed2ddZd3d d Zed2d d Zed2d dZ ed2ddZ ed2ddZ ed2ddZ ed2ddZ ed2ddZed2ddZed2ddZed2ddZed2dd Zed2d!d"Zed2d#d$Zed2d%d&Zed4d(d)Zed4d*d+Zed4d,d-Zd5d/d0Zd1S)6Unixa 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 `, `ensure_exists `. rstrcC,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_versionselfrr r r user_data_dir"  zUnix.user_data_dircCs.tjdd}|sdtjd}||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_DIRSrz/usr/local/sharez /usr/share)rrrrpathsep_with_multi_pathrr r r site_data_dir-s zUnix.site_data_dirrcs<|tj}js|dd}fdd|D}tj|S)Nrrcsg|] }tj|qSr )rrrr).0prr r >sz)Unix._with_multi_path..)splitrr! multipathjoin)rr path_listr r&r r":s   zUnix._with_multi_pathcCr)z :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` XDG_CONFIG_HOMErz ~/.configrrr r r user_config_dirArzUnix.user_config_dircCs$tjdd}|s d}||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_DIRSrz/etc/xdg)rrrrr"rr r r site_config_dirLs zUnix.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~/.cacherrr r r user_cache_dirYrzUnix.user_cache_dircCs |dS)zM:return: cache directory shared by users, e.g. ``/var/tmp/$appname/$version``z/var/tmp)rr&r r r site_cache_dird 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/staterrr r r user_state_dirirzUnix.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)r5opinionrrr*_optionally_create_directoryrr r r user_log_dirts  zUnix.user_log_dircC tddS)zC:return: documents directory tied to the user, e.g. ``~/Documents``XDG_DOCUMENTS_DIRz ~/Documents_get_user_media_dirr&r r r user_documents_dir}r3zUnix.user_documents_dircCr:)zC:return: downloads directory tied to the user, e.g. ``~/Downloads``XDG_DOWNLOAD_DIRz ~/Downloadsr<r&r r r user_downloads_dirr3zUnix.user_downloads_dircCr:)zA:return: pictures directory tied to the user, e.g. ``~/Pictures``XDG_PICTURES_DIRz ~/Picturesr<r&r r r user_pictures_dirr3zUnix.user_pictures_dircCr:)z=:return: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/Videosr<r&r r r user_videos_dirr3zUnix.user_videos_dircCr:)z;:return: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/Musicr<r&r r r user_music_dirr3zUnix.user_music_dircCr:)z?:return: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/Desktopr<r&r r r user_desktop_dirr3zUnix.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 startswithrrexistsrrr r r user_runtime_dirs       zUnix.user_runtime_dircCs6tjdd}|stjdrd}nd}||S)al :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 fallback 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. rIrrJz/var/runz/run)rrrrrNrOrPrrr r r site_runtime_dirs   zUnix.site_runtime_dirrcC ||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 zUnix.site_data_pathcCrT)zj:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``)rUr/r&r r r site_config_pathrWzUnix.site_config_pathcCrT)ze:return: cache path shared by users. Only return first item, even if ``multipath`` is set to ``True``)rUr2r&r r r site_cache_pathrWzUnix.site_cache_path directorycCs|jr |tjd}t|S)Nr)r)r(rr!r)rrZr r r rUsz%Unix._first_item_as_path_if_multipathN)rr)rrrr)rr)rZrrr)__name__ __module__ __qualname____doc__propertyrr#r"r-r/r1r2r5r9r>r@rBrDrFrHrRrSrVrXrYrUr r r r rsT                    renv_varrfallback_tilde_pathcCs6t|}|durtj|d}|stj|}|S)Nr)_get_user_dirs_folderrrrrrr)r`ra media_dirr r r r=s  r=key str | NonecCsttjd}|rHt}|}|d|Wdn1s(wY||dvr5dS|d|d}| dt j dSdS)zkReturn directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/.zuser-dirs.dirsz[top] Ntop"z$HOME~) rrr-rQropen read_stringreadrreplacerrr)rduser_dirs_config_pathparserstreamrr r r rbs  rb)rr )r`rrarrr)rdrrre)r^ __future__rrrN configparserrpathlibrapirrOrrr=rb__all__r r r r s         G