1iN/ dZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZmZd d lmZd d lmZerdd lmZejd krddZnddlmZGddeZGddeeZddZddZdgZdS) zUnix.) annotationsN) ConfigParser)cached_property)Path) gettempdir) TYPE_CHECKINGNoReturn)XDGMixin)PlatformDirsABC)Iteratorwin32returnr c$d}t|)Nzshould only be used on Unix) RuntimeError)msgs O/var/www/html/speakWrite/venv/lib/python3.11/site-packages/platformdirs/unix.pygetuidrs+3)rceZdZdZed&dZed'dZed(dZed'd Z ed(d Z ed'd Z ed'd Z ed'd Z ed'dZed'dZed'dZed'dZed'dZed'dZed'dZed'dZed'dZed'dZed'dZed'dZed(dZed'dZed'dZed'dZed)dZed)d Zed)d!Z d*d#Z!d*d$Z"d%S)+ _UnixDefaultszDefault directories for Unix/Linux without XDG environment variable overrides. The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`. rboolc4|jotdkS)Nr)use_site_for_rootrselfs r _use_sitez_UnixDefaults._use_site$s%7&((a-7rstrcf|tjdS)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()001C1CDT1U1UVVVr list[str]cV|d|dgS)N/usr/local/share /usr/sharer"rs r_site_data_dirsz_UnixDefaults._site_data_dirs-s+112DEEtGhGhiuGvGvwwrcf|tjdS)z{:returns: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` ~/.configr!rs ruser_config_dirz_UnixDefaults.user_config_dir1s(001C1CK1P1PQQQrc.|dgS)Nz/etc/xdgr,rs r_site_config_dirsz_UnixDefaults._site_config_dirs6s11*==>>rcf|tjdS)zx:returns: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``$XDG_CACHE_HOME/$appname/$version``z~/.cacher!rs ruser_cache_dirz_UnixDefaults.user_cache_dir:s(001C1CJ1O1OPPPrc,|dS)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>>>rcf|tjdS)z~:returns: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version``z~/.local/stater!rs ruser_state_dirz_UnixDefaults.user_state_dirDr'rc,|dS)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~/VideosrFrs ruser_videos_dirz_UnixDefaults.user_videos_diros##3Z@@@rc"tddS)z<:returns: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/MusicrFrs ruser_music_dirz_UnixDefaults.user_music_dirts#?I>>>rc"tddS)z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/DesktoprFrs ruser_desktop_dirz_UnixDefaults.user_desktop_dirys##4kBBBrc@tjdS)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~sw!!.111rcdS)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|tjtjddS)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+w||BG../?@@.QQQrcddDS)NcNg|]"}tj|d#S)r^)r#r$r>).0ps r z9_UnixDefaults._site_applications_dirs..s(\\\A Q//\\\r)r*r+r[rs r_site_applications_dirsz%_UnixDefaults._site_applications_dirss\\9[\\\\rcl|j}|jrtj|n|dS)zR:returns: applications directory shared by users, e.g. ``/usr/share/applications``r)re multipathr#pathsepr>)rdirss rsite_applications_dirz#_UnixDefaults.site_applications_dirs0+(,Crzt$$$DGCrctjdrdt}nBtjdrdt}ndt}t j|tjstdt}||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_OKrr"r@s ruser_runtime_dirz_UnixDefaults.user_runtime_dirs < " "9 - - +.FHH..DD \ $ $%: ; ; +.FHH..DD***Dyrw'' 8 ll77VXX77D00666rcttjdrd}nd}||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. )rmrlrnz/var/runz/run)rorprqr"r@s rsite_runtime_dirz_UnixDefaults.site_runtime_dirs= < " "#C D D DDD00666rrc6||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_paths44T5GHHHrc6||jS)zg:returns: config path shared by users, returns the first item, even if ``multipath`` is set to ``True``)rxsite_config_dirrs rsite_config_pathz_UnixDefaults.site_config_paths44T5IJJJrc6||jS)zj:returns: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rxr6rs rsite_cache_pathz_UnixDefaults.site_cache_paths44T5HIIIr Iterator[str]c#6K|jV|jEd{VdS)z4:yield: all user and site configuration directories.N)r0r2rs riter_config_dirsz_UnixDefaults.iter_config_dirss6""""))))))))))rc#6K|jV|jEd{VdS)z+:yield: all user and site data directories.N)r&r-rs riter_data_dirsz_UnixDefaults.iter_data_dirss6    ''''''''''rN)rrrr)rr()rr)rr)#__name__ __module__ __qualname____doc__rrpropertyr&r-r0r2r4r6r8r:rArCrHrKrNrQrTrWrYr\r_rerjrtrvrzr}rrrr[rrrrs 888_8WWWXWxxxXxRRRXR???X?QQQXQ???X?WWWXW===X=X===X=GGGXGFFFXFEEEXEAAAXA???X?CCCXC222X2   X RRRXR]]]X]DDDXD 777X7 777X7 IIIXIKKKXKJJJXJ**** ((((((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 `. rrcF|jr|jntjS)zb:returns: data directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrysuperr&r __class__s rr&zUnix.user_data_dirs!&*^Nt!!9NNrcF|jr|jntjS)zd:returns: config directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr|rr0rs rr0zUnix.user_config_dirs!(,~Rt##577;RRrcF|jr|jntjS)zc:returns: cache directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr6rr4rs rr4zUnix.user_cache_dir!'+nPt""%'':PPrcF|jr|jntjS)zc:returns: state directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr:rr8rs rr8zUnix.user_state_dirrrcF|jr|jntjS)za:returns: log directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrCrrArs rrAzUnix.user_log_dir!%)NLt  8LLrcF|jr|jntjS)zj:returns: applications directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrjrr_rs rr_zUnix.user_applications_dirs!.2^^t))A^^rcF|jr|jntjS)ze:returns: runtime directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrvrrtrs rrtzUnix.user_runtime_dirs!)-Tt$$EGG " ' ' ) ) :V   888 9 9 9 : : : : : : : : : : : : : : : fUm # #4e}S!'',,||GRW%7%7%<%<=== 4s&+BB!$B!)rr )rrrrrr)rrrr)r __future__rr#ro configparserr functoolsrpathlibrtempfilertypingrr _xdgr apir collections.abcr rprrrrGr__all__r[rrrs """""" %%%%%%%%%%%%******** )((((((<7     s(s(s(s(s(Os(s(s(l1M1M1M1M1M8]1M1M1Mh3333 .  r