їj4AUdZddlmZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlmZmZdd lmZmZmZdd lmZmZej0d k(rdd Zndd lmZGddeZGddeeZej8dej:Zded<d dZ d!dZ!ddd"dZ"d#dZ#e$Z%ded<dZ&ded<dgZ'y)$zUnix.) annotationsN)suppress)Path) gettempdir)FinalNoReturn)XDGMixin _expand_user_xdg_dir)PlatformDirsABCRuntimeDirWarningwin32cd}t|)Nzshould only be used on Unix) RuntimeError)msgs VC:\Users\pivot\Documents\cueki\casual-preloader\Lib\site-packages\platformdirs/unix.pygetuidrs+3)rceZdZdZed!dZed"dZed#dZed"dZed#dZ ed"dZ ed"dZ ed"d Z ed"d Z ed"d Zed"d Zed"d Zed"dZed"dZed"dZed"dZed"dZed"dZed"dZed"dZd$dZed"dZed"dZed"dZed"dZed"dZed#dZd"dZ d"dZ!ed"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:|jtddS)zsData directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version``.~/.local/shareTprivate_append_app_name_and_versionr rs r user_data_dirz_UnixDefaults.user_data_dir'!00>N1OY]0^^rcF|jd|jdgS)N/usr/local/share /usr/share_join_app_name_and_versionrs r_site_data_dirsz_UnixDefaults._site_data_dirs,s%//0BCTEdEdeqErssrc:|jtddS)zrConfig directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version``. ~/.configTrr!rs ruser_config_dirz_UnixDefaults.user_config_dir0s 00k1JTX0YYrc&|jdgS)Nz/etc/xdgr(rs r_site_config_dirsz_UnixDefaults._site_config_dirs5s// ;<s00u0MMrc:|jtddS)zuState directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version``.z~/.local/stateTrr!rs ruser_state_dirz_UnixDefaults.user_state_dirCr$rc(|jddS)zEState directory shared by users, e.g. ``/var/lib/$appname/$version``.z/var/libFrr3rs rsite_state_dirz_UnixDefaults.site_state_dirHs00U0KKrc|j}|jr3tjj |d}|j |d|S)z_Log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it.logTr)r6opinionospathjoin_optionally_create_directoryrr=s r user_log_dirz_UnixDefaults.user_log_dirMsB"" <<77<<e,D  - -dD - A rc(|jddS)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/logFrr3rs r site_log_dirz_UnixDefaults.site_log_dirVs00U0KKrc&|jddS)z;Documents directory tied to the user, e.g. ``~/Documents``.XDG_DOCUMENTS_DIRz ~/Documents_user_media_dirrs ruser_documents_dirz _UnixDefaults.user_documents_dir_##$7GGrc&|jddS)z;Downloads directory tied to the user, e.g. ``~/Downloads``.XDG_DOWNLOAD_DIRz ~/DownloadsrFrs ruser_downloads_dirz _UnixDefaults.user_downloads_dirds##$6 FFrc&|jddS)z9Pictures directory tied to the user, e.g. ``~/Pictures``.XDG_PICTURES_DIRz ~/PicturesrFrs ruser_pictures_dirz_UnixDefaults.user_pictures_diri##$6 EErc&|jddS)z5Videos directory tied to the user, e.g. ``~/Videos``.XDG_VIDEOS_DIRz~/VideosrFrs ruser_videos_dirz_UnixDefaults.user_videos_dirns##$4jAArc&|jddS)z3Music directory tied to the user, e.g. ``~/Music``. XDG_MUSIC_DIRz~/MusicrFrs ruser_music_dirz_UnixDefaults.user_music_dirss##OY??rc&|jddS)z7Desktop directory tied to the user, e.g. ``~/Desktop``.XDG_DESKTOP_DIRz ~/DesktoprFrs ruser_desktop_dirz_UnixDefaults.user_desktop_dirxs##$5{CCrc&|jddS)z9Projects directory tied to the user, e.g. ``~/Projects``.XDG_PROJECTS_DIRz ~/ProjectsrFrs ruser_projects_dirz_UnixDefaults.user_projects_dir}rPrc&|jddS)z;Public share directory tied to the user, e.g. ``~/Public``.XDG_PUBLICSHARE_DIRz~/PublicrFrs ruser_publicshare_dirz"_UnixDefaults.user_publicshare_dirs##$9:FFrc&|jddS)z;Templates directory tied to the user, e.g. ``~/Templates``.XDG_TEMPLATES_DIRz ~/TemplatesrFrs ruser_templates_dirz _UnixDefaults.user_templates_dirrIrcXt|x}r|j||St|S)N)_get_user_dirs_folder"_optionally_create_media_directoryr )rkeydefaultr=s rrGz_UnixDefaults._user_media_dirs0(- -4 -  3 3D 9KG$$rctddS)z@Fonts directory tied to the user, e.g. ``~/.local/share/fonts``.rz/fontsr rs ruser_fonts_dirz_UnixDefaults.user_fonts_dirs/0188rc|jS)zCPreference directory tied to the user, same as ``user_config_dir``.)r-rs ruser_preference_dirz!_UnixDefaults.user_preference_dirs###rctdS)z6Bin directory tied to the user, e.g. ``~/.local/bin``.z ~/.local/binrirs r user_bin_dirz_UnixDefaults.user_bin_dirsN++rcy)z7Bin directory shared by users, e.g. ``/usr/local/bin``.z/usr/local/binrs r site_bin_dirz_UnixDefaults.site_bin_dirs rc>tdtjdS)zNApplications directory tied to the user, e.g. ``~/.local/share/applications``.r applications)r r<seprs ruser_applications_dirz#_UnixDefaults.user_applications_dirs /01"&&FFrchdDcgc]"}tjj|d$c}Scc}w)N)r&r'rs)r<r=r>)rps r_site_applications_dirsz%_UnixDefaults._site_applications_dirss+9[\9[A Q/9[\\\s'/cHtjjdrdt}n:tjjdrdt}n dt}tj j |r t|s|S|jS)Nopenbsdz/tmp/run/user/)freebsdnetbsdz/var/run/user/z /run/user/) sysplatform startswithrr<r=lexists_runtime_dir_problem_temp_runtime_dirr@s r_default_runtime_dirz"_UnixDefaults._default_runtime_dirs} << " "9 -#FH:.D \\ $ $%: ;#FH:.Dz*Dwwt,5I$5OtmUYUkUkUmmrc6tdt}tt5|j |ddddt |dx}rd|d}t ||jrt|jt|S#1swYUxYw)Nz /runtime-TrF check_modezruntime directory z; set XDG_RUNTIME_DIR instead) rrrFileExistsErrorr?rPermissionError ensure_existsrchmod_RUNTIME_DIR_MODE)rr=problemrs rrz_UnixDefaults._temp_runtime_dirs,y 3 o &  - -dD - A'*4EB B7 B&wi/LMC!#& &    J  . / ' &s BBcptjjdrd}nd}|j|dS)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. )r{rzr|z/var/runz/runFr)r}r~rr"r@s rsite_runtime_dirz_UnixDefaults.site_runtime_dirs7 << " "#C DDD00u0EErN)returnboolrstr)rz list[str])rfrrgrrr)#__name__ __module__ __qualname____doc__propertyrr#r*r-r/r1r4r6r8rArCrHrLrOrSrVrYr\r_rbrGrjrlrnrqrurxrrrrprrrrs[ 88__ttZZ==YYNN__LLLLHHGGFFBB@@DDFFGGHH% 99$$,,  GG]]n FFrrc eZdZdZedfd Zedfd Zedfd Zedfd Zedfd Z edfd Z edfd Z edfd Z edfd Z edfd Zedfd Zedfd ZxZS)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)zYData directory tied to the user, or site equivalent when root with ``use_site_for_root``.)r site_data_dirsuperr#r __class__s rr#zUnix.user_data_dirs!&*^^t!!N9NNrcH|jr |jSt| S)z[Config directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rsite_config_dirrr-rs rr-zUnix.user_config_dirs!(,~~t##R57;RRrcH|jr |jSt| S)zZCache directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rr4rr1rs rr1zUnix.user_cache_dir!'+nnt""P%':PPrcH|jr |jSt| S)zZState directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rr8rr6rs rr6zUnix.user_state_dirrrcH|jr |jSt| S)zXLog directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rrCrrArs rrAzUnix.user_log_dir!%)NNt  L8LLrcH|jr |jSt| S)zaApplications directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rsite_applications_dirrrurs rruzUnix.user_applications_dirs!.2^^t))^A^^rcv|jrtt|St dx}sd}nPt t 5|j|ddddt|x}s|j|dSd|}t|d|jx}|j|dS#1swYaxYw)aNRuntime directory tied to the user, e.g. ``$XDG_RUNTIME_DIR/$appname/$version``. Accepts ``$XDG_RUNTIME_DIR`` only as a directory, not a symlink, that the user owns with mode ``0700``, as the XDG spec requires, and creates a missing one that way under ``ensure_exists``. When the variable is unset or fails that check, emits one :class:`~platformdirs.RuntimeDirWarning` per cause and falls back to the platform default (``/tmp/run/user/`` on OpenBSD, ``/var/run/user/`` on FreeBSD/NetBSD, ``/run/user/`` elsewhere) if it passes the same check, else to ``runtime-`` in the temporary directory. Root with ``use_site_for_root`` gets the site equivalent. :raises PermissionError: if the temporary fallback is a symlink, not a directory, or owned by another user. XDG_RUNTIME_DIRzXDG_RUNTIME_DIR is not setTrNzXDG_RUNTIME_DIR z, falling back to ) rrr rr rrr?rr" _warn_oncer)rr=reasonrfallbackrs ruser_runtime_dirzUnix.user_runtime_dirs >>49 9 !23331F/*11$1E+3D99G988t8LL'y1FfX/T=V=V=X1X/Z[\0040HH +*s B//B8cH|jr |jSt| S)zXBin directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rrqrrnrs rrnzUnix.user_bin_dirrrcH|jr |jSt| S)zYData path tied to the user, or the first site entry when root with ``use_site_for_root``.)rsite_data_pathruser_data_pathrs rrzUnix.user_data_path#rrcH|jr |jSt| S)z[Config path tied to the user, or the first site entry when root with ``use_site_for_root``.)rsite_config_pathruser_config_pathrs rrzUnix.user_config_path(s!)-t$$TEG\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_LINEc^tdxs td}t|dz }|jsyd}|j t j d5}|D]2}tj|x}s|d|k(s$t|xs|}4 ddd|S#1swY|SxYw)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)encodingerrorsrf) r r rexistsopenr}getfilesystemencodingrmatch_resolve_user_dirs_value)rf config_homeuser_dirs_config_pathfolderstreamlineentrys rrdrdEs,-Jk1JK -0@@ ' ' ) F  # #S-F-F-HQb # cgmD(..t444%,#:M1%8BF d M d MsB"=B"B""B,c|d|dn|d}|dk(s|jdrtd|jd}}n|jdrd}ny|dtjdd |}||zS) Nquotedbarez$HOMEz$HOME/~/z\\(.)z\1)rr removeprefixresub)rvalueprefixs rrr[s"8_4E&M%/E 5++H5$S)5+=+=g+F   #  X"x. E>rTrc  tj}|j dz}t j|j dft j|j  df|jtx}k7d|jd|f|xr |tk7d|d dtd ff}tfd |DdS#t$rYyt$r}d|jcYd}~Sd}~wwxYw) zlReturn why ``path`` fails the checks of Qt's ``checkXdgRuntimeDir``, or ``None`` if it passes or is missing.Nz cannot be checked: iz is a symlinkzis not a directoryzis owned by uid z, not z has mode 04oc38K|]\}}|s d|yw) Nrp).0failedrr=s r z'_runtime_dir_problem..xs#MFfD67)$Fs  ) r<lstatFileNotFoundErrorOSErrorstrerrorst_modestatS_ISLNKS_ISDIRst_uidrrnext)r=rinfoerrormodeuidcheckss` rrris=xx~ <<% D dll #^4 \\$,, ' ')=>  )-=dkk]&QTPU+VW  1 11YtCjO`adNe3fg F MFMt TT  =+ENN+;<<=s#C C1C1C,&C1,C1cx|tvr2tj|tj|tdyy)N) stacklevel)_WARNEDaddwarningswarnr)messages rrr{s,g G g0Q?rzFinal[set[str]]rir)rr)rfrr str | None)rz re.Match[str]rr)r=rrrrr)rrrNone)(r __future__rr<rrr}r contextlibrpathlibrtempfilertypingrr_xdgr r r apir rr~rrrcompileVERBOSEr__annotations__rdrrrsetrr__all__rprrrs " "223<<7 zFOzFz\a8]\a~$JJ  , ;?U$@5  5   r