o TjB@sUdZddlmZddlZddlZddlZddlZddlmZddl m Z ddl m Z m Z mZddlmZmZdd lmZe rEdd lmZejd krPd!ddZnddlmZGdddeZGdddeeZedejZded<d"ddZd#dd ZdgZ dS)$zUnix.) annotationsN)Path) gettempdir) TYPE_CHECKINGFinalNoReturn)XDGMixin_xdg_dir)PlatformDirsABC)Iteratorwin32returnrcCs d}t|)Nzshould only be used on Unix) RuntimeError)msgrT/home/dinkstrade/pdmp-scanner/venv/lib/python3.10/site-packages/platformdirs/unix.pygetuidsr)rc@seZdZdZedYddZedZddZed[d d ZedZd d Zed[ddZ edZddZ edZddZ edZddZ edZddZ edZddZedZddZedZddZedZddZedZd d!ZedZd"d#ZedZd$d%ZedZd&d'ZedZd(d)ZedZd*d+ZedZd,d-Zd\d0d1ZedZd2d3ZedZd4d5ZedZd6d7ZedZd8d9ZedZd:d;Zed[dd?Z edZd@dAZ!dZdBdCZ"edZdDdEZ#ed]dGdHZ$ed]dIdJZ%d^dLdMZ&d^dNdOZ'd^dPdQZ(d^dRdSZ)d^dTdUZ*d^dVdWZ+dXS)_ _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)zsData 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/share_join_app_name_and_versionrrrr_site_data_dirs-sz_UnixDefaults._site_data_dirscCr)zrConfig 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)zoCache 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)zGCache directory shared by users, e.g. ``/var/cache/$appname/$version``.z /var/cacherrrrrsite_cache_dir? z_UnixDefaults.site_cache_dircCr)zuState 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.)zEState directory shared by users, e.g. ``/var/lib/$appname/$version``.z/var/libr/rrrrsite_state_dirIr1z_UnixDefaults.site_state_dircCs(|j}|jrtj|d}|||S)z_Log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it.log)r2opinionrr join_optionally_create_directoryrr rrr user_log_dirNs  z_UnixDefaults.user_log_dircCr.)zLog 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 |ddS)z;Documents directory tied to the user, e.g. ``~/Documents``.XDG_DOCUMENTS_DIRz ~/Documents_user_media_dirrrrruser_documents_dir` z _UnixDefaults.user_documents_dircCr;)z;Downloads directory tied to the user, e.g. ``~/Downloads``.XDG_DOWNLOAD_DIRz ~/Downloadsr=rrrruser_downloads_direr@z _UnixDefaults.user_downloads_dircCr;)z9Pictures directory tied to the user, e.g. ``~/Pictures``.XDG_PICTURES_DIRz ~/Picturesr=rrrruser_pictures_dirjr@z_UnixDefaults.user_pictures_dircCr;)z5Videos directory tied to the user, e.g. ``~/Videos``.XDG_VIDEOS_DIRz~/Videosr=rrrruser_videos_diror@z_UnixDefaults.user_videos_dircCr;)z3Music directory tied to the user, e.g. ``~/Music``. XDG_MUSIC_DIRz~/Musicr=rrrruser_music_dirtr@z_UnixDefaults.user_music_dircCr;)z7Desktop directory tied to the user, e.g. ``~/Desktop``.XDG_DESKTOP_DIRz ~/Desktopr=rrrruser_desktop_diryr@z_UnixDefaults.user_desktop_dircCr;)z9Projects directory tied to the user, e.g. ``~/Projects``.XDG_PROJECTS_DIRz ~/Projectsr=rrrruser_projects_dir~r@z_UnixDefaults.user_projects_dircCr;)z;Public share directory tied to the user, e.g. ``~/Public``.XDG_PUBLICSHARE_DIRz~/Publicr=rrrruser_publicshare_dirr@z"_UnixDefaults.user_publicshare_dircCr;)z;Templates directory tied to the user, e.g. ``~/Templates``.XDG_TEMPLATES_DIRz ~/Templatesr=rrrruser_templates_dirr@z _UnixDefaults.user_templates_dirkeydefaultcCs&t|}r |||Stj|SN)_get_user_dirs_folder"_optionally_create_media_directoryrr r!)rrQrRr rrrr>s   z_UnixDefaults._user_media_dircCstjddS)z@Fonts directory tied to the user, e.g. ``~/.local/share/fonts``.rz/fontsrr r!rrrruser_fonts_dirr#z_UnixDefaults.user_fonts_dircCs|jS)zCPreference directory tied to the user, same as ``user_config_dir``.)r+rrrruser_preference_dirsz!_UnixDefaults.user_preference_dircCs tjdS)z6Bin directory tied to the user, e.g. ``~/.local/bin``.z ~/.local/binrVrrrr user_bin_dirr@z_UnixDefaults.user_bin_dircCsdS)z7Bin directory shared by users, e.g. ``/usr/local/bin``.z/usr/local/binrrrrr site_bin_dirsz_UnixDefaults.site_bin_dircCstjtjddS)zNApplications directory tied to the user, e.g. ``~/.local/share/applications``.r applications)rr r6r!rrrruser_applications_dirsz#_UnixDefaults.user_applications_dircCsdddDS)NcSsg|] }tj|dqS)r[)rr r6).0prrr sz9_UnixDefaults._site_applications_dirs..)r%r&rrrrr_site_applications_dirssz%_UnixDefaults._site_applications_dirscCs |j}|jr tj|S|dS)zIApplications directory shared by users, e.g. ``/usr/share/applications``.r)r` multipathrpathsepr6)rdirsrrrsite_applications_dirsz#_UnixDefaults.site_applications_dircCs`tjdr dt}ntjdrdt}ndt}t|tjs+|}||S)a 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 ``runtime-$(id -u)`` in the temporary directory, with mode ``0700`` under ``ensure_exists``. :raises PermissionError: if another user owns the temporary fallback directory. openbsdz/tmp/run/user/)freebsdnetbsdz/var/run/user/z /run/user/) sysplatform startswithrraccessW_OK_temp_runtime_dirrr8rrruser_runtime_dirs    z_UnixDefaults.user_runtime_dircCstdt}}|jrt|jdddzt|}Wn ty*|YSw|j|krAd|d|jd|d}t||jrSt |j d @rSt| d|S) Nz /runtime-iT)modeexist_okzruntime directory z is owned by uid z, not z; set XDG_RUNTIME_DIR instead?) rr ensure_existsrmkdirlstatFileNotFoundErrorst_uidPermissionErrorstatS_IMODEst_modechmod)ruidr inforrrrrms  z_UnixDefaults._temp_runtime_dircCs tjdr d}nd}||S)aTRuntime 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)rhrirjrr8rrrsite_runtime_dirs  z_UnixDefaults.site_runtime_dirrcC ||jS)z`Data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``.)_first_site_dir_as_pathr)rrrrsite_data_pathr@z_UnixDefaults.site_data_pathcCr)z^Config path shared by users, returns the first item, even if ``multipath`` is set to ``True``.)rr,rrrrsite_config_pathr@z_UnixDefaults.site_config_path Iterator[str]cc&|js|jV||jEdHdSrS)rr+_create_as_yieldedr,rrrr_iter_config_dirssz_UnixDefaults._iter_config_dirsccrrS)rr"rr)rrrr_iter_data_dirssz_UnixDefaults._iter_data_dirscc|js|jV|jVdSrS)rr-r0rrrr_iter_cache_dirs z_UnixDefaults._iter_cache_dirsccrrS)rr2r3rrrr_iter_state_dirs rz_UnixDefaults._iter_state_dirsccrrS)rr9r:rrrr_iter_log_dirsrz_UnixDefaults._iter_log_dirsccs |jV|js|jVdSdSrS)rnrr~rrrr_iter_runtime_dirss  z _UnixDefaults._iter_runtime_dirsN)rrrr)rr$)rQrrRrrrrr)rr),__name__ __module__ __qualname____doc__propertyrr"r)r+r,r-r0r2r3r9r:r?rBrDrFrHrJrLrNrPr>rWrXrYrZr\r`rdrnrmr~rrrrrrrrrrrrrs                                      rcseZdZdZedfdd Zedfdd Zedfdd Zedfd d Zedfd d Z edfdd Z edfdd Z edfdd Z edfdd Z edfdd Zedfdd Zedfdd ZZS)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)zYData directory tied to the user, or site equivalent when root with ``use_site_for_root``.)r site_data_dirsuperr"r __class__rrr"%zUnix.user_data_dircr)z[Config directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rsite_config_dirrr+rrrrr+*rzUnix.user_config_dircr)zZCache directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rr0rr-rrrrr-/rzUnix.user_cache_dircr)zZState directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rr3rr2rrrrr24rzUnix.user_state_dircr)zXLog directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rr:rr9rrrrr99rzUnix.user_log_dircr)zaApplications directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rrdrr\rrrrr\>rzUnix.user_applications_dircs|jr tt|jStjS)z\Runtime directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rrr r~rnrrrrrnCszUnix.user_runtime_dircr)zXBin directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rrZrrYrrrrrYIrzUnix.user_bin_dirrcr)zYData path tied to the user, or the first site entry when root with ``use_site_for_root``.)rrruser_data_pathrrrrrNrzUnix.user_data_pathcr)z[Config path tied to the user, or the first site entry when root with ``use_site_for_root``.)rrruser_config_pathrrrrrSrzUnix.user_config_pathcr)zfPreference path tied to the user, or the first site config entry when root with ``use_site_for_root``.)rrruser_preference_pathrrrrrXrzUnix.user_preference_pathcr)zaApplications path tied to the user, or the first site entry when root with ``use_site_for_root``.)rsite_applications_pathruser_applications_pathrrrrr]rzUnix.user_applications_pathrr)rrrrrr"r+r-r2r9r\rnrYrrrr __classcell__rrrrrs4 ra [ \t]*(?P\w+)[ \t]*=[ \t]* # KEY=, blanks allowed around the key and after the = (?: "(?P(?:[^"\\]|\\.)*)" # a double-quoted value with backslash escapes, text after it ignored |(?P[^"\s].*?) # or an unquoted value, up to (?:[ \t]+\#.*|[ \t]*)$ # a comment, which sh starts at a word-initial #, or the line end ) r_USER_DIRS_LINErQr str | NonecCstdp tjd}t|d}|sdSd}|jtdd!}|D]}t |}r9|d|kr9t |p8|}q$Wd|S1sEwY|S)aReturn directory from user-dirs.dirs config file. ``xdg-user-dirs-update`` writes shell assignments, so match each line like ``xdg-user-dir`` does and keep the last valid assignment to ``key``. See https://freedesktop.org/wiki/Software/xdg-user-dirs/. XDG_CONFIG_HOMEr*zuser-dirs.dirsNsurrogateescape)encodingerrorsrQ) r rr r!rexistsopenrhgetfilesystemencodingrmatch_resolve_user_dirs_value)rQ config_homeuser_dirs_config_pathfolderstreamlineentryrrrrTps   rTr re.Match[str]cCs~|ddur |dn|d}|dks|dr$tjd|d}}n |dr,d}ndS|ddur;tdd |}||S) Nquotedbarez$HOMEz$HOME/~/z\\(.)z\1)rjrr r! removeprefixresub)rvalueprefixrrrrs  r)rr)rQrrr)rrrr)!r __future__rrrrxrhpathlibrtempfilertypingrrr_xdgr r apir collections.abcr rirrrcompileVERBOSEr__annotations__rTr__all__rrrrs6        ~I