+ i(Rt^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)Iteratorwin32cV^8dQhRR/#)returnr)formats"d/home/wkmabra/.openclaw/workspace/venv/lib/python3.14/site-packages/pip/_vendor/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+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 `. cV^8dQhRR/#r r strr )rs"rrUnix.__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`` XDG_DATA_HOMEz~/.local/shareosenvirongetstrippath expanduser_append_app_name_and_versionselfr$s& r user_data_dirUnix.user_data_dir'sI zz~~or2zz||77%%&67D0066rcV^8dQhRR/#r r z list[str]r )rs"rrr3sVVVrc \PPRR4pVP4'gR\P R2pVP \P4Uu.uFq P V4NK up#uupi) XDG_DATA_DIRSrz/usr/local/sharez /usr/share)r r!r"r#pathsepsplitr&r(r$ps& r_site_data_dirsUnix._site_data_dirs2sczz~~or2zz||%bjj\Bjj>TU>T11!4>TUUUs,BcV^8dQhRR/#rr )rs"rrr: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`` )r3 multipathr r/joinr(dirss& r site_data_dirUnix.site_data_dir9s4##~~~7Nzzt$$rcV^8dQhRR/#rr )rs"rrrGs777rc \PPRR4pVP4'g \PP R4pVP V4#)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%%k2D0066rcV^8dQhRR/#r,r )rs"rrrRsVV9Vrc \PPRR4pVP4'gRpVP \P 4Uu.uFq P V4NK up#uupi)XDG_CONFIG_DIRSrz/etc/xdg)r r!r"r#r0r/r&r1s& r_site_config_dirsUnix._site_config_dirsQsWzz~~/4zz||D>Bjj>TU>T11!4>TUUUsA6cV^8dQhRR/#rr )rs"rrrYs % % %rc VPpVP'g V^,#\PP V4#)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`` )rEr7r r/r8r9s& rsite_config_dirUnix.site_config_dirXs4%%~~~7Nzzt$$rcV^8dQhRR/#rr )rs"rrrf777rc \PPRR4pVP4'g \PP R4pVP V4#)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%%j1D0066rcV^8dQhRR/#rr )rs"rrrq???rc $VPR4#)zO:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cache)r&r(s&rsite_cache_dirUnix.site_cache_dirps00>>rcV^8dQhRR/#rr )rs"rrrvrLrc \PPRR4pVP4'g \PP R4pVP V4#)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%%&67D0066rcV^8dQhRR/#rr )rs"rrrscrc VPpVP'd2\PP VR4pVP V4V#)zg:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in itlog)rZopinionr r$r8_optionally_create_directoryr's& r user_log_dirUnix.user_log_dirs?"" <<<77<<e,D  - -d 3 rcV^8dQhRR/#rr )rs"rrrsGGCGrc \RR4#)zC:return: documents directory tied to the user, e.g. ``~/Documents``XDG_DOCUMENTS_DIRz ~/Documents_get_user_media_dirrTs&ruser_documents_dirUnix.user_documents_dirs##6 FFrcV^8dQhRR/#rr )rs"rrrsFFCFrc \RR4#)zC:return: downloads directory tied to the user, e.g. ``~/Downloads``XDG_DOWNLOAD_DIRz ~/DownloadsrfrTs&ruser_downloads_dirUnix.user_downloads_dirs##5}EErcV^8dQhRR/#rr )rs"rrrsEE3Erc \RR4#)zA:return: pictures directory tied to the user, e.g. ``~/Pictures``XDG_PICTURES_DIRz ~/PicturesrfrTs&ruser_pictures_dirUnix.user_pictures_dirs##5|DDrcV^8dQhRR/#rr )rs"rrrsAAArc \RR4#)z=:return: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/VideosrfrTs&ruser_videos_dirUnix.user_videos_dirs##3Z@@rcV^8dQhRR/#rr )rs"rrrrRrc \RR4#)z;:return: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/MusicrfrTs&ruser_music_dirUnix.user_music_dirs#?I>>rcV^8dQhRR/#rr )rs"rrrsCC#Crc \RR4#)z?:return: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/DesktoprfrTs&ruser_desktop_dirUnix.user_desktop_dirs##4kBBrcV^8dQhRR/#rr )rs"rrrs77#7rc h\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/freebsdopenbsdnetbsd) r r!r"r#sysplatform startswithrrexistsr&r's& ruser_runtime_dirUnix.user_runtime_dirszz~~/4zz||||&&'GHH'z2Dz((***68*5D#FH:.0066rcV^8dQhRR/#rr )rs"rrrs77#7rc \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. rrz/var/runz/runr)r r!r"r#rrrr&r's& rsite_runtime_dirUnix.site_runtime_dirsUzz~~/4zz||||&&'GHH!0066rcV^8dQhRR/#r r rr )rs"rrrsIIIrc 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;rTs&rsite_data_pathUnix.site_data_paths44T5G5GHHrcV^8dQhRR/#rr )rs"rrrsKK$Krc 8VPVP4#)zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)rrIrTs&rsite_config_pathUnix.site_config_paths44T5I5IJJrcV^8dQhRR/#rr )rs"rrrsJJJrc 8VPVP4#)zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rrUrTs&rsite_cache_pathUnix.site_cache_paths44T5H5HIIrcV^8dQhRR/#r r z Iterator[str]r )rs"rrrs**-*rc# V"VPxVPRjxL R#L5i)z4:yield: all user and site configuration directories.N)r@rErTs&riter_config_dirsUnix.iter_config_dirss """)))) )')cV^8dQhRR/#rr )rs"rrrs(( (rc# V"VPxVPRjxL R#L5i)z+:yield: all user and site data directories.N)r)r3rTs&riter_data_dirsUnix.iter_data_dirss    ''''rr N)__name__ __module__ __qualname____firstlineno____doc__propertyr)r3r;r@rErIrOrUrZrarhrmrrrwr|rrrrrrrr__static_attributes__r rrrrs 77VV  % %77VV  % %77??77GGFFEEAA??CC77&77*IIKKJJ* ((rrc$V^8dQhRRRRRR/#)r env_varrfallback_tilde_pathr r )rs"rrrs!33rc\V4pVfV\PPVR4P 4pV'g \P P V4pV#)Nr)_get_user_dirs_folderr r!r"r#r$r%)rr media_dirs&& rrgrgsM%g.IJJNN7B/557 **+>?I rc V^8dQhRRRR/#)r keyrr z str | Noner )rs"rrrsszrc\\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] Ntop"z$HOME~) rrr@rropen read_stringreadr#replacer r$r%)ruser_dirs_config_pathparserstreamr$s& rrrs!!7!78;KK##%% " ' ' ) )V   8 9* Um #e}S!'',||GRWW%7%7%<== * )s #C'' C7 )r __future__rr r configparserrpathlibrtypingrrapircollections.abcrrrrrgr__all__r rrrs^ " %* (<<7 N(?N(b4  r