o iN/@sdZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZmZd d lmZd d lmZerDdd lmZejd krOd ddZnddlmZGdddeZGdddeeZd!ddZd"ddZdgZdS)#zUnix.) annotationsN) ConfigParser)cached_property)Path) gettempdir) TYPE_CHECKINGNoReturn)XDGMixin)PlatformDirsABC)Iteratorwin32returnrcCs d}t|)Nzshould only be used on Unix) RuntimeError)msgrO/home/ubuntu/transcripts/venv/lib/python3.10/site-packages/platformdirs/unix.pygetuidsr)rc@seZdZdZedCddZedDddZedEd d ZedDd d Z edEddZ edDddZ edDddZ edDddZ edDddZedDddZedDddZedDddZedDddZedDd d!ZedDd"d#ZedDd$d%ZedDd&d'ZedDd(d)ZedDd*d+ZedDd,d-ZedEd.d/ZedDd0d1ZedDd2d3ZedDd4d5ZedFd7d8ZedFd9d:ZedFd;d<Z dGd>d?Z!dGd@dAZ"dBS)H _UnixDefaultszDefault directories for Unix/Linux without XDG environment variable overrides. The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`. rboolcCs|jotdkS)Nr)use_site_for_rootrselfrrr _use_site$sz_UnixDefaults._use_sitestrcC|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 expanduserrrrr user_data_dir(z_UnixDefaults.user_data_dir list[str]cCs|d|dgS)N/usr/local/share /usr/sharerrrrr_site_data_dirs-sz_UnixDefaults._site_data_dirscCr)z{:returns: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` ~/.configrrrrruser_config_dir1r#z_UnixDefaults.user_config_dircCs |dgS)Nz/etc/xdgr'rrrr_site_config_dirs6s z_UnixDefaults._site_config_dirscCr)zx:returns: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``$XDG_CACHE_HOME/$appname/$version``z~/.cacherrrrruser_cache_dir:r#z_UnixDefaults.user_cache_dircC |dS)zP:returns: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cacher'rrrrsite_cache_dir? z_UnixDefaults.site_cache_dircCr)z~:returns: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version``z~/.local/staterrrrruser_state_dirDr#z_UnixDefaults.user_state_dircCr-)zN:returns: state directory shared by users, e.g. ``/var/lib/$appname/$version``z/var/libr'rrrrsite_state_dirIr/z_UnixDefaults.site_state_dircCs(|j}|jrtj|d}|||S)zh:returns: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in itlog)r0opinionrr join_optionally_create_directoryrr rrr user_log_dirNs  z_UnixDefaults.user_log_dircCr-)z:returns: log directory shared by users, e.g. ``/var/log/$appname/$version`` Unlike `user_log_dir`, ``opinion`` has no effect since ``/var/log`` is inherently a log directory. z/var/logr'rrrr site_log_dirWs z_UnixDefaults.site_log_dircC tddS)zD:returns: documents directory tied to the user, e.g. ``~/Documents``XDG_DOCUMENTS_DIRz ~/Documents_get_user_media_dirrrrruser_documents_dir`r/z _UnixDefaults.user_documents_dircCr9)zD:returns: downloads directory tied to the user, e.g. ``~/Downloads``XDG_DOWNLOAD_DIRz ~/Downloadsr;rrrruser_downloads_direr/z _UnixDefaults.user_downloads_dircCr9)zB:returns: pictures directory tied to the user, e.g. ``~/Pictures``XDG_PICTURES_DIRz ~/Picturesr;rrrruser_pictures_dirjr/z_UnixDefaults.user_pictures_dircCr9)z>:returns: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/Videosr;rrrruser_videos_diror/z_UnixDefaults.user_videos_dircCr9)z<:returns: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/Musicr;rrrruser_music_dirtr/z_UnixDefaults.user_music_dircCr9)z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/Desktopr;rrrruser_desktop_diryr/z_UnixDefaults.user_desktop_dircCs tjdS)z?:returns: bin directory tied to the user, e.g. ``~/.local/bin``z ~/.local/bin)rr r!rrrr user_bin_dir~ z_UnixDefaults.user_bin_dircCsdS)z@:returns: bin directory shared by users, e.g. ``/usr/local/bin``z/usr/local/binrrrrr site_bin_dirsz_UnixDefaults.site_bin_dircCstjtjddS)zW:returns: applications directory tied to the user, e.g. ``~/.local/share/applications``r applications)rr r4r!rrrruser_applications_dirsz#_UnixDefaults.user_applications_dircCsdddDS)NcSsg|] }tj|dqS)rK)rr r4).0prrr sz9_UnixDefaults._site_applications_dirs..)r%r&rrrrr_site_applications_dirssz%_UnixDefaults._site_applications_dirscCs |j}|jr tj|S|dS)zR:returns: applications directory shared by users, e.g. ``/usr/share/applications``r)rP multipathrpathsepr4)rdirsrrrsite_applications_dirsz#_UnixDefaults.site_applications_dircCsjtjdr dt}ntjdrdt}ndt}t|tjs0tdt}||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 startswithrraccessW_OKrrr6rrruser_runtime_dirs    z_UnixDefaults.user_runtime_dircCs tjdr d}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. )rVrUrWz/var/runz/run)rXrYrZrr6rrrsite_runtime_dirs  z_UnixDefaults.site_runtime_dirrcC ||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_dirrrrrsite_data_pathrIz_UnixDefaults.site_data_pathcCr_)zg:returns: config path shared by users, returns the first item, even if ``multipath`` is set to ``True``)r`site_config_dirrrrrsite_config_pathrIz_UnixDefaults.site_config_pathcCr_)zj:returns: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r`r.rrrrsite_cache_pathrIz_UnixDefaults.site_cache_path Iterator[str]cc|jV|jEdHdS)z4:yield: all user and site configuration directories.N)r*r+rrrriter_config_dirsz_UnixDefaults.iter_config_dirsccrg)z+:yield: all user and site data directories.N)r"r(rrrriter_data_dirsriz_UnixDefaults.iter_data_dirsN)rrrr)rr$)rr)rrf)#__name__ __module__ __qualname____doc__rrpropertyr"r(r*r+r,r.r0r1r7r8r=r?rArCrErGrHrJrLrPrTr]r^rbrdrerhrjrrrrrst                            rcseZdZdZedfdd Zedfdd Zedfdd Zedfd d Zedfd d Z edfdd Z edfdd Z edfdd Z Z 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 `. rrc|jr|jStjS)zb:returns: data directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrasuperr"r __class__rrr"zUnix.user_data_dircrr)zd:returns: config directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrcrsr*rrtrrr*rvzUnix.user_config_dircrr)zc:returns: cache directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr.rsr,rrtrrr,rvzUnix.user_cache_dircrr)zc:returns: state directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr1rsr0rrtrrr0rvzUnix.user_state_dircrr)za:returns: log directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr8rsr7rrtrrr7rvzUnix.user_log_dircrr)zj:returns: applications directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrTrsrLrrtrrrLrvzUnix.user_applications_dircrr)ze:returns: runtime directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr^rsr]rrtrrr]rvzUnix.user_runtime_dircrr)za:returns: bin directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrJrsrHrrtrrrHrvzUnix.user_bin_dirrk)rlrmrnrorpr"r*r,r0r7rLr]rH __classcell__rrrtrrqs$ rqenv_varrfallback_tilde_pathcCst|}r|Stj|S)N)_get_user_dirs_folderrr r!)rxry media_dirrrrr<s  r<key str | NonecCsttjdd}|rJt}|}|d|Wdn1s*wY||dvr7dS|d| d}| dtjdSdS) zvReturn directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/. r)zuser-dirs.dirsz[top] Ntop"z$HOME~) rrr r!existsropen read_stringreadstripreplace)r|user_dirs_config_pathparserstreamr rrrrz s  rz)rr)rxrryrrr)r|rrr})ro __future__rrrX configparserr functoolsrpathlibrtempfilertypingrr_xdgr apir collections.abcr rYrrrqr<rz__all__rrrrs.           7 4