T=j4SrSSKJr SSKrSSKrSSKJr SSKJr SSK J r SSK J r SSK JrJr S S KJr S S KJr \(aSS KJr \R,S :XaSSjrOSSKJr "SS\5r"SS\\5rSSjrSSjrS/rg)zUnix.) annotationsN) ConfigParser)cached_property)Path) gettempdir) TYPE_CHECKINGNoReturn)XDGMixin)PlatformDirsABC)Iteratorwin32cSn[U5e)Nzshould only be used on Unix) RuntimeError)msgs a/Users/stevendouglas/BidBrain/.venv/lib/python3.13/site-packages/pip/_vendor/platformdirs/unix.pygetuidrs+3)rc\rSrSrSr\S'Sj5r\S(Sj5r\S)Sj5r \S(Sj5r \S)Sj5r \S(Sj5r \S(S j5r \S(S j5r\S(S j5r\S(S j5r\S(S j5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S(Sj5r\S)Sj5r \S(Sj5r!\S(Sj5r"\S(Sj5r#\S*S j5r$\S*S!j5r%\S*S"j5r&S+S#jr'S+S$jr(S%r)g&), _UnixDefaultszDefault directories for Unix/Linux without XDG environment variable overrides. The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`. cBUR=(a [5S:H$)Nr)use_site_for_rootrselfs r _use_site_UnixDefaults._use_site$s%%7&(a-7rc^UR[RRS55$)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 expanduserrs r user_data_dir_UnixDefaults.user_data_dir(%001C1CDT1UVVrcFURS5URS5/$)N/usr/local/share /usr/sharer!rs r_site_data_dirs_UnixDefaults._site_data_dirs-s%112DEtGhGhiuGvwwrc^UR[RRS55$)z{:returns: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` ~/.configr rs ruser_config_dir_UnixDefaults.user_config_dir1s$001C1CK1PQQrc&URS5/$)Nz/etc/xdgr+rs r_site_config_dirs_UnixDefaults._site_config_dirs6s11*=>>rc^UR[RRS55$)zx:returns: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``$XDG_CACHE_HOME/$appname/$version``z~/.cacher rs ruser_cache_dir_UnixDefaults.user_cache_dir:s$001C1CJ1OPPrc$URS5$)zP:returns: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cacher+rs rsite_cache_dir_UnixDefaults.site_cache_dir?s00>>rc^UR[RRS55$)z~:returns: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version``z~/.local/stater rs ruser_state_dir_UnixDefaults.user_state_dirDr'rc$URS5$)zN:returns: state directory shared by users, e.g. ``/var/lib/$appname/$version``z/var/libr+rs rsite_state_dir_UnixDefaults.site_state_dirIs00<:returns: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/VideosrNrs ruser_videos_dir_UnixDefaults.user_videos_diros##3Z@@rc[SS5$)z<:returns: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/MusicrNrs ruser_music_dir_UnixDefaults.user_music_dirts#?I>>rc[SS5$)z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/DesktoprNrs ruser_desktop_dir_UnixDefaults.user_desktop_dirys##4kBBrc[SS5$)zB:returns: projects directory tied to the user, e.g. ``~/Projects``XDG_PROJECTS_DIRz ~/ProjectsrNrs ruser_projects_dir_UnixDefaults.user_projects_dir~r[rc[SS5$)zD:returns: public share directory tied to the user, e.g. ``~/Public``XDG_PUBLICSHARE_DIRz~/PublicrNrs ruser_publicshare_dir"_UnixDefaults.user_publicshare_dirs##8*EErc[SS5$)zD:returns: templates directory tied to the user, e.g. ``~/Templates``XDG_TEMPLATES_DIRz ~/TemplatesrNrs ruser_templates_dir _UnixDefaults.user_templates_dirrRrcF[RRS5S3$)zI:returns: fonts directory tied to the user, e.g. ``~/.local/share/fonts``rz/fontsr"r#r$rs ruser_fonts_dir_UnixDefaults.user_fonts_dirs"''$$%567v>>rcUR$)zL:returns: preference directory tied to the user, same as ``user_config_dir``)r0rs ruser_preference_dir!_UnixDefaults.user_preference_dirs###rc@[RRS5$)z?:returns: bin directory tied to the user, e.g. ``~/.local/bin``z ~/.local/binrurs r user_bin_dir_UnixDefaults.user_bin_dirsww!!.11rcg)z@:returns: bin directory shared by users, e.g. ``/usr/local/bin``z/usr/local/binrs r site_bin_dir_UnixDefaults.site_bin_dirs rc|[RR[RRS5S5$)zW:returns: applications directory tied to the user, e.g. ``~/.local/share/applications``r applications)r"r#rDr$rs ruser_applications_dir#_UnixDefaults.user_applications_dirs)ww||BGG../?@.QQrcnSVs/sH#n[RRUS5PM% sn$s snf)N)r)r*r)r"r#rD)rps r_site_applications_dirs%_UnixDefaults._site_applications_dirss+9[\9[A Q/9[\\\s*2cURnUR(a[RR U5$US$)zR:returns: applications directory shared by users, e.g. ``/usr/share/applications``r)r multipathr"pathseprD)rdirss rsite_applications_dir#_UnixDefaults.site_applications_dirs1++(,rzzt$CDGCrc[RRS5(aS[53nO?[RRS5(aS[53nO S[53n[R "U[R 5(d[5S[53nURU5$)aX: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 startswithrr"accessW_OKrr!rFs ruser_runtime_dir_UnixDefaults.user_runtime_dirs << " "9 - -#FH:.D \\ $ $%: ; ;#FH:.Dz*Dyyrww'' l^9VXJ7D0066rcv[RRS5(aSnOSnURU5$)a.: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. )rrrz/var/runz/run)rrrr!rFs rsite_runtime_dir_UnixDefaults.site_runtime_dirs5 << " "#C D DDD0066rc8URUR5$)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_dirrs rsite_data_path_UnixDefaults.site_data_paths44T5G5GHHrc8URUR5$)zg:returns: config path shared by users, returns the first item, even if ``multipath`` is set to ``True``)rsite_config_dirrs rsite_config_path_UnixDefaults.site_config_paths44T5I5IJJrc8URUR5$)zj:returns: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rr9rs rsite_cache_path_UnixDefaults.site_cache_paths44T5H5HIIrc#v# UR(dURv URShvN gN7f)z4:yield: all user and site configuration directories.N)rr0r3rs riter_config_dirs_UnixDefaults.iter_config_dirss'~~&& &)))) /979c#v# UR(dURv URShvN gN7f)z+:yield: all user and site data directories.N)rr%r,rs riter_data_dirs_UnixDefaults.iter_data_dirss'~~$$ $''''rrN)returnboolrstr)rz list[str])rr)rz Iterator[str])*__name__ __module__ __qualname____firstlineno____doc__rrpropertyr%r,r0r3r6r9r<r?rGrJrPrUrYr^rbrfrjrnrrrvryr|rrrrrrrrrrr__static_attributes__rrrrrs 88WWxxRR??QQ??WW====GGFFEEAA??CCEEFFGG??$$22  RR]]DD 77 77 IIKKJJ* (rrc^\rSrSrSr\S U4Sjj5r\S U4Sjj5r\S U4Sjj5r\S U4Sjj5r \S U4Sjj5r \S U4Sjj5r \S U4S jj5r \S U4S jj5r S rU=r$) UnixaNOn 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 `. cR>UR(a UR$[TU] $)zb:returns: data directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrsuperr%r __class__s rr%Unix.user_data_dirs!&*^^t!!N9NNrcR>UR(a UR$[TU] $)zd:returns: config directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrrr0rs rr0Unix.user_config_dirs!(,~~t##R57;RRrcR>UR(a UR$[TU] $)zc:returns: cache directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr9rr6rs rr6Unix.user_cache_dir!'+nnt""P%':PPrcR>UR(a UR$[TU] $)zc:returns: state directory tied to the user, or site equivalent when root with ``use_site_for_root``)rr?rr<rs rr<Unix.user_state_dirrrcR>UR(a UR$[TU] $)za:returns: log directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrJrrGrs rrGUnix.user_log_dir !%)NNt  L8LLrcR>UR(a UR$[TU] $)zj:returns: applications directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrrrrs rrUnix.user_applications_dirs!.2^^t))^A^^rcR>UR(a UR$[TU] $)ze:returns: runtime directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrrrrs rrUnix.user_runtime_dirs!)-t$$TEGUR(a UR$[TU] $)za:returns: bin directory tied to the user, or site equivalent when root with ``use_site_for_root``)rrrr|rs rr|Unix.user_bin_dirrrrr)rrrrrrr%r0r6r<rGrrr|r __classcell__)rs@rrrsOOSSQQQQMM__UUMMrrch[U5=n(aU$[RRU5$)N)_get_user_dirs_folderr"r#r$)env_varfallback_tilde_path media_dirs rrOrO"s.)'22y2 77  1 22rc<[RRSS5R5=(d [RR S5n[ U5S- nUR5(a[5nUR5nURSUR535 SSS5 XS;agUSURS5nURS [RR S 55$g!,(df  N^=f) znReturn directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/. XDG_CONFIG_HOMEr/zuser-dirs.dirsz[top] Ntop"z$HOME~) r"environgetstripr#r$rexistsropen read_stringreadreplace)key config_homeuser_dirs_config_pathparserstreamr#s rrr(s **..!2B7==?b277CUCUVaCbK -0@@##%% " ' ' )V   8 9* Um #e}S!'',||GRWW%7%7%<== * )s #D  D)rr )rrrrrr)rrrz str | None)r __future__rr"r configparserr functoolsrpathlibrtempfilertypingrr _xdgr apir collections.abcr rrrrrOr__all__rrrrsx " %%* (<<7 N(ON(b1M8]1Mh3 0  r