+ &i/"Rt^RIHt^RIt^RIt^RIHt^RIHt^RI H t ^RI H t ^RI HtHt^RIHt^R IHt]'d^R IHt]P,R 8XdR R ltM^RIHt!RR]4t!RR]]4tRRltRRltR.tR#)zUnix.) annotationsN) ConfigParser)cached_property)Path) gettempdir) TYPE_CHECKINGNoReturn)XDGMixin)PlatformDirsABC)Iteratorwin32cV^8dQhRR/#)returnr)formats"3/usr/lib/python3/dist-packages/platformdirs/unix.py __annotate__rs  H cRp\V4h)zshould only be used on Unix) RuntimeError)msgs rgetuidrs+3r)rc]tRt^tRt]RRl4t]RRl4t]RRl4t ]RR l4t ]R R l4t ]R R l4t ]RRl4t ]RRl4t]RRl4t]RRl4t]RRl4t]RRl4t]RRl4t]RRl4t]RRl4t]R R!l4t]R"R#l4t]R$R%l4t]R&R'l4t]R(R)l4t]R*R+l4t]R,R-l4t]R.R/l4t]R0R1l4t]R2R3l4t]R4R5l4t ]R6R7l4t!R8R9lt"R:R;lt#R _UnixDefaultszDefault directories for Unix/Linux without XDG environment variable overrides. The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`. cV^8dQhRR/#)rrboolr)rs"rr_UnixDefaults.__annotate__%s8848rc DVP;'d\4^8H#))use_site_for_rootrselfs&r _use_site_UnixDefaults._use_site$s%%77&(a-7rcV^8dQhRR/#rrstrr)rs"rrr)sWWsWrc ^VP\PPR44#)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 expanduserr!s&r user_data_dir_UnixDefaults.user_data_dir(%001C1CDT1UVVrcV^8dQhRR/#rrz list[str]r)rs"rrr.sxxxrc FVPR4VPR4.#/usr/local/sharez /usr/sharer+r!s&r_site_data_dirs_UnixDefaults._site_data_dirs-s%112DEtGhGhiuGvwwrcV^8dQhRR/#r&r)rs"rrr2sRRRrc ^VP\PPR44#)z{:returns: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` ~/.configr*r!s&ruser_config_dir_UnixDefaults.user_config_dir1s$001C1CK1PQQrcV^8dQhRR/#r3r)rs"rrr7s??9?rc &VPR4.#)z/etc/xdgr7r!s&r_site_config_dirs_UnixDefaults._site_config_dirs6s11*=>>rcV^8dQhRR/#r&r)rs"rrr;QQQrc ^VP\PPR44#)zx:returns: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``$XDG_CACHE_HOME/$appname/$version``z~/.cacher*r!s&ruser_cache_dir_UnixDefaults.user_cache_dir:s$001C1CJ1OPPrcV^8dQhRR/#r&r)rs"rrr@???rc $VPR4#)zP:returns: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cacher7r!s&rsite_cache_dir_UnixDefaults.site_cache_dir?s00>>rcV^8dQhRR/#r&r)rs"rrrEsWWWrc ^VP\PPR44#)z~:returns: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version``z~/.local/stater*r!s&ruser_state_dir_UnixDefaults.user_state_dirDr1rcV^8dQhRR/#r&r)rs"rrrJs===rc $VPR4#)zN:returns: state directory shared by users, e.g. ``/var/lib/$appname/$version``z/var/libr7r!s&rsite_state_dir_UnixDefaults.site_state_dirIs00<:returns: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/Videosrer!s&ruser_videos_dir_UnixDefaults.user_videos_diros##3Z@@rcV^8dQhRR/#r&r)rs"rrrurIrc \RR4#)z<:returns: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/Musicrer!s&ruser_music_dir_UnixDefaults.user_music_dirts#?I>>rcV^8dQhRR/#r&r)rs"rrrzsCC#Crc \RR4#)z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/Desktoprer!s&ruser_desktop_dir_UnixDefaults.user_desktop_dirys##4kBBrcV^8dQhRR/#r&r)rs"rrrs22c2rc @\PPR4#)z?:returns: bin directory tied to the user, e.g. ``~/.local/bin``z ~/.local/bin)r,r-r.r!s&r user_bin_dir_UnixDefaults.user_bin_dir~sww!!.11rcV^8dQhRR/#r&r)rs"rrrs  c rc R#)z@:returns: bin directory shared by users, e.g. ``/usr/local/bin``z/usr/local/binrr!s&r site_bin_dir_UnixDefaults.site_bin_dirs rcV^8dQhRR/#r&r)rs"rrrsRRsRrc |\PP\PPR4R4#)zW:returns: applications directory tied to the user, e.g. ``~/.local/share/applications``r) applications)r,r-rYr.r!s&ruser_applications_dir#_UnixDefaults.user_applications_dirs)ww||BGG../?@.QQrcV^8dQhRR/#r3r)rs"rrrs]]]rc lRUu.uF#p\PPVR4NK% up#uupi)r6rr5)r,r-rY)r"ps& r_site_applications_dirs%_UnixDefaults._site_applications_dirss+9[\9[A Q/9[\\\s)1cV^8dQhRR/#r&r)rs"rrrsDDsDrc VPpVP'd \PP V4#V^,#)zR:returns: applications directory shared by users, e.g. ``/usr/share/applications``)r multipathr,pathseprY)r"dirss& rsite_applications_dir#_UnixDefaults.site_applications_dirs3++(,rzzt$CDGCrcV^8dQhRR/#r&r)rs"rrr77#7rc \PPR4'dR\4 2pM@\PPR4'dR\4 2pM R\4 2p\P !V\P 4'g\4 R\4 2pVPV4#)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/z/var/run/user/z /run/user/z /runtime-)freebsdnetbsd) sysplatform startswithrr,accessW_OKrr+r[s& ruser_runtime_dir_UnixDefaults.user_runtime_dirs << " "9 - -#FH:.D \\ $ $%: ; ;#FH:.Dz*Dyyrww'' l^9VXJ7D0066rcV^8dQhRR/#r&r)rs"rrrrrc x\PPR4'dRpMRpVPV4#)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. z/var/runz/run)rrr)rrrr+r[s& rsite_runtime_dir_UnixDefaults.site_runtime_dirs5 << " "#C D DDD0066rcV^8dQhRR/#rrrr)rs"rrrsIIIrc 8VPVP4#)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_dirr!s&rsite_data_path_UnixDefaults.site_data_paths44T5G5GHHrcV^8dQhRR/#rr)rs"rrrsKK$Krc 8VPVP4#)zg:returns: config path shared by users, returns the first item, even if ``multipath`` is set to ``True``)rsite_config_dirr!s&rsite_config_path_UnixDefaults.site_config_paths44T5I5IJJrcV^8dQhRR/#rr)rs"rrrsJJJrc 8VPVP4#)zj:returns: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rrKr!s&rsite_cache_path_UnixDefaults.site_cache_paths44T5H5HIIrcV^8dQhRR/#rrz Iterator[str]r)rs"rrrs**-*rc# V"VPxVPRjxL R#L5i)z4:yield: all user and site configuration directories.N)r=rAr!s&riter_config_dirs_UnixDefaults.iter_config_dirss """)))) )')cV^8dQhRR/#rr)rs"rrrs(( (rc# V"VPxVPRjxL R#L5i)z+:yield: all user and site data directories.N)r/r8r!s&riter_data_dirs_UnixDefaults.iter_data_dirss    ''''rrN)%__name__ __module__ __qualname____firstlineno____doc__rr#propertyr/r8r=rArFrKrOrSr\r`rgrlrqrvr{rrrrrrrrrrrrr__static_attributes__rrrrrsR 88WWxxRR??QQ??WW====GGFFEEAA??CC22  RR]]DD 77 77 IIKKJJ* ((rrca]tRt^tRt]RV3Rll4t]RV3Rll4t]RV3Rll4t]RV3R ll4t ]R V3R ll4t ]R V3R ll4t ]RV3Rll4t ]RV3Rll4t RtV;t#)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 `. cV^8dQhRR/#r&r)rs"rrUnix.__annotate__sOOsOrc T<VP'd VP#\SV` #)zb:returns: data directory tied to the user, or site equivalent when root with ``use_site_for_root``)r#rsuperr/r" __class__s&rr/Unix.user_data_dirs#&*^^^t!!N9NNrcV^8dQhRR/#r&r)rs"rrrsSSSrc T<VP'd VP#\SV` #)zd:returns: config directory tied to the user, or site equivalent when root with ``use_site_for_root``)r#rrr=rs&rr=Unix.user_config_dirs#(,~~~t##R57;RRrcV^8dQhRR/#r&r)rs"rrrrDrc T<VP'd VP#\SV` #)zc:returns: cache directory tied to the user, or site equivalent when root with ``use_site_for_root``)r#rKrrFrs&rrFUnix.user_cache_dir#'+nnnt""P%':PPrcV^8dQhRR/#r&r)rs"rrrrDrc T<VP'd VP#\SV` #)zc:returns: state directory tied to the user, or site equivalent when root with ``use_site_for_root``)r#rSrrOrs&rrOUnix.user_state_dirrrcV^8dQhRR/#r&r)rs"rrrMMcMrc T<VP'd VP#\SV` #)za:returns: log directory tied to the user, or site equivalent when root with ``use_site_for_root``)r#r`rr\rs&rr\Unix.user_log_dir#%)NNNt  L8LLrcV^8dQhRR/#r&r)rs"rrrs__s_rc T<VP'd VP#\SV` #)zj:returns: applications directory tied to the user, or site equivalent when root with ``use_site_for_root``)r#rrrrs&rrUnix.user_applications_dirs#.2^^^t))^A^^rcV^8dQhRR/#r&r)rs"rrrsUU#Urc T<VP'd VP#\SV` #)ze:returns: runtime directory tied to the user, or site equivalent when root with ``use_site_for_root``)r#rrrrs&rrUnix.user_runtime_dirs#)-t$$TEGrsx " %%* (<<7 s(Os(l1M8]1Mh3 0  r