Ë ï·)†¤FÆ¥ãón—dZddlmZddlZddlmZmZddlmZddl m Z e rddl m Z m Z Gd„d e«Z y) z Base API.é)Ú annotationsN)ÚABCÚabstractmethod)ÚPath)Ú TYPE_CHECKING)ÚIteratorÚLiteralcóv—eZdZdZ d. d/d„Zd0d„Zd1d„Zeed2d„««Z eed2d„««Z eed2d„««Z eed2d „««Z eed2d „««Z eed2d „««Zeed2d „««Zeed2d „««Zeed2d„««Zeed2d„««Zeed2d„««Zeed2d„««Zeed2d„««Zeed2d„««Zeed2d„««Zeed2d„««Zed3d„«Zed3d„«Zed3d„«Zed3d„«Zed3d„«Zed3d„«Zed3d„«Zed3d„«Z ed3d„«Z!ed3d„«Z"ed3d „«Z#ed3d!„«Z$ed3d"„«Z%ed3d#„«Z&ed3d$„«Z'ed3d%„«Z(d4d&„Z)d4d'„Z*d4d(„Z+d4d)„Z,d5d*„Z-d5d+„Z.d5d,„Z/d5d-„Z0y)6ÚPlatformDirsABCz-Abstract base class for platform directories.Ncón—||_||_ ||_ ||_ ||_ ||_||_y)aX Create a new platform directory. :param appname: See `appname`. :param appauthor: See `appauthor`. :param version: See `version`. :param roaming: See `roaming`. :param multipath: See `multipath`. :param opinion: See `opinion`. :param ensure_exists: See `ensure_exists`. N)ÚappnameÚ appauthorÚversionÚroamingÚ multipathÚopinionÚ ensure_exists)Úselfr rrrrrrs ú5/usr/lib/python3.12/site-packages/platformdirs/api.pyÚ__init__zPlatformDirsABC.__init__sW€ð*ˆŒ Ø"ˆŒð ðˆŒ ð ðˆŒ ð ð #ˆŒð ðˆŒ Ø*ˆÔð ócó&—t|dd«}|jrB|j|j«|jr|j|j«t j j |dg|¢­Ž}|j|«|S)Nér)Úlistr ÚappendrÚosÚpathÚjoinÚ_optionally_create_directory)rÚbaseÚparamsrs rÚ_append_app_name_and_versionz,PlatformDirsABC._append_app_name_and_versionCsm€Ü�d˜1˜2�h“ˆØ �<Š<Ø �M‰M˜$Ÿ,™,Ô 'Ø�|Š|Ø— ‘ ˜dŸl™lÔ+Ü�w‰w�|‰|˜D ™GÐ- fÒ-ˆØ ×)Ñ)¨$Ô/؈ rcóV—|jrt|«jdd¬«yy)NT)ÚparentsÚexist_ok)rrÚmkdir©rrs rrz,PlatformDirsABC._optionally_create_directoryMs'€Ø × Ò Ü �‹J× Ñ  T°DÐ Õ 9ð rcó—y)z(:return: data directory tied to the userN©©rs rÚ user_data_dirzPlatformDirsABC.user_data_dirQó�rcó—y)z':return: data directory shared by usersNr)r*s rÚ site_data_dirzPlatformDirsABC.site_data_dirVr,rcó—y)z*:return: config directory tied to the userNr)r*s rÚuser_config_dirzPlatformDirsABC.user_config_dir[r,rcó—y)z-:return: config directory shared by the usersNr)r*s rÚsite_config_dirzPlatformDirsABC.site_config_dir`r,rcó—y)z):return: cache directory tied to the userNr)r*s rÚuser_cache_dirzPlatformDirsABC.user_cache_direr,rcó—y)z(:return: cache directory shared by usersNr)r*s rÚsite_cache_dirzPlatformDirsABC.site_cache_dirjr,rcó—y)z):return: state directory tied to the userNr)r*s rÚuser_state_dirzPlatformDirsABC.user_state_diror,rcó—y)z':return: log directory tied to the userNr)r*s rÚ user_log_dirzPlatformDirsABC.user_log_dirtr,rcó—y)z-:return: documents directory tied to the userNr)r*s rÚuser_documents_dirz"PlatformDirsABC.user_documents_diryr,rcó—y)z-:return: downloads directory tied to the userNr)r*s rÚuser_downloads_dirz"PlatformDirsABC.user_downloads_dir~r,rcó—y)z,:return: pictures directory tied to the userNr)r*s rÚuser_pictures_dirz!PlatformDirsABC.user_pictures_dirƒr,rcó—y)z*:return: videos directory tied to the userNr)r*s rÚuser_videos_dirzPlatformDirsABC.user_videos_dirˆr,rcó—y)z):return: music directory tied to the userNr)r*s rÚuser_music_dirzPlatformDirsABC.user_music_dir�r,rcó—y)z+:return: desktop directory tied to the userNr)r*s rÚuser_desktop_dirz PlatformDirsABC.user_desktop_dir’r,rcó—y)z+:return: runtime directory tied to the userNr)r*s rÚuser_runtime_dirz PlatformDirsABC.user_runtime_dir—r,rcó—y)z*:return: runtime directory shared by usersNr)r*s rÚsite_runtime_dirz PlatformDirsABC.site_runtime_dirœr,rcó,—t|j«S)z#:return: data path tied to the user)rr+r*s rÚuser_data_pathzPlatformDirsABC.user_data_path¡ó€ô�D×&Ñ&Ó'Ð'rcó,—t|j«S)z":return: data path shared by users)rr.r*s rÚsite_data_pathzPlatformDirsABC.site_data_path¦rMrcó,—t|j«S)z%:return: config path tied to the user)rr0r*s rÚuser_config_pathz PlatformDirsABC.user_config_path«ó€ô�D×(Ñ(Ó)Ð)rcó,—t|j«S)z(:return: config path shared by the users)rr2r*s rÚsite_config_pathz PlatformDirsABC.site_config_path°rRrcó,—t|j«S)z$:return: cache path tied to the user)rr4r*s rÚuser_cache_pathzPlatformDirsABC.user_cache_pathµó€ô�D×'Ñ'Ó(Ð(rcó,—t|j«S)z#:return: cache path shared by users)rr6r*s rÚsite_cache_pathzPlatformDirsABC.site_cache_pathºrWrcó,—t|j«S)z$:return: state path tied to the user)rr8r*s rÚuser_state_pathzPlatformDirsABC.user_state_path¿rWrcó,—t|j«S)z":return: log path tied to the user)rr:r*s rÚ user_log_pathzPlatformDirsABC.user_log_pathÄs€ô�D×%Ñ%Ó&Ð&rcó,—t|j«S)z(:return: documents path tied to the user)rr<r*s rÚuser_documents_pathz#PlatformDirsABC.user_documents_pathÉó€ô�D×+Ñ+Ó,Ð,rcó,—t|j«S)z(:return: downloads path tied to the user)rr>r*s rÚuser_downloads_pathz#PlatformDirsABC.user_downloads_pathÎr`rcó,—t|j«S)z':return: pictures path tied to the user)rr@r*s rÚuser_pictures_pathz"PlatformDirsABC.user_pictures_pathÓs€ô�D×*Ñ*Ó+Ð+rcó,—t|j«S)z%:return: videos path tied to the user)rrBr*s rÚuser_videos_pathz PlatformDirsABC.user_videos_pathØrRrcó,—t|j«S)z$:return: music path tied to the user)rrDr*s rÚuser_music_pathzPlatformDirsABC.user_music_pathÝrWrcó,—t|j«S)z&:return: desktop path tied to the user)rrFr*s rÚuser_desktop_pathz!PlatformDirsABC.user_desktop_pathâó€ô�D×)Ñ)Ó*Ð*rcó,—t|j«S)z&:return: runtime path tied to the user)rrHr*s rÚuser_runtime_pathz!PlatformDirsABC.user_runtime_pathçrkrcó,—t|j«S)z%:return: runtime path shared by users)rrJr*s rÚsite_runtime_pathz!PlatformDirsABC.site_runtime_pathìrkrc#óDK—|j–—|j–—y­w)z4:yield: all user and site configuration directories.N)r0r2r*s rÚiter_config_dirsz PlatformDirsABC.iter_config_dirsñsèø€à×"Ñ"Ò"Ø×"Ñ"Ó"ùó‚ c#óDK—|j–—|j–—y­w)z+:yield: all user and site data directories.N)r+r.r*s rÚiter_data_dirszPlatformDirsABC.iter_data_dirsösèø€à× Ñ Ò Ø× Ñ Ó ùrrc#óDK—|j–—|j–—y­w)z,:yield: all user and site cache directories.N)r4r6r*s rÚiter_cache_dirszPlatformDirsABC.iter_cache_dirsûsèø€à×!Ñ!Ò!Ø×!Ñ!Ó!ùrrc#óDK—|j–—|j–—y­w)z.:yield: all user and site runtime directories.N)rHrJr*s rÚiter_runtime_dirsz!PlatformDirsABC.iter_runtime_dirssèø€à×#Ñ#Ò#Ø×#Ñ#Ó#ùrrc#óPK—|j«D]}t|«–—Œy­w)z.:yield: all user and site configuration paths.N)rqrr's rÚiter_config_pathsz!PlatformDirsABC.iter_config_pathss#èø€à×)Ñ)Ö+ˆDÜ�t“*Ó ñ,ùó‚$&c#óPK—|j«D]}t|«–—Œy­w)z%:yield: all user and site data paths.N)rtrr's rÚiter_data_pathszPlatformDirsABC.iter_data_paths s#èø€à×'Ñ'Ö)ˆDÜ�t“*Ó ñ*ùr{c#óPK—|j«D]}t|«–—Œy­w)z&:yield: all user and site cache paths.N)rvrr's rÚiter_cache_pathsz PlatformDirsABC.iter_cache_pathss#èø€à×(Ñ(Ö*ˆDÜ�t“*Ó ñ+ùr{c#óPK—|j«D]}t|«–—Œy­w)z(:yield: all user and site runtime paths.N)rxrr's rÚiter_runtime_pathsz"PlatformDirsABC.iter_runtime_pathss#èø€à×*Ñ*Ö,ˆDÜ�t“*Ó ñ-ùr{)NNNFFTF)r ú str | Nonerzstr | None | Literal[False]rr‚rÚboolrrƒrrƒrrƒÚreturnÚNone)r Ústrr„r†)rr†r„r…)r„r†)r„r)r„z Iterator[str])r„zIterator[Path])1Ú__name__Ú __module__Ú __qualname__Ú__doc__rr"rÚpropertyrr+r.r0r2r4r6r8r:r<r>r@rBrDrFrHrJrLrOrQrTrVrYr[r]r_rbrdrfrhrjrmrorqrtrvrxrzr}rr�r)rrr r s¢„Ù7ð#Ø15Ø"ØØØØ#ð0 àð0 ð/ð0 ðð 0 ð ð 0 ð ð 0 ðð0 ðð0 ð ó0 ódó:ðØò7óóð7ðØò6óóð6ðØò9óóð9ðØò<óóð<ðØò8óóð8ðØò7óóð7ðØò8óóð8ðØò6óóð6ðØò<óóð<ðØò<óóð<ðØò;óóð;ðØò9óóð9ðØò8óóð8ðØò:óóð:ðØò:óóð:ðØò9óóð9ðò(óð(ðò(óð(ðò*óð*ðò*óð*ðò)óð)ðò)óð)ðò)óð)ðò'óð'ðò-óð-ðò-óð-ðò,óð,ðò*óð*ðò)óð)ðò+óð+ðò+óð+ðò+óð+ó#ó !ó "ó $ó ó ó ô rr )rŠÚ __future__rrÚabcrrÚpathlibrÚtypingrrr r r)rrÚr�s+ðÙå"ã ß#ÝÝ áß(ôI�cõIr