+ h(csRt^RIHt^RIt^RIt^RIHt^RIHt^RI H t H t ^RI H t ] 'd^RIHt]P R8XdR R ltM^R IHt!R R ] 4tRRltRRltR .tR#)zUnix.) annotationsN) ConfigParser)Path) TYPE_CHECKINGNoReturn)PlatformDirsABC)IteratorZwin32cV^8dQhRR/#)returnrZformat"B/usr/lib/python3.14/site-packages/pip/_vendor/platformdirs/unix.py __annotate__rs  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/ltR0tR1#)2Unixaf 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 `. crrr strr r r r rUnix.__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%%&67D0066rcrrr z list[str]r r r r rr3sVVVrc s\PPRR4pVP4'gR\P R2pVP \P4Uu.uFq P V4NK up#uupi)Z XDG_DATA_DIRSrz/usr/local/sharez /usr/share)rrrrpathsepsplitrr rZp& r _site_data_dirsZUnix._site_data_dirs2sczz~~or2zz||%bjj\Bjj>TU>T11!4>TUUUs,Bcrrr r r r rr:s % %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$joinr Zdirsr!r site_data_dirZUnix.site_data_dir9s4##~~~7Nzzt$$rcrrr r r r rrGs777rc 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_dirFsI zz~~/4zz||77%%k2D0066rcrr#r r r r rrRsVV9Vrc 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_dirsQsWzz~~/4zz||D>Bjj>TU>T11!4>TUUUsA6crrr r r r rrYs % % %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_dirXs4%%~~~7Nzzt$$rcrrr r r r rrf777rc 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_diresI zz~~.3zz||77%%j1D0066rcrrr r r r rrq???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_dirps00>>rcrrr r r r rrvr1rc 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_dirusJ zz~~.3zz||77%%&67D0066rcrrr r r r rrscrc 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)r7Zopinionrrr+Z_optionally_create_directoryrr!r user_log_dirZUnix.user_log_dirs?"" <<<77<<e,D  - -d 3 rcrrr r r r rrsGGCGrc \RR4#)zC:return: documents directory tied to the user, e.g. ``~/Documents``ZXDG_DOCUMENTS_DIRz ~/Documents_get_user_media_dirr4r5r user_documents_dirZUnix.user_documents_dirs##6 FFrcrrr r r r rrsFFCFrc r9)zC:return: downloads directory tied to the user, e.g. ``~/Downloads``ZXDG_DOWNLOAD_DIRz ~/Downloadsr:r4r5r user_downloads_dirZUnix.user_downloads_dirs##5}EErcrrr r r r rrsEE3Erc r9)zA:return: pictures directory tied to the user, e.g. ``~/Pictures``ZXDG_PICTURES_DIRz ~/Picturesr:r4r5r user_pictures_dirZUnix.user_pictures_dirs##5|DDrcrrr r r r rrsAAArc r9)z=:return: videos directory tied to the user, e.g. ``~/Videos``ZXDG_VIDEOS_DIRz~/Videosr:r4r5r user_videos_dirZUnix.user_videos_dirs##3Z@@rcrrr r r r rrr3rc r9)z;:return: music directory tied to the user, e.g. ``~/Music``Z XDG_MUSIC_DIRz~/Musicr:r4r5r user_music_dirZUnix.user_music_dirs#?I>>rcrrr r r r rrsCC#Crc r9)z?:return: desktop directory tied to the user, e.g. ``~/Desktop``ZXDG_DESKTOP_DIRz ~/Desktopr:r4r5r user_desktop_dirZUnix.user_desktop_dirs##4kBBrcrrr r r r rrs77#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 rrs77#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. rBrz/var/runz/runrC)rrrrrDrErFrrr!r site_runtime_dirZUnix.site_runtime_dirsUzz~~/4zz||||&&'GHH!0066rcrrr rr r r r rrsIIIrc 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-r4r5r site_data_pathZUnix.site_data_paths44T5G5GHHrcrrJr r r r rrsKK$Krc rK)zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)rLr0r4r5r site_config_pathZUnix.site_config_paths44T5I5IJJrcrrJr r r r rrsJJJrc rK)zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rLr6r4r5r site_cache_pathZUnix.site_cache_paths44T5H5HIIrcrrr z Iterator[str]r r r r rrs**-*rc# V"VPxVPRjxL R#L5i)z4:yield: all user and site configuration directories.N)r.r/r4r5r iter_config_dirsZUnix.iter_config_dirss """)))) )')crrPr r r r rrs(( (rc# rQ)z+:yield: all user and site data directories.N)r"r(r4r5r iter_data_dirsZUnix.iter_data_dirss    ''''rSr N)Z__name__Z __module__Z __qualname__Z__firstlineno____doc__Zpropertyr"r(r-r.r/r0r2r6r7r8r<r=r>r?r@rArHrIrMrNrOrRrTZ__static_attributes__r rr rrs 77VV  % %77VV  % %77??77GGFFEEAA??CC77&77*IIKKJJ* ((rrcs$V^8dQhRRRRRR/#)renv_varrfallback_tilde_pathr r r r r rrs!33rcs\V4pVfV\PPVR4P 4pV'g \P P V4pV#)Nr)_get_user_dirs_folderrrrrrr)rVrWZ media_dirs&& r r;r;sM%g.IJJNN7B/557 **+>?I rcs V^8dQhRRRR/#)rkeyrr z str | Noner r r r rrsszrcs\\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.rGrZopenZ read_stringZreadrZreplacerrr)rYZuser_dirs_config_pathZparserZstreamrs& r rXrXs!!7!78;KK##%% " ' ' ) )V   8 9* Um #e}S!'',||GRWW%7%7%<== * )s #C'' C7 )rUZ __future__rrrDZ configparserrZpathlibrZtypingrrZapirZcollections.abcrrErrr;rXZ__all__r rr rZs^ " %* (<<7 N(?N(b4  r