+ h)csRt^RIHt^RIt^RIt^RIHt^RIHt^RI H t H t ^RI H t ]PR8XdRR ltM^R IHt!R R ] 4tR RltRRltR .tR#)zUnix.) annotationsN) ConfigParser)Path)IteratorNoReturn)PlatformDirsABCZwin32cV^8dQhRR/#)returnrZformat"I/usr/lib/python3.14/site-packages/setuptools/_vendor/platformdirs/unix.py __annotate__r s  H csRp\V4h)zshould only be used on Unix)Z RuntimeError)Zmsgs r getuidrs+3r)rcs ]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+l4tR,R-ltR.R/ltR0R1ltR2tR3#)4Unixaf 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 `. crrrstrr r r r r Unix.__annotate__%s77s7rc \PPRR4pVP4'g \PP R4pVP V4#)z~ :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version`` Z XDG_DATA_HOMEz~/.local/shareosenvirongetstrippath expanduser_append_app_name_and_versionselfr& r user_data_dirZUnix.user_data_dir$sI zz~~or2zz||77%%&67D0066rcrrrz list[str]r r r r r r0sVVVrc s\PPRR4pVP4'gR\P R2pVP \P4Uu.uFq P V4NK up#uupi)Z XDG_DATA_DIRSrz/usr/local/sharez /usr/share)rrrrpathsepsplitrrrZp& r _site_data_dirsZUnix._site_data_dirs/sczz~~or2zz||%bjj\Bjj>TU>T11!4>TUUUs,Bcrrr r r r r r7s % %s %rc VPpVP'g V^,#\PP V4#)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' multipathrr#joinrZdirsr r site_data_dirZUnix.site_data_dir6s4##~~~7Nzzt$$rcrrr r r r r rDs777rc r)z} :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` ZXDG_CONFIG_HOMErz ~/.configrrr r user_config_dirZUnix.user_config_dirCsI zz~~/4zz||77%%k2D0066rcrr"r r r r r rOsVV9Vrc s\PPRR4pVP4'gRpVP \P 4Uu.uFq P V4NK up#uupi)ZXDG_CONFIG_DIRSrz/etc/xdg)rrrrr$r#rr%r&r _site_config_dirsZUnix._site_config_dirsNsWzz~~/4zz||D>Bjj>TU>T11!4>TUUUsA6crrr r r r r rVs % % %rc r()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.r)rr#r*r+r r site_config_dirZUnix.site_config_dirUs4%%~~~7Nzzt$$rcrrr r r r r rc777rc r)z| :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``~/$XDG_CACHE_HOME/$appname/$version`` ZXDG_CACHE_HOMErz~/.cacherrr r user_cache_dirZUnix.user_cache_dirbsI zz~~.3zz||77%%j1D0066rcrrr r r r r rn???rc s$VPR4#)zO:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cache)rr&r site_cache_dirZUnix.site_cache_dirms00>>rcrrr r r r r rsr0rc r)z :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version`` ZXDG_STATE_HOMErz~/.local/staterrr r user_state_dirZUnix.user_state_dirrsJ zz~~.3zz||77%%&67D0066rcrrr r r r r r~scrc sVPpVP'd2\PP VR4pVP V4V#)zg:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in itZlog)r6Zopinionrrr*Z_optionally_create_directoryrr r user_log_dirZUnix.user_log_dir}s?"" <<<77<<e,D  - -d 3 rcrrr r r r r rsGGCGrc \RR4#)zC:return: documents directory tied to the user, e.g. ``~/Documents``ZXDG_DOCUMENTS_DIRz ~/Documents_get_user_media_dirr3r4r user_documents_dirZUnix.user_documents_dirs##6 FFrcrrr r r r r rsFFCFrc r8)zC:return: downloads directory tied to the user, e.g. ``~/Downloads``ZXDG_DOWNLOAD_DIRz ~/Downloadsr9r3r4r user_downloads_dirZUnix.user_downloads_dirs##5}EErcrrr r r r r rsEE3Erc r8)zA:return: pictures directory tied to the user, e.g. ``~/Pictures``ZXDG_PICTURES_DIRz ~/Picturesr9r3r4r user_pictures_dirZUnix.user_pictures_dirs##5|DDrcrrr r r r r rsAAArc r8)z=:return: videos directory tied to the user, e.g. ``~/Videos``ZXDG_VIDEOS_DIRz~/Videosr9r3r4r user_videos_dirZUnix.user_videos_dirs##3Z@@rcrrr r r r r rr2rc r8)z;:return: music directory tied to the user, e.g. ``~/Music``Z XDG_MUSIC_DIRz~/Musicr9r3r4r user_music_dirZUnix.user_music_dirs#?I>>rcrrr r r r r rsCC#Crc r8)z?:return: desktop directory tied to the user, e.g. ``~/Desktop``ZXDG_DESKTOP_DIRz ~/Desktopr9r3r4r user_desktop_dirZUnix.user_desktop_dirs##4kBBrcrrr r r r r rs77#7rc sh\PPRR4pVP4'gm\P P R4'd;R\4 2p\V4P4'gR\4 2pM R\4 2pVPV4#)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_DIRrz/var/run/user/z /tmp/runtime-z /run/user/ZfreebsdZopenbsdZnetbsd) rrrrsysplatform startswithrrexistsrrr r user_runtime_dirZUnix.user_runtime_dirszz~~/4zz||||&&'GHH'z2Dz((***68*5D#FH:.0066rcrrr r r r r rs77#7rc s\PPRR4pVP4'g+\P P R4'dRpMRpVPV4#)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. rArz/var/runz/runrB)rrrrrCrDrErrr r site_runtime_dirZUnix.site_runtime_dirsUzz~~/4zz||||&&'GHH!0066rcrrrrr r r r r rsIIIrc 8VPVP4#)zh:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``) _first_item_as_path_if_multipathr,r3r4r site_data_pathZUnix.site_data_paths44T5G5GHHrcrrIr r r r r rsKK$Krc rJ)zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)rKr/r3r4r site_config_pathZUnix.site_config_paths44T5I5IJJrcrrIr r r r r rsJJJrc rJ)zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rKr5r3r4r site_cache_pathZUnix.site_cache_paths44T5H5HIIrc V^8dQhRRRR/#)r directoryrrrr r r r r rs#$rc sVP'd'VP\P4^,p\ V4#)i)r)r$rr#r)rrPs&&r rKZ%Unix._first_item_as_path_if_multipaths, >>>! 3A6IIrcrrrz Iterator[str]r r r r r rs**-*rc# V"VPxVPRjxL R#L5i)z4:yield: all user and site configuration directories.N)r-r.r3r4r iter_config_dirsZUnix.iter_config_dirss """)))) )')crrQr r r r r rs(( (rc# rR)z+:yield: all user and site data directories.N)r!r'r3r4r iter_data_dirsZUnix.iter_data_dirss    ''''rTr N)Z__name__Z __module__Z __qualname__Z__firstlineno____doc__Zpropertyr!r'r,r-r.r/r1r5r6r7r;r<r=r>r?r@rGrHrLrMrNrKrSrUZ__static_attributes__r rr rrs 77VV  % %77VV  % %77??77GGFFEEAA??CC77&77*IIKKJJ * ((rrcs$V^8dQhRRRRRR/#)renv_varrfallback_tilde_pathrr r r r r r s!33rcs\V4pVfV\PPVR4P 4pV'g \P P V4pV#)Nr)_get_user_dirs_folderrrrrrr)rWrXZ media_dirs&& r r:r:sM%g.IJJNN7B/557 **+>?I rcrO)rkeyrrz str | Noner r r r r r sszrcs\\4P4R, pVP4'd\ 4pVP 4;_uu_4pVP RVP4 24RRR4WR,9dR#VR,V,PR4pVPR\PPR44#R# +'giLo;i)zo Return directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/. zuser-dirs.dirsz[top] NZtopZ"z$HOMEZ~) rrr-rFrZopenZ read_stringZreadrZreplacerrr)rZZuser_dirs_config_pathZparserZstreamrs& r rYrYs!!7!78;KK##%% " ' ' ) )V   8 9* Um #e}S!'',||GRWW%7%7%<== * )s #C'' C7 )rVZ __future__rrrCZ configparserrZpathlibrZtypingrrZapirrDrrr:rYZ__all__r rr r[sX " %% <<7 T(?T(n4  r