+
     h$#  c                  s|    R t ^ RIHt ^ RIt^ RIHtHt ^ RIHt ^ RI	H
t
 ]
'       d	   ^ RI	HtHt  ! R R]4      tR# )	z	Base API.)annotationsN)ABCabstractmethod)Path)TYPE_CHECKING)IteratorLiteralc                  s   ] tR t^tRtRZR R lltR R ltR R lt]]	R	 R
 l4       4       t
]]	R R l4       4       t]]	R R l4       4       t]]	R R l4       4       t]]	R R l4       4       t]]	R R l4       4       t]]	R R l4       4       t]]	R R l4       4       t]]	R R l4       4       t]]	R R l4       4       t]]	R R l4       4       t]]	R R  l4       4       t]]	R! R" l4       4       t]]	R# R$ l4       4       t]]	R% R& l4       4       t]]	R' R( l4       4       t]R) R* l4       t]R+ R, l4       t]R- R. l4       t]R/ R0 l4       t]R1 R2 l4       t]R3 R4 l4       t]R5 R6 l4       t ]R7 R8 l4       t!]R9 R: l4       t"]R; R< l4       t#]R= R> l4       t$]R? R@ l4       t%]RA RB l4       t&]RC RD l4       t']RE RF l4       t(]RG RH l4       t)RI RJ lt*RK RL lt+RM RN lt,RO RP lt-RQ RR lt.RS RT lt/RU RV lt0RW RX lt1RYt2R# )[PlatformDirsABCz-Abstract base class for platform directories.Nc               s8    V ^8  d   QhRRRRRRRRRRR	RR
RRR/# )   appnamez
str | None	appauthorzstr | None | Literal[False]versionroamingZbool	multipathopinionensure_existsreturnNone Zformat   "H/usr/lib/python3.14/site-packages/setuptools/_vendor/platformdirs/api.py__annotate__PlatformDirsABC.__annotate__   sZ     = == /= 	=
 = = = = 
