+ h)Rt^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)PlatformDirsABCwin32cV^8dQhRR/#)returnr)formats"F/usr/lib/python3/dist-packages/setuptools/_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/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 `. cV^8dQhRR/#r r strr )r s"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 )r s"rrr0sVVVrc \PPRR4pVP4'gR\P R2pVP \P4Uu.uFq P V4NK up#uupi) XDG_DATA_DIRSrz/usr/local/sharez /usr/share)rr r!r"pathsepsplitr%r'r#ps& r_site_data_dirsUnix._site_data_dirs/sczz~~or2zz||%bjj\Bjj>TU>T11!4>TUUUs,BcV^8dQhRR/#rr )r s"rrr7s % %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`` )r2 multipathrr.joinr'dirss& r site_data_dirUnix.site_data_dir6s4##~~~7Nzzt$$rcV^8dQhRR/#rr )r s"rrrDs777rc \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_dirCsI zz~~/4zz||77%%k2D0066rcV^8dQhRR/#r+r )r s"rrrOsVV9Vrc \PPRR4pVP4'gRpVP \P 4Uu.uFq P V4NK up#uupi)XDG_CONFIG_DIRSrz/etc/xdg)rr r!r"r/r.r%r0s& r_site_config_dirsUnix._site_config_dirsNsWzz~~/4zz||D>Bjj>TU>T11!4>TUUUsA6cV^8dQhRR/#rr )r s"rrrVs % % %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`` )rDr6rr.r7r8s& rsite_config_dirUnix.site_config_dirUs4%%~~~7Nzzt$$rcV^8dQhRR/#rr )r s"rrrc777rc \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_dirbsI zz~~.3zz||77%%j1D0066rcV^8dQhRR/#rr )r s"rrrn???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_dirms00>>rcV^8dQhRR/#rr )r s"rrrsrKrc \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_dirrsJ zz~~.3zz||77%%&67D0066rcV^8dQhRR/#rr )r s"rrr~scrc 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)rYopinionrr#r7_optionally_create_directoryr&s& r user_log_dirUnix.user_log_dir}s?"" <<<77<<e,D  - -d 3 rcV^8dQhRR/#rr )r s"rrrsGGCGrc \RR4#)zC:return: documents directory tied to the user, e.g. ``~/Documents``XDG_DOCUMENTS_DIRz ~/Documents_get_user_media_dirrSs&ruser_documents_dirUnix.user_documents_dirs##6 FFrcV^8dQhRR/#rr )r s"rrrsFFCFrc \RR4#)zC:return: downloads directory tied to the user, e.g. ``~/Downloads``XDG_DOWNLOAD_DIRz ~/DownloadsrerSs&ruser_downloads_dirUnix.user_downloads_dirs##5}EErcV^8dQhRR/#rr )r s"rrrsEE3Erc \RR4#)zA:return: pictures directory tied to the user, e.g. ``~/Pictures``XDG_PICTURES_DIRz ~/PicturesrerSs&ruser_pictures_dirUnix.user_pictures_dirs##5|DDrcV^8dQhRR/#rr )r s"rrrsAAArc \RR4#)z=:return: videos directory tied to the user, e.g. ``~/Videos``XDG_VIDEOS_DIRz~/VideosrerSs&ruser_videos_dirUnix.user_videos_dirs##3Z@@rcV^8dQhRR/#rr )r s"rrrrQrc \RR4#)z;:return: music directory tied to the user, e.g. ``~/Music`` XDG_MUSIC_DIRz~/MusicrerSs&ruser_music_dirUnix.user_music_dirs#?I>>rcV^8dQhRR/#rr )r s"rrrsCC#Crc \RR4#)z?:return: desktop directory tied to the user, e.g. ``~/Desktop``XDG_DESKTOP_DIRz ~/DesktoprerSs&ruser_desktop_dirUnix.user_desktop_dirs##4kBBrcV^8dQhRR/#rr )r s"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) rr r!r"sysplatform startswithrrexistsr%r&s& ruser_runtime_dirUnix.user_runtime_dirszz~~/4zz||||&&'GHH'z2Dz((***68*5D#FH:.0066rcV^8dQhRR/#rr )r s"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)rr r!r"rrrr%r&s& rsite_runtime_dirUnix.site_runtime_dirsUzz~~/4zz||||&&'GHH!0066rcV^8dQhRR/#r r rr )r s"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:rSs&rsite_data_pathUnix.site_data_paths44T5G5GHHrcV^8dQhRR/#rr )r s"rrrsKK$Krc 8VPVP4#)zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)rrHrSs&rsite_config_pathUnix.site_config_paths44T5I5IJJrcV^8dQhRR/#rr )r s"rrrsJJJrc 8VPVP4#)zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)rrTrSs&rsite_cache_pathUnix.site_cache_paths44T5H5HIIrc V^8dQhRRRR/#)r directoryrr rr )r s"rrrs#$rc VP'd'VP\P4^,p\ V4#))r6r/rr.r)r'rs&&rr%Unix._first_item_as_path_if_multipaths, >>>! 3A6IIrcV^8dQhRR/#r r z Iterator[str]r )r s"rrrs**-*rc# V"VPxVPRjxL R#L5i)z4:yield: all user and site configuration directories.N)r?rDrSs&riter_config_dirsUnix.iter_config_dirss """)))) )')cV^8dQhRR/#rr )r s"rrrs(( (rc# V"VPxVPRjxL R#L5i)z+:yield: all user and site data directories.N)r(r2rSs&riter_data_dirsUnix.iter_data_dirss    ''''rr N)__name__ __module__ __qualname____firstlineno____doc__propertyr(r2r:r?rDrHrNrTrYr`rgrlrqrvr{rrrrrrrrr__static_attributes__r rrrrs 77VV  % %77VV  % %77??77GGFFEEAA??CC77&77*IIKKJJ * ((rrc$V^8dQhRRRRRR/#)r env_varrfallback_tilde_pathr r )r s"rrrs!33rc\V4pVfV\PPVR4P 4pV'g \P P V4pV#)Nr)_get_user_dirs_folderrr r!r"r#r$)rr media_dirs&& rrfrfsM%g.IJJNN7B/557 **+>?I rc V^8dQhRRRR/#)r keyrr z str | Noner )r s"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"replacerr#r$)ruser_dirs_config_pathparserstreamr#s& rrrs!!7!78;KK##%% " ' ' ) )V   8 9* Um #e}S!'',||GRWW%7%7%<== * )s #C'' C7 )r __future__rrr configparserrpathlibrtypingrrapirrrrrfr__all__r rrrsX " %% <<7 T(?T(n4  r