+
    %ig4                        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 ^ RI	Ht  ! R R	]4      tR# )
z	Base API.)annotationsN)ABCabstractmethod)Path)TYPE_CHECKING)Iterator)Literalc                     ] tR t^tRtRR R lltR R 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       t]	]
R R l4       4       t]	]
R R l4       4       t]	R R l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/ R0 l4       4       t]	]
R1 R2 l4       4       t]	]
R3 R4 l4       4       t]	]
R5 R6 l4       4       t ]	R7 R8 l4       t!]	]
R9 R: l4       4       t"]	]
R; R< l4       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4       t*]	RK RL l4       t+]	RM RN l4       t,]	RO RP l4       t-]	RQ RR l4       t.]	RS RT l4       t/]	RU RV l4       t0]	RW RX l4       t1]	RY RZ l4       t2]	R[ R\ l4       t3]	R] R^ l4       t4]	R_ R` l4       t5]	Ra Rb l4       t6]	Rc Rd l4       t7]	Re Rf l4       t8]	Rg Rh l4       t9Ri 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t@Rw Rx ltARy Rz ltBR{ R| ltCR} R~ ltDR R ltERtFR# )PlatformDirsABCaf  Abstract base class defining all platform directory properties, their :class:`~pathlib.Path` variants, and iterators.

Platform-specific subclasses (e.g. :class:`~platformdirs.windows.Windows`, :class:`~platformdirs.macos.MacOS`,
:class:`~platformdirs.unix.Unix`) implement the abstract properties to return the appropriate paths for each
operating system.

Nc               <    V ^8  d   QhRRRRRRRRRRR	RR
RRRRR/	# )   appnamez
str | None	appauthorzstr | Literal[False] | Noneversionroamingbool	multipathopinionensure_existsuse_site_for_rootreturnNone )formats   "N/var/www/html/photoedit/myenv/lib/python3.14/site-packages/platformdirs/api.py__annotate__PlatformDirsABC.__annotate__   so     M MM /M 	M
 M M M M  M 
M    c	                r    Wn         W n         W0n         W@n         WPn         W`n         Wpn         Wn        R# )aC  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`.
:param use_site_for_root: See `use_site_for_root`.