=    c                sb    Wn         W n         W0n         W@n         WPn         W`n        Wpn        R# )a  
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)r	   r
   r   r   r   r   r   )selfr	   r
   r   r   r   r   r   s   &&&&&&&&r   __init__ZPlatformDirsABC.__init__   sI    , "	 	 	 #	 *	r   c               s     V ^8  d   QhRRRR/# )r   basestrr   r   r   r   r   r   r   P   s      # # r   c                	sR   \        VR ,          4      pV P                  '       dI   VP                  V P                  4       V P                  '       d   VP                  V P                  4       \        P
                  P                  ! V^ ,          .VO5!  pV P                  V4       V# ):i   NN)Zlistr	   Zappendr   ospathZjoin_optionally_create_directory)r   r   Zparamsr   s   &*  r   _append_app_name_and_versionZ,PlatformDirsABC._append_app_name_and_versionP   so    d2h<<<MM$,,'|||dll+ww||DG-f-))$/r   c               s     V ^8  d   QhRRRR/# )r   r   r   r   r   r   r   r   r   r   r   Z   s     : : : :r   c                	sf    V P                   '       d   \        V4      P                  R R R7       R# R# )T)ZparentsZexist_okN)r   r   Zmkdirr   r   s   &&r   r   Z,PlatformDirsABC._optionally_create_directoryZ   s*    JTD9 r   c                   V ^8  d   QhRR/# r   r   r   r   r   r   r   r   r   `   s     7 7s 7r   c                    R# )z(:return: data directory tied to the userNr   r      &r   user_data_dirZPlatformDirsABC.user_data_dir^       r   c               r"   r#   r   r   r   r   r   r   e   s     6 6s 6r   c                r$   )z':return: data directory shared by usersNr   r%   r&   r   site_data_dirZPlatformDirsABC.site_data_dirc   r(   r   c               r"   r#   r   r   r   r   r   r   j        9 9 9r   c                r$   )z*:return: config directory tied to the userNr   r%   r&   r   user_config_dirZPlatformDirsABC.user_config_dirh   r(   r   c               r"   r#   r   r   r   r   r   r   o   s     < < <r   c                r$   )z-:return: config directory shared by the usersNr   r%   r&   r   site_config_dirZPlatformDirsABC.site_config_dirm   r(   r   c               r"   r#   r   r   r   r   r   r   t        8 8 8r   c                r$   )z):return: cache directory tied to the userNr   r%   r&   r   user_cache_dirZPlatformDirsABC.user_cache_dirr   r(   r   c               r"   r#   r   r   r   r   r   r   y   s     7 7 7r   c                r$   )z(:return: cache directory shared by usersNr   r%   r&   r   site_cache_dirZPlatformDirsABC.site_cache_dirw   r(   r   c               r"   r#   r   r   r   r   r   r   ~   r-   r   c                r$   )z):return: state directory tied to the userNr   r%   r&   r   user_state_dirZPlatformDirsABC.user_state_dir|   r(   r   c               r"   r#   r   r   r   r   r   r      s     6 6c 6r   c                r$   )z':return: log directory tied to the userNr   r%   r&   r   user_log_dirZPlatformDirsABC.user_log_dir   r(   r   c               r"   r#   r   r   r   r   r   r           < <C <r   c                r$   )z-:return: documents directory tied to the userNr   r%   r&   r   user_documents_dirZ"PlatformDirsABC.user_documents_dir   r(   r   c               r"   r#   r   r   r   r   r   r      r2   r   c                r$   )z-:return: downloads directory tied to the userNr   r%   r&   r   user_downloads_dirZ"PlatformDirsABC.user_downloads_dir   r(   r   c               r"   r#   r   r   r   r   r   r      s     ; ;3 ;r   c                r$   )z,:return: pictures directory tied to the userNr   r%   r&   r   user_pictures_dirZ!PlatformDirsABC.user_pictures_dir   r(   r   c               r"   r#   r   r   r   r   r   r      r*   r   c                r$   )z*:return: videos directory tied to the userNr   r%   r&   r   user_videos_dirZPlatformDirsABC.user_videos_dir   r(   r   c               r"   r#   r   r   r   r   r   r      r-   r   c                r$   )z):return: music directory tied to the userNr   r%   r&   r   user_music_dirZPlatformDirsABC.user_music_dir   r(   r   c               r"   r#   r   r   r   r   r   r           : :# :r   c                r$   )z+:return: desktop directory tied to the userNr   r%   r&   r   user_desktop_dirZ PlatformDirsABC.user_desktop_dir   r(   r   c               r"   r#   r   r   r   r   r   r      r8   r   c                r$   )z+:return: runtime directory tied to the userNr   r%   r&   r   user_runtime_dirZ PlatformDirsABC.user_runtime_dir   r(   r   c               r"   r#   r   r   r   r   r   r      s     9 9# 9r   c                r$   )z*:return: runtime directory shared by usersNr   r%   r&   r   site_runtime_dirZ PlatformDirsABC.site_runtime_dir   r(   r   c               r"   r   r   r   r   r   r   r   r   r           ( ( (r   c                ,    \        V P                  4      # )z#:return: data path tied to the user)r   r'   r%   r&   r   user_data_pathZPlatformDirsABC.user_data_path        D&&''r   c               r"   r<   r   r   r   r   r   r      r=   r   c                r>   )z":return: data path shared by users)r   r)   r%   r&   r   site_data_pathZPlatformDirsABC.site_data_path   r@   r   c               r"   r<   r   r   r   r   r   r           * *$ *r   c                r>   )z%:return: config path tied to the user)r   r+   r%   r&   r   user_config_pathZ PlatformDirsABC.user_config_path        D(())r   c               r"   r<   r   r   r   r   r   r      rB   r   c                r>   )z(:return: config path shared by the users)r   r,   r%   r&   r   site_config_pathZ PlatformDirsABC.site_config_path   rD   r   c               r"   r<   r   r   r   r   r   r           ) ) )r   c                r>   )z$:return: cache path tied to the user)r   r.   r%   r&   r   user_cache_pathZPlatformDirsABC.user_cache_path        D''((r   c               r"   r<   r   r   r   r   r   r      rF   r   c                r>   )z#:return: cache path shared by users)r   r/   r%   r&   r   site_cache_pathZPlatformDirsABC.site_cache_path   rH   r   c               r"   r<   r   r   r   r   r   r      rF   r   c                r>   )z$:return: state path tied to the user)r   r0   r%   r&   r   user_state_pathZPlatformDirsABC.user_state_path   rH   r   c               r"   r<   r   r   r   r   r   r      s     ' 't 'r   c                r>   )z":return: log path tied to the user)r   r1   r%   r&   r   user_log_pathZPlatformDirsABC.user_log_path   s     D%%&&r   c               r"   r<   r   r   r   r   r   r           - -T -r   c                r>   )z*:return: documents a path tied to the user)r   r3   r%   r&   r   user_documents_pathZ#PlatformDirsABC.user_documents_path        D++,,r   c               r"   r<   r   r   r   r   r   r      rL   r   c                r>   )z(:return: downloads path tied to the user)r   r4   r%   r&   r   user_downloads_pathZ#PlatformDirsABC.user_downloads_path   rN   r   c               r"   r<   r   r   r   r   r   r      s     , ,D ,r   c                r>   )z':return: pictures path tied to the user)r   r5   r%   r&   r   user_pictures_pathZ"PlatformDirsABC.user_pictures_path   s     D**++r   c               r"   r<   r   r   r   r   r   r      rB   r   c                r>   )z%:return: videos path tied to the user)r   r6   r%   r&   r   user_videos_pathZ PlatformDirsABC.user_videos_path   rD   r   c               r"   r<   r   r   r   r   r   r      rF   r   c                r>   )z$:return: music path tied to the user)r   r7   r%   r&   r   user_music_pathZPlatformDirsABC.user_music_path   rH   r   c               r"   r<   r   r   r   r   r   r           + +4 +r   c                r>   )z&:return: desktop path tied to the user)r   r9   r%   r&   r   user_desktop_pathZ!PlatformDirsABC.user_desktop_path        D))**r   c               r"   r<   r   r   r   r   r   r      rS   r   c                r>   )z&:return: runtime path tied to the user)r   r:   r%   r&   r   user_runtime_pathZ!PlatformDirsABC.user_runtime_path   rU   r   c               r"   r<   r   r   r   r   r   r      rS   r   c                r>   )z%:return: runtime path shared by users)r   r;   r%   r&   r   site_runtime_pathZ!PlatformDirsABC.site_runtime_path   rU   r   c               r"   r   r   zIterator[str]r   r   r   r   r   r      s     # #- #r   c              #  F   "   V P                   x  V P                  x  R# 5i)z4:yield: all user and site configuration directories.N)r+   r,   r%   r&   r   iter_config_dirsZ PlatformDirsABC.iter_config_dirs   s     """"""   !c               r"   rX   r   r   r   r   r   r     s     ! ! !r   c              #  rY   )z+:yield: all user and site data directories.N)r'   r)   r%   r&   r   iter_data_dirsZPlatformDirsABC.iter_data_dirs  s           r[   c               r"   rX   r   r   r   r   r   r     s     " " "r   c              #  rY   )z,:yield: all user and site cache directories.N)r.   r/   r%   r&   r   iter_cache_dirsZPlatformDirsABC.iter_cache_dirs  s     !!!!!!r[   c               r"   rX   r   r   r   r   r   r     s     $ $= $r   c              #  rY   )z.:yield: all user and site runtime directories.N)r:   r;   r%   r&   r   iter_runtime_dirsZ!PlatformDirsABC.iter_runtime_dirs  s     ######r[   c               r"   r   r   zIterator[Path]r   r   r   r   r   r     s      > r   c              #  V   "   V P                  4        F  p\        V4      x  K  	  R# 5i)z.:yield: all user and site configuration paths.N)rZ   r   r!      & r   iter_config_pathsZ!PlatformDirsABC.iter_config_paths  s"     ))+Dt* ,   ')c               r"   r_   r   r   r   r   r   r     s       r   c              #  r`   )z%:yield: all user and site data paths.N)r\   r   r!   ra   r   iter_data_pathsZPlatformDirsABC.iter_data_paths  s"     '')Dt* *rc   c               r"   r_   r   r   r   r   r   r     s      . r   c              #  r`   )z&:yield: all user and site cache paths.N)r]   r   r!   ra   r   iter_cache_pathsZ PlatformDirsABC.iter_cache_paths  s"     ((*Dt* +rc   c               r"   r_   r   r   r   r   r   r   !  s      N r   c              #  r`   )z(:yield: all user and site runtime paths.N)r^   r   r!   ra   r   iter_runtime_pathsZ"PlatformDirsABC.iter_runtime_paths!  s"     **,Dt* -rc   )r
   r	   r   r   r   r   r   )NNNFFTF)3Z__name__Z
__module__Z__qualname__Z__firstlineno____doc__r   r    r   Zpropertyr   r'   r)   r+   r,   r.   r/   r0   r1   r3   r4   r5   r6   r7   r9   r:   r;   r?   rA   rC   rE   rG   rI   rJ   rK   rM   rO   rP   rQ   rR   rT   rV   rW   rZ   r\   r]   r^   rb   rd   re   rf   Z__static_attributes__r   r   r   r   r      sB   7=~: 7  7 6  6 9  9 <  < 8  8 7  7 8  8 6  6 <  < <  < ;  ; 9  9 8  8 :  : :  : 9  9 ( ( ( ( * * * * ) ) ) ) ) ) ' ' - - - - , , * * ) ) + + + + + +#
!
"
$



 r   r   )rg   Z
__future__r    r   Zabcr   r   Zpathlibr   Ztypingr   r   r   r   r   r   r   <module>rh      s+     " 	 #   (Vc Vr   