3i/dZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZmZd d lmZd d lmZerdd lmZej,d k(rddZnddlmZGddeZGddeeZddZddZdgZy)zUnix.) annotationsN) ConfigParser)cached_property)Path) gettempdir) TYPE_CHECKINGNoReturn)XDGMixin)PlatformDirsABC)Iteratorwin32cd}t|)Nzshould only be used on Unix) RuntimeError)msgs D/var/www/opsc/venv/lib/python3.12/site-packages/platformdirs/unix.pygetuidrs+3)rceZdZdZed dZed!dZed"dZed!dZ ed"dZ ed!dZ ed!dZ ed!d Z ed!d Zed!d Zed!d Zed!d Zed!dZed!dZed!dZed!dZed!dZed!dZed!dZed!dZed"dZed!dZed!dZed!dZed#dZed#dZed#dZ d$dZ!d$dZ"y)% _UnixDefaultszDefault directories for Unix/Linux without XDG environment variable overrides. The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`. c8|jxr tdk(S)Nr)use_site_for_rootrselfs r _use_sitez_UnixDefaults._use_site$s%%7&(a-7rc^|jtjjdS)z|:returns: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version``~/.local/share_append_app_name_and_versionospath expanduserrs r user_data_dirz_UnixDefaults.user_data_dir(%001C1CDT1UVVrcF|jd|jdgS)N/usr/local/share /usr/sharerrs r_site_data_dirsz_UnixDefaults._site_data_dirs-s%112DEtGhGhiuGvwwrc^|jtjjdS)z{:returns: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` ~/.configrrs ruser_config_dirz_UnixDefaults.user_config_dir1s$001C1CK1PQQrc&|jdgS)Nz/etc/xdgr(rs r_site_config_dirsz_UnixDefaults._site_config_dirs6s11*=>>rc^|jtjjdS)zx:returns: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``$XDG_CACHE_HOME/$appname/$version``z~/.cacherrs ruser_cache_dirz_UnixDefaults.user_cache_dir:s$001C1CJ1OPPrc$|jdS)zP:returns: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cacher(rs rsite_cache_dirz_UnixDefaults.site_cache_dir?s00>>rc^|jtjjdS)z~:returns: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version``z~/.local/staterrs ruser_state_dirz_UnixDefaults.user_state_dirDr$rc$|jdS)zN:returns: state directory shared by users, e.g. ``/var/lib/$appname/$version``z/var/libr(rs rsite_state_dirz_UnixDefaults.site_state_dirIs00<:returns: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/VideosrBrs ruser_videos_dirz_UnixDefaults.user_videos_diros##3Z@@rctddS)z<:returns: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/MusicrBrs ruser_music_dirz_UnixDefaults.user_music_dirts#?I>>rctddS)z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/DesktoprBrs ruser_desktop_dirz_UnixDefaults.user_desktop_dirys##4kBBrc@tjjdS)z?:returns: bin directory tied to the user, e.g. ``~/.local/bin``z ~/.local/bin)r r!r"rs r user_bin_dirz_UnixDefaults.user_bin_dir~sww!!.11rcy)z@:returns: bin directory shared by users, e.g. ``/usr/local/bin``z/usr/local/binrs r site_bin_dirz_UnixDefaults.site_bin_dirs rc|tjjtjjddS)zW:returns: applications directory tied to the user, e.g. ``~/.local/share/applications``r applications)r r!r:r"rs ruser_applications_dirz#_UnixDefaults.user_applications_dirs)ww||BGG../?@.QQrchdDcgc]"}tjj|d$c}Scc}w)N)r&r'rZ)r r!r:)rps r_site_applications_dirsz%_UnixDefaults._site_applications_dirss%9[\A Q/\\\s'/cz|j}|jrtjj |S|dS)zR:returns: applications directory shared by users, e.g. ``/usr/share/applications``r)r^ multipathr pathsepr:)rdirss rsite_applications_dirz#_UnixDefaults.site_applications_dirs1++(,rzzt$CDGCrchtjjdrdt}n:tjjdrdt}n dt}t j |tj stdt}|j|S)ah:returns: runtime directory tied to the user, e.g. ``$XDG_RUNTIME_DIR/$appname/$version``. If ``$XDG_RUNTIME_DIR`` is unset, tries the platform default (``/tmp/run/user/$(id -u)`` on OpenBSD, ``/var/run/user/$(id -u)`` on FreeBSD/NetBSD, ``/run/user/$(id -u)`` otherwise). If the default is not writable, falls back to a temporary directory. openbsdz/tmp/run/user/)freebsdnetbsdz/var/run/user/z /run/user/z /runtime-) sysplatform startswithrr accessW_OKrrr<s ruser_runtime_dirz_UnixDefaults.user_runtime_dirs << " "9 -#FH:.D \\ $ $%: ;#FH:.Dz*Dyyrww' l^9VXJ7D0066rcltjjdrd}nd}|j|S)aN:returns: 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. )rfrergz/var/runz/run)rhrirjrr<s rsite_runtime_dirz_UnixDefaults.site_runtime_dirs2 << " "#C DDD0066rc8|j|jS)zi:returns: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``) _first_item_as_path_if_multipath site_data_dirrs rsite_data_pathz_UnixDefaults.site_data_paths44T5G5GHHrc8|j|jS)zg:returns: config path shared by users, returns the first item, even if ``multipath`` is set to ``True``)rqsite_config_dirrs rsite_config_pathz_UnixDefaults.site_config_paths44T5I5IJJrc8|j|jS)zj:returns: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rqr2rs rsite_cache_pathz_UnixDefaults.site_cache_paths44T5H5HIIrc#TK|j|jEd{y7w)z4:yield: all user and site configuration directories.N)r,r.rs riter_config_dirsz_UnixDefaults.iter_config_dirss!""")))) (&(c#TK|j|jEd{y7w)z+:yield: all user and site data directories.N)r#r)rs riter_data_dirsz_UnixDefaults.iter_data_dirss!   ''''r{N)returnboolr~str)r~z list[str])r~r)r~z Iterator[str])#__name__ __module__ __qualname____doc__rrpropertyr#r)r,r.r0r2r4r6r=r?rDrGrJrMrPrSrUrXr[r^rcrmrorsrvrxrzr}rWrrrrsM 88WWxxRR??QQ??WW====GGFFEEAA??CC22  RR]]DD 77 77 IIKKJJ* (rrceZdZdZed fd Zed fd Zed fd Zed fd Zed fd Z ed fd Z ed fd Z ed fd Z xZ S) UnixafOn 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 `. cH|jr |jSt| S)zb:returns: data directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrrsuperr#r __class__s rr#zUnix.user_data_dirs!&*^^t!!N9NNrcH|jr |jSt| S)zd:returns: config directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrurr,rs rr,zUnix.user_config_dirs!(,~~t##R57;RRrcH|jr |jSt| S)zc:returns: cache directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr2rr0rs rr0zUnix.user_cache_dir!'+nnt""P%':PPrcH|jr |jSt| S)zc:returns: state directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr6rr4rs rr4zUnix.user_state_dirrrcH|jr |jSt| S)za:returns: log directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr?rr=rs rr=zUnix.user_log_dir!%)NNt  L8LLrcH|jr |jSt| S)zj:returns: applications directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrcrr[rs rr[zUnix.user_applications_dirs!.2^^t))^A^^rcH|jr |jSt| S)ze:returns: runtime directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrorrmrs rrmzUnix.user_runtime_dirs!)-t$$TEGrsx " %%* (<<7 s(Os(l1M8]1Mh3 0  r