N)r   r   r   r   r   r   r   r   )	selfr   r   r   r   r   r   r   r   s	   &&&&&&&&&r   __init__PlatformDirsABC.__init__   s]    . "	 	 	 #	 	 +	
 "3	r   c                    V ^8  d   QhRRRR/# )r   basestrr   r   )r   s   "r   r   r   g   s      # # r   c                	R   \        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# ):   NN)listr   appendr   ospathjoin_optionally_create_directory)r   r#   paramsr*   s   &*  r   _append_app_name_and_version,PlatformDirsABC._append_app_name_and_versiong   so    d2h<<<MM$,,'|||dll+ww||DG-f-))$/r   c                    V ^8  d   QhRRRR/# )r   r*   r$   r   r   r   )r   s   "r   r   r   q   s     : : : :r   c                	f    V P                   '       d   \        V4      P                  R R R7       R# R# )T)parentsexist_okN)r   r   mkdirr   r*   s   &&r   r,   ,PlatformDirsABC._optionally_create_directoryq   s*    JTD9 r   c                    V ^8  d   QhRRRR/# )r   	directoryr$   r   r   r   )r   s   "r   r   r   u   s      # $ r   c                	    V P                   '       d'   VP                  \        P                  4      ^ ,          p\	        V4      # )    )r   	partitionr)   pathsepr   )r   r8   s   &&r    _first_item_as_path_if_multipath0PlatformDirsABC._first_item_as_path_if_multipathu   s.    >>>!++BJJ7:IIr   c                   V ^8  d   QhRR/# r   r   r$   r   )r   s   "r   r   r   }   s     8 8s 8r   c                    R# )z):returns: data directory tied to the userNr   r   s   &r   user_data_dirPlatformDirsABC.user_data_dir{       r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      s     7 7s 7r   c                    R# )z(:returns: data directory shared by usersNr   rB   s   &r   site_data_dirPlatformDirsABC.site_data_dir   rE   r   c                   V ^8  d   QhRR/# r   r   z	list[str]r   )r   s   "r   r   r      s     " " "r   c                	    \         hNNotImplementedErrorrB   s   &r   _site_data_dirsPlatformDirsABC._site_data_dirs       !!r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r           : : :r   c                    R# )z+:returns: config directory tied to the userNr   rB   s   &r   user_config_dirPlatformDirsABC.user_config_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      s     9 9 9r   c                    R# )z*:returns: config directory shared by usersNr   rB   s   &r   site_config_dirPlatformDirsABC.site_config_dir   rE   r   c                   V ^8  d   QhRR/# rK   r   )r   s   "r   r   r      s     " "9 "r   c                	    \         hrM   rN   rB   s   &r   _site_config_dirs!PlatformDirsABC._site_config_dirs   rR   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r           9 9 9r   c                    R# )z*:returns: cache directory tied to the userNr   rB   s   &r   user_cache_dirPlatformDirsABC.user_cache_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r           8 8 8r   c                    R# )z):returns: cache directory shared by usersNr   rB   s   &r   site_cache_dirPlatformDirsABC.site_cache_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      ra   r   c                    R# )z*:returns: state directory tied to the userNr   rB   s   &r   user_state_dirPlatformDirsABC.user_state_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      rf   r   c                    R# )z):returns: state directory shared by usersNr   rB   s   &r   site_state_dirPlatformDirsABC.site_state_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r           7 7c 7r   c                    R# )z(:returns: log directory tied to the userNr   rB   s   &r   user_log_dirPlatformDirsABC.user_log_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r           6 6c 6r   c                    R# )z':returns: log directory shared by usersNr   rB   s   &r   site_log_dirPlatformDirsABC.site_log_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r           = =C =r   c                    R# )z.:returns: documents directory tied to the userNr   rB   s   &r   user_documents_dir"PlatformDirsABC.user_documents_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      r}   r   c                    R# )z.:returns: downloads directory tied to the userNr   rB   s   &r   user_downloads_dir"PlatformDirsABC.user_downloads_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      s     < <3 <r   c                    R# )z-:returns: pictures directory tied to the userNr   rB   s   &r   user_pictures_dir!PlatformDirsABC.user_pictures_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      rT   r   c                    R# )z+:returns: videos directory tied to the userNr   rB   s   &r   user_videos_dirPlatformDirsABC.user_videos_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      ra   r   c                    R# )z*:returns: music directory tied to the userNr   rB   s   &r   user_music_dirPlatformDirsABC.user_music_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r           ; ;# ;r   c                    R# )z,:returns: desktop directory tied to the userNr   rB   s   &r   user_desktop_dir PlatformDirsABC.user_desktop_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      rs   r   c                    R# )z(:returns: bin directory tied to the userNr   rB   s   &r   user_bin_dirPlatformDirsABC.user_bin_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      rx   r   c                    R# )z':returns: bin directory shared by usersNr   rB   s   &r   site_bin_dirPlatformDirsABC.site_bin_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      s     @ @s @r   c                    R# )z1:returns: applications directory tied to the userNr   rB   s   &r   user_applications_dir%PlatformDirsABC.user_applications_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      s     ? ?s ?r   c                    R# )z0:returns: applications directory shared by usersNr   rB   s   &r   site_applications_dir%PlatformDirsABC.site_applications_dir   rE   r   c                   V ^8  d   QhRR/# rK   r   )r   s   "r   r   r      s     " " "r   c                	    \         hrM   rN   rB   s   &r   _site_applications_dirs'PlatformDirsABC._site_applications_dirs   rR   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      r   r   c                    R# )z,:returns: runtime directory tied to the userNr   rB   s   &r   user_runtime_dir PlatformDirsABC.user_runtime_dir   rE   r   c                   V ^8  d   QhRR/# r@   r   )r   s   "r   r   r      s     : :# :r   c                    R# )z+:returns: runtime directory shared by usersNr   rB   s   &r   site_runtime_dir PlatformDirsABC.site_runtime_dir   rE   r   c                   V ^8  d   QhRR/# r   r   r   r   )r   s   "r   r   r           ( ( (r   c                ,    \        V P                  4      # )z$:returns: data path tied to the user)r   rC   rB   s   &r   user_data_pathPlatformDirsABC.user_data_path        D&&''r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r      r   r   c                ,    \        V P                  4      # )z#:returns: data path shared by users)r   rH   rB   s   &r   site_data_pathPlatformDirsABC.site_data_path   r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r           * *$ *r   c                ,    \        V P                  4      # )z&:returns: config path tied to the user)r   rV   rB   s   &r   user_config_path PlatformDirsABC.user_config_path        D(())r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r     r   r   c                ,    \        V P                  4      # )z%:returns: config path shared by users)r   rZ   rB   s   &r   site_config_path PlatformDirsABC.site_config_path  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   
       ) ) )r   c                ,    \        V P                  4      # )z%:returns: cache path tied to the user)r   rc   rB   s   &r   user_cache_pathPlatformDirsABC.user_cache_path	       D''((r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r     r   r   c                ,    \        V P                  4      # )z$:returns: cache path shared by users)r   rh   rB   s   &r   site_cache_pathPlatformDirsABC.site_cache_path  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r     r   r   c                ,    \        V P                  4      # )z%:returns: state path tied to the user)r   rl   rB   s   &r   user_state_pathPlatformDirsABC.user_state_path  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r     r   r   c                ,    \        V P                  4      # )z$:returns: state path shared by users)r   rp   rB   s   &r   site_state_pathPlatformDirsABC.site_state_path  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r          ' 't 'r   c                ,    \        V P                  4      # )z#:returns: log path tied to the user)r   ru   rB   s   &r   user_log_pathPlatformDirsABC.user_log_path       D%%&&r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   #  r   r   c                ,    \        V P                  4      # )z":returns: log path shared by users)r   rz   rB   s   &r   site_log_pathPlatformDirsABC.site_log_path"  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   (       - -T -r   c                ,    \        V P                  4      # )z):returns: documents path tied to the user)r   r   rB   s   &r   user_documents_path#PlatformDirsABC.user_documents_path'       D++,,r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   -  r   r   c                ,    \        V P                  4      # )z):returns: downloads path tied to the user)r   r   rB   s   &r   user_downloads_path#PlatformDirsABC.user_downloads_path,  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   2  s     , ,D ,r   c                ,    \        V P                  4      # )z(:returns: pictures path tied to the user)r   r   rB   s   &r   user_pictures_path"PlatformDirsABC.user_pictures_path1  s     D**++r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   7  r   r   c                ,    \        V P                  4      # )z&:returns: videos path tied to the user)r   r   rB   s   &r   user_videos_path PlatformDirsABC.user_videos_path6  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   <  r   r   c                ,    \        V P                  4      # )z%:returns: music path tied to the user)r   r   rB   s   &r   user_music_pathPlatformDirsABC.user_music_path;  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   A       + +4 +r   c                ,    \        V P                  4      # )z':returns: desktop path tied to the user)r   r   rB   s   &r   user_desktop_path!PlatformDirsABC.user_desktop_path@       D))**r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   F  r   r   c                ,    \        V P                  4      # )z#:returns: bin path tied to the user)r   r   rB   s   &r   user_bin_pathPlatformDirsABC.user_bin_pathE  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   K  r   r   c                ,    \        V P                  4      # )z":returns: bin path shared by users)r   r   rB   s   &r   site_bin_pathPlatformDirsABC.site_bin_pathJ  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   P       0 0 0r   c                ,    \        V P                  4      # )z,:returns: applications path tied to the user)r   r   rB   s   &r   user_applications_path&PlatformDirsABC.user_applications_pathO       D..//r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   U  r  r   c                ,    \        V P                  4      # )z+:returns: applications path shared by users)r   r   rB   s   &r   site_applications_path&PlatformDirsABC.site_applications_pathT  r  r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   Z  r   r   c                ,    \        V P                  4      # )z':returns: runtime path tied to the user)r   r   rB   s   &r   user_runtime_path!PlatformDirsABC.user_runtime_pathY  r   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   _  r   r   c                ,    \        V P                  4      # )z&:returns: runtime path shared by users)r   r   rB   s   &r   site_runtime_path!PlatformDirsABC.site_runtime_path^  r   r   c                   V ^8  d   QhRR/# r   r   zIterator[str]r   )r   s   "r   r   r   c  s     # #- #r   c              #  F   "   V P                   x  V P                  x  R# 5i)z4:yield: all user and site configuration directories.N)rV   rZ   rB   s   &r   iter_config_dirs PlatformDirsABC.iter_config_dirsc  s     """"""   !c                   V ^8  d   QhRR/# r  r   )r   s   "r   r   r   h  s     ! ! !r   c              #  F   "   V P                   x  V P                  x  R# 5i)z+:yield: all user and site data directories.N)rC   rH   rB   s   &r   iter_data_dirsPlatformDirsABC.iter_data_dirsh  s           r  c                   V ^8  d   QhRR/# r  r   )r   s   "r   r   r   m       " " "r   c              #  F   "   V P                   x  V P                  x  R# 5i)z,:yield: all user and site cache directories.N)rc   rh   rB   s   &r   iter_cache_dirsPlatformDirsABC.iter_cache_dirsm       !!!!!!r  c                   V ^8  d   QhRR/# r  r   )r   s   "r   r   r   r  r$  r   c              #  F   "   V P                   x  V P                  x  R# 5i)z,:yield: all user and site state directories.N)rl   rp   rB   s   &r   iter_state_dirsPlatformDirsABC.iter_state_dirsr  r(  r  c                   V ^8  d   QhRR/# r  r   )r   s   "r   r   r   w  s        }  r   c              #  F   "   V P                   x  V P                  x  R# 5i)z*:yield: all user and site log directories.N)ru   rz   rB   s   &r   iter_log_dirsPlatformDirsABC.iter_log_dirsw  s     r  c                   V ^8  d   QhRR/# r  r   )r   s   "r   r   r   |  s     $ $= $r   c              #  F   "   V P                   x  V P                  x  R# 5i)z.:yield: all user and site runtime directories.N)r   r   rB   s   &r   iter_runtime_dirs!PlatformDirsABC.iter_runtime_dirs|  s     ######r  c                   V ^8  d   QhRR/# r   r   zIterator[Path]r   )r   s   "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)r  r   r5   s   & r   iter_config_paths!PlatformDirsABC.iter_config_paths  s"     ))+Dt* ,   ')c                   V ^8  d   QhRR/# r6  r   )r   s   "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 data paths.N)r!  r   r5   s   & r   iter_data_pathsPlatformDirsABC.iter_data_paths  s"     '')Dt* *r:  c                   V ^8  d   QhRR/# r6  r   )r   s   "r   r   r           . r   c              #  V   "   V P                  4        F  p\        V4      x  K  	  R# 5i)z&:yield: all user and site cache paths.N)r&  r   r5   s   & r   iter_cache_paths PlatformDirsABC.iter_cache_paths  "     ((*Dt* +r:  c                   V ^8  d   QhRR/# r6  r   )r   s   "r   r   r     r@  r   c              #  V   "   V P                  4        F  p\        V4      x  K  	  R# 5i)z&:yield: all user and site state paths.N)r+  r   r5   s   & r   iter_state_paths PlatformDirsABC.iter_state_paths  rD  r:  c                   V ^8  d   QhRR/# r6  r   )r   s   "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 log paths.N)r/  r   r5   s   & r   iter_log_pathsPlatformDirsABC.iter_log_paths  s"     &&(Dt* )r:  c                   V ^8  d   QhRR/# r6  r   )r   s   "r   r   r     s      N r   c              #  V   "   V P                  4        F  p\        V4      x  K  	  R# 5i)z(:yield: all user and site runtime paths.N)r3  r   r5   s   & r   iter_runtime_paths"PlatformDirsABC.iter_runtime_paths  s"     **,Dt* -r:  )r   r   r   r   r   r   r   r   )NNNFFTFF)G__name__
__module____qualname____firstlineno____doc__r    r.   r,   r=   propertyr   rC   rH   rP   rV   rZ   r^   rc   rh   rl   rp   ru   rz   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r  r  r
  r  r  r  r  r!  r&  r+  r/  r3  r8  r=  rB  rG  rK  rO  __static_attributes__r   r   r   r
   r
      s   M^: 8  8 7  7 " " :  : 9  9 " " 9  9 8  8 9  9 8  8 7  7 6  6 =  = =  = <  < :  : 9  9 ;  ; 7  7 6  6 @  @ ?  ? " " ;  ; :  : ( ( ( ( * * * * ) ) ) ) ) ) ) ) ' ' ' ' - - - - , , * * ) ) + + ' ' ' ' 0 0 0 0 + + + +#
!
"
"
 
$





 r   r
   )rU  
__future__r   r)   abcr   r   pathlibr   typingr   collections.abcr   r   r
   r   r   r   <module>r]     s.     " 	 #   (Nc Nr   