j,AUdZddlmZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlmZmZdd lmZmZmZdd lmZmZejd krd+dZnddlmZGddeZGddeeZejdejZded<d,dZ d-dZ!ddd.d#Z"d/d&Z#e$Z%d'ed(<d)Z&ded*<dgZ'dS)0zUnix.) annotationsN)suppress)Path) gettempdir)FinalNoReturn)XDGMixin _expand_user_xdg_dir)PlatformDirsABCRuntimeDirWarningwin32returnrc$d}t|)Nzshould only be used on Unix) RuntimeError)msgs BC:\Projects\Historical\venv\Lib\site-packages\platformdirs/unix.pygetuidrs+3)rceZdZdZed'dZed(dZed)dZed(d Zed)d Z ed(d Z ed(d Z ed(d Z ed(dZ ed(dZed(dZed(dZed(dZed(dZed(dZed(dZed(dZed(dZed(dZed(dZd*dZed(dZed(dZed(dZed(d Zed(d!Zed)d"Zd(d#Z d(d$Z!ed(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-7rstrcJ|tddS)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>N1O1OY]0^^^r list[str]cV|d|dgS)N/usr/local/share /usr/share_join_app_name_and_versionrs r_site_data_dirsz_UnixDefaults._site_data_dirs,s+//0BCCTEdEdeqErErssrcJ|tddS)zrConfig directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version``. ~/.configTr"r$rs ruser_config_dirz_UnixDefaults.user_config_dir0s&00k1J1JTX0YYYrc.|dgS)Nz/etc/xdgr,rs r_site_config_dirsz_UnixDefaults._site_config_dirs5s// ;;<s00u0MMMrcJ|tddS)zuState directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version``.z~/.local/stateTr"r$rs ruser_state_dirz_UnixDefaults.user_state_dirCr'rc0|ddS)zEState directory shared by users, e.g. ``/var/lib/$appname/$version``.z/var/libFr"r7rs rsite_state_dirz_UnixDefaults.site_state_dirHs00U0KKKrc|j}|jr7tj|d}||d|S)z_Log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it.logTr")r:opinionospathjoin_optionally_create_directoryrrAs r user_log_dirz_UnixDefaults.user_log_dirMsJ" < B7<<e,,D  - -dD - A A A rc0|ddS)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/logFr"r7rs r site_log_dirz_UnixDefaults.site_log_dirVs00U0KKKrc.|ddS)z;Documents directory tied to the user, e.g. ``~/Documents``.XDG_DOCUMENTS_DIRz ~/Documents_user_media_dirrs ruser_documents_dirz _UnixDefaults.user_documents_dir_##$7GGGrc.|ddS)z;Downloads directory tied to the user, e.g. ``~/Downloads``.XDG_DOWNLOAD_DIRz ~/DownloadsrJrs ruser_downloads_dirz _UnixDefaults.user_downloads_dirds##$6 FFFrc.|ddS)z9Pictures directory tied to the user, e.g. ``~/Pictures``.XDG_PICTURES_DIRz ~/PicturesrJrs ruser_pictures_dirz_UnixDefaults.user_pictures_diri##$6 EEErc.|ddS)z5Videos directory tied to the user, e.g. ``~/Videos``.XDG_VIDEOS_DIRz~/VideosrJrs ruser_videos_dirz_UnixDefaults.user_videos_dirns##$4jAAArc.|ddS)z3Music directory tied to the user, e.g. ``~/Music``. XDG_MUSIC_DIRz~/MusicrJrs ruser_music_dirz_UnixDefaults.user_music_dirss##OY???rc.|ddS)z7Desktop directory tied to the user, e.g. ``~/Desktop``.XDG_DESKTOP_DIRz ~/DesktoprJrs ruser_desktop_dirz_UnixDefaults.user_desktop_dirxs##$5{CCCrc.|ddS)z9Projects directory tied to the user, e.g. ``~/Projects``.XDG_PROJECTS_DIRz ~/ProjectsrJrs ruser_projects_dirz_UnixDefaults.user_projects_dir}rTrc.|ddS)z;Public share directory tied to the user, e.g. ``~/Public``.XDG_PUBLICSHARE_DIRz~/PublicrJrs ruser_publicshare_dirz"_UnixDefaults.user_publicshare_dirs##$9:FFFrc.|ddS)z;Templates directory tied to the user, e.g. ``~/Templates``.XDG_TEMPLATES_DIRz ~/TemplatesrJrs ruser_templates_dirz _UnixDefaults.user_templates_dirrMrkeydefaultcpt|x}r|||St|S)N)_get_user_dirs_folder"_optionally_create_media_directoryr )rrgrhrAs rrKz_UnixDefaults._user_media_dirs>(-- -4   3 3D 9 9 9KG$$$rc&tddS)z@Fonts directory tied to the user, e.g. ``~/.local/share/fonts``.r!z/fontsr rs ruser_fonts_dirz_UnixDefaults.user_fonts_dirs/008888rc|jS)zCPreference directory tied to the user, same as ``user_config_dir``.)r1rs ruser_preference_dirz!_UnixDefaults.user_preference_dirs ##rc tdS)z6Bin directory tied to the user, e.g. ``~/.local/bin``.z ~/.local/binrmrs r user_bin_dirz_UnixDefaults.user_bin_dirsN+++rcdS)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#/00F"&FFFFrcddDS)NcNg|]"}tj|d#S)rw)r@rArB).0ps r z9_UnixDefaults._site_applications_dirs..s(\\\A Q//\\\r)r*r+rtrs r_site_applications_dirsz%_UnixDefaults._site_applications_dirss\\9[\\\\rcptjdrdt}nBtjdrdt}ndt}tj|rt|s|n|S)Nopenbsdz/tmp/run/user/)freebsdnetbsdz/var/run/user/z /run/user/) sysplatform startswithrr@rAlexists_runtime_dir_problem_temp_runtime_dirrDs r_default_runtime_dirz"_UnixDefaults._default_runtime_dirs < " "9 - - +.FHH..DD \ $ $%: ; ; +.FHH..DD***Dwt,,m5I$5O5OmttUYUkUkUmUmmrcvtdt}tt5||ddddn #1swxYwYt |dx}rd|d}t ||jr't| t|S)Nz /runtime-Tr"F check_modezruntime directory z; set XDG_RUNTIME_DIR instead) rrrFileExistsErrorrCrPermissionError ensure_existsrchmod_RUNTIME_DIR_MODE)rrAproblemrs rrz_UnixDefaults._temp_runtime_dirs ,,3333 o & & B B  - -dD - A A A B B B B B B B B B B B B B B B*4EBBB B7 'MwMMMC!#&& &   0 JJ  . / / / sAAAcxtjdrd}nd}||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. )rrrz/var/runz/runFr")rrrr%rDs rsite_runtime_dirz_UnixDefaults.site_runtime_dirsB < " "#C D D DDD00u0EEErN)rrrr)rr()rgrrhrrr)#__name__ __module__ __qualname____doc__propertyrr&r.r1r3r5r8r:r<rErGrLrPrSrWrZr]r`rcrfrKrnrprrruryrrrrrtrrrrs 888X8___X_tttXtZZZXZ===X=YYYXYNNNXN___X_LLLXLXLLLXLHHHXHGGGXGFFFXFBBBXB@@@X@DDDXDFFFXFGGGXGHHHXH%%%% 999X9$$$X$,,,X,   X GGGXG]]]X]nnnn    FFFXFFFrrcheZdZdZedfd 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 `. rrcF|jr|jntjS)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!&*^Nt!!9NNrcF|jr|jntjS)z[Config directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rsite_config_dirrr1rs rr1zUnix.user_config_dirs!(,~Rt##577;RRrcF|jr|jntjS)zZCache directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rr8rr5rs rr5zUnix.user_cache_dir!'+nPt""%'':PPrcF|jr|jntjS)zZState directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rr<rr:rs rr:zUnix.user_state_dirrrcF|jr|jntjS)zXLog directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rrGrrErs rrEzUnix.user_log_dir!%)NLt  8LLrcF|jr|jntjS)zaApplications directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rsite_applications_dirrryrs rryzUnix.user_applications_dirs!.2^^t))A^^rc|jrtt|jSt dx}sd}npt t 5||ddddn #1swxYwYt|x}s| |dSd|}t|d| x}| |dS)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 setTr"NzXDG_RUNTIME_DIR z, falling back to ) rrr rr rOSErrorrCrr% _warn_oncer)rrAreasonrfallbackrs ruser_runtime_dirzUnix.user_runtime_dirsN > :4((9 9 !2333 21FF'"" F F11$1EEE F F F F F F F F F F F F F F F3D999G M88t8LLL111Ff[[T=V=V=X=X1X[[\\\0040HHHs A//A36A3cF|jr|jntjS)zXBin directory tied to the user, or site equivalent when root with ``use_site_for_root``.)rrurrrrs rrrzUnix.user_bin_dirrrrcF|jr|jntjS)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#rrcF|jr|jntjS)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!)-Tt$$EGG\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_LINErgr str | Nonectdptd}t|dz }|sdSd}|t jd5}|D];}t|x}r|d|krt|p|}< dddn #1swxYwY|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_HOMEr0zuser-dirs.dirsNsurrogateescape)encodingerrorsrg) r r rexistsopenrgetfilesystemencodingrmatch_resolve_user_dirs_value)rg config_homeuser_dirs_config_pathfolderstreamlineentrys rrjrjEs2,--Jk1J1JK --0@@ ' ' ) )t F  # #S-F-H-HQb # c cCgm C CD(..t444 C%,#:M:M1%88BF CCCCCCCCCCCCCCCC Ms1?B==CCr re.Match[str]c,|d|dn|d}|dks|dr%td|d}}n|drd}ndS|dtjdd |}||zS) Nquotedbarez$HOMEz$HOME/~/z\\(.)z\1)rr removeprefixresub)rvalueprefixs rrr[s"8_4E&MM%/E 5++H55$S))5+=+=g+F+F   #  t X"x.. E>rTrrArrc  tj}n/#t$rYdSt$r}d|jcYd}~Sd}~wwxYw|jdz}t j|jdft j|j df|j tx}kd|j d|f|o |tkd|d dtd ff}tfd |DdS) 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 04oc30K|]\}}|d|VdS) Nrt)r|failedrrAs r z'_runtime_dir_problem..xs:MMfMD$$7$$MMMMMMr) r@lstatFileNotFoundErrorrstrerrorst_modestatS_ISLNKS_ISDIRst_uidrrnext)rArinfoerrormodeuidcheckss` rrris0=x~~ tt ===<  )+Vdk+V+VQT+V+VW  1 113ft3f3f3fO`3f3f3fg F MMMMFMMMt T TTs A A ?AAmessageNonec|tvr8t|tj|tddSdS)N) stacklevel)_WARNEDaddwarningswarnr)rs rrr{sEg G g0Q??????rzFinal[set[str]]rir)rr)rgrrr)rrrr)rArrrrr)rrrr)(r __future__rr@rrrr contextlibrpathlibrtempfilertypingrr_xdgr r r apir rrrrrcompileVERBOSEr__annotations__rjrrrsetrr__all__rtrrrsZ """""" """"""""222222222233333333<7     zFzFzFzFzFOzFzFzFz\a\a\a\a\a8]\a\a\a~$J      ,    ;?UUUUUU$@@@@355     r