q"h(SrSSKJr SSKrSSKrSSKJr SSKJr SSK J r J r SSK J r \ (aSS KJr \R S :XaSS jrOSS KJr "S S\ 5rSSjrSSjrS/rg)zUnix.) annotationsN) ConfigParser)Path) TYPE_CHECKINGNoReturn)PlatformDirsABC)Iteratorwin32cSn[U5e)Nzshould only be used on Unix) RuntimeError)msgs O/var/www/html/env/lib/python3.13/site-packages/pip/_vendor/platformdirs/unix.pygetuidrs+3)rc\rSrSrSr\SSj5r\SSj5r\SSj5r\SSj5r \SSj5r \SSj5r \SS j5r \SS j5r \SS j5r\SS j5r\SS j5r\SSj5r\SSj5r\SSj5r\SSj5r\SSj5r\SSj5r\SSj5r\SSj5r\SSj5r\SSj5rSSjrSSjrSrg) Unixaf On 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 `. c[RRSS5nUR5(d[RR S5nUR U5$)z~ :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version`` XDG_DATA_HOMEz~/.local/shareosenvirongetstrippath expanduser_append_app_name_and_versionselfrs r user_data_dirUnix.user_data_dir'sI zz~~or2zz||77%%&67D0066rc[RRSS5nUR5(dS[RS3nUR [R5Vs/sHo R U5PM sn$s snf)N XDG_DATA_DIRSrz/usr/local/sharez /usr/share)rrrrpathsepsplitrr!rps r_site_data_dirsUnix._site_data_dirs2sczz~~or2zz||%bjj\Bjj>TU>T11!4>TUUUs+BcURnUR(dUS$[RR U5$)a: :return: data directories shared by users (if `multipath ` is enabled and ``XDG_DATA_DIRS`` is set and a multi path the response is also a multi path separated by the OS path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version`` r)r* multipathrr&joinr!dirss r site_data_dirUnix.site_data_dir9s2##~~7Nzzt$$rc[RRSS5nUR5(d[RR S5nUR U5$)z} :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` XDG_CONFIG_HOMErz ~/.configrr s ruser_config_dirUnix.user_config_dirFsI zz~~/4zz||77%%k2D0066rc[RRSS5nUR5(dSnUR [R 5Vs/sHo R U5PM sn$s snf)NXDG_CONFIG_DIRSrz/etc/xdg)rrrrr'r&rr(s r_site_config_dirsUnix._site_config_dirsQsWzz~~/4zz||D>Bjj>TU>T11!4>TUUUsA6cURnUR(dUS$[RR U5$)a :return: config directories shared by users (if `multipath ` is enabled and ``XDG_CONFIG_DIRS`` is set and a multi path the response is also a multi path separated by the OS path separator), e.g. ``/etc/xdg/$appname/$version`` r)r9r-rr&r.r/s rsite_config_dirUnix.site_config_dirXs2%%~~7Nzzt$$rc[RRSS5nUR5(d[RR S5nUR U5$)z| :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``~/$XDG_CACHE_HOME/$appname/$version`` XDG_CACHE_HOMErz~/.cacherr s ruser_cache_dirUnix.user_cache_diresI zz~~.3zz||77%%j1D0066rc$URS5$)zO:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cache)rr!s rsite_cache_dirUnix.site_cache_dirps00>>rc[RRSS5nUR5(d[RR S5nUR U5$)z :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version`` XDG_STATE_HOMErz~/.local/staterr s ruser_state_dirUnix.user_state_dirusJ zz~~.3zz||77%%&67D0066rcURnUR(a1[RR US5nUR U5 U$)zg:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in itlog)rHopinionrrr._optionally_create_directoryr s r user_log_dirUnix.user_log_dirs="" <<77<<e,D  - -d 3 rc[SS5$)zC:return: documents directory tied to the user, e.g. ``~/Documents``XDG_DOCUMENTS_DIRz ~/Documents_get_user_media_dirrCs ruser_documents_dirUnix.user_documents_dirs##6 FFrc[SS5$)zC:return: downloads directory tied to the user, e.g. ``~/Downloads``XDG_DOWNLOAD_DIRz ~/DownloadsrRrCs ruser_downloads_dirUnix.user_downloads_dirs##5}EErc[SS5$)zA:return: pictures directory tied to the user, e.g. ``~/Pictures``XDG_PICTURES_DIRz ~/PicturesrRrCs ruser_pictures_dirUnix.user_pictures_dirs##5|DDrc[SS5$)z=:return: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/VideosrRrCs ruser_videos_dirUnix.user_videos_dirs##3Z@@rc[SS5$)z;:return: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/MusicrRrCs ruser_music_dirUnix.user_music_dirs#?I>>rc[SS5$)z?:return: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/DesktoprRrCs ruser_desktop_dirUnix.user_desktop_dirs##4kBBrcb[RRSS5nUR5(dj[R R S5(a9S[53n[U5R5(d S[53nO S[53nURU5$)aJ :return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or ``$XDG_RUNTIME_DIR/$appname/$version``. For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/user/$(id -u)/$appname/$version`` if exists, otherwise ``/tmp/runtime-$(id -u)/$appname/$version``, if``$XDG_RUNTIME_DIR`` is not set. XDG_RUNTIME_DIRrfreebsdopenbsdnetbsdz/var/run/user/z /tmp/runtime-z /run/user/) rrrrsysplatform startswithrrexistsrr s ruser_runtime_dirUnix.user_runtime_dirszz~~/4zz||||&&'GHH'z2Dz((***68*5D#FH:.0066rc[RRSS5nUR5(d)[R R S5(aSnOSnURU5$)a5 :return: 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. rkrrlz/var/runz/run)rrrrrprqrrrr s rsite_runtime_dirUnix.site_runtime_dirsUzz~~/4zz||||&&'GHH!0066rc8URUR5$)zh:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``) _first_item_as_path_if_multipathr1rCs rsite_data_pathUnix.site_data_paths44T5G5GHHrc8URUR5$)zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)rzr<rCs rsite_config_pathUnix.site_config_paths44T5I5IJJrc8URUR5$)zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rzrDrCs rsite_cache_pathUnix.site_cache_paths44T5H5HIIrc#T# URv URShvN gN7f)z4:yield: all user and site configuration directories.N)r5r9rCs riter_config_dirsUnix.iter_config_dirss """)))) (&(c#T# URv URShvN gN7f)z+:yield: all user and site data directories.N)r"r*rCs riter_data_dirsUnix.iter_data_dirss    ''''rN)returnstr)rz list[str])rr)rz Iterator[str])__name__ __module__ __qualname____firstlineno____doc__propertyr"r*r1r5r9r<r@rDrHrNrTrXr\r`rdrhrtrwr{r~rrr__static_attributes__rrrrrs 77VV  % %77VV  % %77??77GGFFEEAA??CC77&77*IIKKJJ* (rrc[U5nUcT[RRUS5R 5nU(d[R R U5nU$)Nr)_get_user_dirs_folderrrrrrr)env_varfallback_tilde_path media_dirs rrSrSsM%g.IJJNN7B/557 **+>?I rc[[5R5S- nUR5(a[ 5nUR 5nUR SUR535 SSS5 XS;agUSURS5nURS[RRS55$g!,(df  N^=f)zo Return directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/. zuser-dirs.dirsz[top] Ntop"z$HOME~) rrr5rsropen read_stringreadrreplacerrr)keyuser_dirs_config_pathparserstreamrs rrrs!!7!78;KK##%% " ' ' )V   8 9* Um #e}S!'',||GRWW%7%7%<== * )s #C  C)rr)rrrrrr)rrrz str | None)r __future__rrrp configparserrpathlibrtypingrrapir collections.abcr rqrrrSr__all__rrrrs^ " %* (<<7 N(?N(b4  r