ó
    Ñ]jg4  ã                  ó€   • S r SSKJr  SSKrSSKJrJr  SSKJr  SSK	J
r
  \
(       a  SSKJr  SSK	Jr   " S	 S
\5      rg)z	Base API.é    )ÚannotationsN)ÚABCÚabstractmethod)ÚPath)ÚTYPE_CHECKING)ÚIterator)ÚLiteralc                  óv  • \ rS rSrSr        SD                 SES jjrSFS jrSGS jrSHS jr\	\
SIS j5       5       r\	\
SIS	 j5       5       r\	SJS
 j5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	SJS j5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r\	\
SIS j5       5       r \	SJS j5       r!\	\
SIS j5       5       r"\	\
SIS  j5       5       r#\	SKS! j5       r$\	SKS" j5       r%\	SKS# j5       r&\	SKS$ j5       r'\	SKS% j5       r(\	SKS& j5       r)\	SKS' j5       r*\	SKS( j5       r+\	SKS) j5       r,\	SKS* j5       r-\	SKS+ j5       r.\	SKS, j5       r/\	SKS- j5       r0\	SKS. j5       r1\	SKS/ j5       r2\	SKS0 j5       r3\	SKS1 j5       r4\	SKS2 j5       r5\	SKS3 j5       r6\	SKS4 j5       r7\	SKS5 j5       r8\	SKS6 j5       r9SLS7 jr:SLS8 jr;SLS9 jr<SLS: jr=SLS; jr>SLS< jr?SMS= jr@SMS> jrASMS? jrBSMS@ jrCSMSA jrDSMSB jrESCrFg)NÚPlatformDirsABCé   af  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	                óp   • Xl         X l         X0l         X@l         XPl         X`l         Xpl         X€l        g)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)ÚappnameÚ	appauthorÚversionÚroamingÚ	multipathÚopinionÚensure_existsÚuse_site_for_root)	Úselfr   r   r   r   r   r   r   r   s	            ÚM/home/mande/repo/quber/.venv/lib/python3.13/site-packages/platformdirs/api.pyÚ__init__ÚPlatformDirsABC.__init__   s]   € ð. ŒØ"Œð	ð Œð	ð Œð	ð #Œð	ð Œð	ð +Ôð	ð
 "3Ôð	ó    c                ó<  • [        USS  5      nU R                  (       aG  UR                  U R                  5        U R                  (       a  UR                  U R                  5        [        R
                  R                  " US   /UQ76 nU R                  U5        U$ )Né   r   )Úlistr   Úappendr   ÚosÚpathÚjoinÚ_optionally_create_directory)r   ÚbaseÚparamsr    s       r   Ú_append_app_name_and_versionÚ,PlatformDirsABC._append_app_name_and_versiong   sm   € Ü�d˜1˜2�h“ˆØ�<�<Ø�M‰M˜$Ÿ,™,Ô'Ø�|�|Ø—‘˜dŸl™lÔ+Ü�w‰w�|Š|˜D ™GÐ- fÒ-ˆØ×)Ñ)¨$Ô/Øˆr   c                óZ   • U R                   (       a  [        U5      R                  SSS9  g g )NT)ÚparentsÚexist_ok)r   r   Úmkdir©r   r    s     r   r"   Ú,PlatformDirsABC._optionally_create_directoryq   s'   € Ø××Ü�‹J×Ñ T°DÐÒ9ð r   c                ó~   • U R                   (       a"  UR                  [        R                  5      S   n[	        U5      $ )Nr   )r   Ú	partitionr   Úpathsepr   )r   Ú	directorys     r   Ú _first_item_as_path_if_multipathÚ0PlatformDirsABC._first_item_as_path_if_multipathu   s,   € Ø�>�>à!×+Ñ+¬B¯J©JÓ7¸Ñ:ˆIÜ�I‹Ðr   c                ó   • g)z):returns: data directory tied to the userN© ©r   s    r   Úuser_data_dirÚPlatformDirsABC.user_data_dir{   ó   � r   c                ó   • g)z(:returns: data directory shared by usersNr4   r5   s    r   Úsite_data_dirÚPlatformDirsABC.site_data_dir€   r8   r   c                ó   • [         e©N©ÚNotImplementedErrorr5   s    r   Ú_site_data_dirsÚPlatformDirsABC._site_data_dirs…   ó   € ä!Ð!r   c                ó   • g)z+:returns: config directory tied to the userNr4   r5   s    r   Úuser_config_dirÚPlatformDirsABC.user_config_dir‰   r8   r   c                ó   • g)z*:returns: config directory shared by usersNr4   r5   s    r   Úsite_config_dirÚPlatformDirsABC.site_config_dirŽ   r8   r   c                ó   • [         er=   r>   r5   s    r   Ú_site_config_dirsÚ!PlatformDirsABC._site_config_dirs“   rB   r   c                ó   • g)z*:returns: cache directory tied to the userNr4   r5   s    r   Úuser_cache_dirÚPlatformDirsABC.user_cache_dir—   r8   r   c                ó   • g)z):returns: cache directory shared by usersNr4   r5   s    r   Úsite_cache_dirÚPlatformDirsABC.site_cache_dirœ   r8   r   c                ó   • g)z*:returns: state directory tied to the userNr4   r5   s    r   Úuser_state_dirÚPlatformDirsABC.user_state_dir¡   r8   r   c                ó   • g)z):returns: state directory shared by usersNr4   r5   s    r   Úsite_state_dirÚPlatformDirsABC.site_state_dir¦   r8   r   c                ó   • g)z(:returns: log directory tied to the userNr4   r5   s    r   Úuser_log_dirÚPlatformDirsABC.user_log_dir«   r8   r   c                ó   • g)z':returns: log directory shared by usersNr4   r5   s    r   Úsite_log_dirÚPlatformDirsABC.site_log_dir°   r8   r   c                ó   • g)z.:returns: documents directory tied to the userNr4   r5   s    r   Úuser_documents_dirÚ"PlatformDirsABC.user_documents_dirµ   r8   r   c                ó   • g)z.:returns: downloads directory tied to the userNr4   r5   s    r   Úuser_downloads_dirÚ"PlatformDirsABC.user_downloads_dirº   r8   r   c                ó   • g)z-:returns: pictures directory tied to the userNr4   r5   s    r   Úuser_pictures_dirÚ!PlatformDirsABC.user_pictures_dir¿   r8   r   c                ó   • g)z+:returns: videos directory tied to the userNr4   r5   s    r   Úuser_videos_dirÚPlatformDirsABC.user_videos_dirÄ   r8   r   c                ó   • g)z*:returns: music directory tied to the userNr4   r5   s    r   Úuser_music_dirÚPlatformDirsABC.user_music_dirÉ   r8   r   c                ó   • g)z,:returns: desktop directory tied to the userNr4   r5   s    r   Úuser_desktop_dirÚ PlatformDirsABC.user_desktop_dirÎ   r8   r   c                ó   • g)z(:returns: bin directory tied to the userNr4   r5   s    r   Úuser_bin_dirÚPlatformDirsABC.user_bin_dirÓ   r8   r   c                ó   • g)z':returns: bin directory shared by usersNr4   r5   s    r   Úsite_bin_dirÚPlatformDirsABC.site_bin_dirØ   r8   r   c                ó   • g)z1:returns: applications directory tied to the userNr4   r5   s    r   Úuser_applications_dirÚ%PlatformDirsABC.user_applications_dirÝ   r8   r   c                ó   • g)z0:returns: applications directory shared by usersNr4   r5   s    r   Úsite_applications_dirÚ%PlatformDirsABC.site_applications_dirâ   r8   r   c                ó   • [         er=   r>   r5   s    r   Ú_site_applications_dirsÚ'PlatformDirsABC._site_applications_dirsç   rB   r   c                ó   • g)z,:returns: runtime directory tied to the userNr4   r5   s    r   Úuser_runtime_dirÚ PlatformDirsABC.user_runtime_dirë   r8   r   c                ó   • g)z+:returns: runtime directory shared by usersNr4   r5   s    r   Úsite_runtime_dirÚ PlatformDirsABC.site_runtime_dirð   r8   r   c                ó,   • [        U R                  5      $ )z$:returns: data path tied to the user)r   r6   r5   s    r   Úuser_data_pathÚPlatformDirsABC.user_data_pathõ   ó   € ô �D×&Ñ&Ó'Ð'r   c                ó,   • [        U R                  5      $ )z#:returns: data path shared by users)r   r:   r5   s    r   Úsite_data_pathÚPlatformDirsABC.site_data_pathú   rˆ   r   c                ó,   • [        U R                  5      $ )z&:returns: config path tied to the user)r   rD   r5   s    r   Úuser_config_pathÚ PlatformDirsABC.user_config_pathÿ   ó   € ô �D×(Ñ(Ó)Ð)r   c                ó,   • [        U R                  5      $ )z%:returns: config path shared by users)r   rG   r5   s    r   Úsite_config_pathÚ PlatformDirsABC.site_config_path  r�   r   c                ó,   • [        U R                  5      $ )z%:returns: cache path tied to the user)r   rM   r5   s    r   Úuser_cache_pathÚPlatformDirsABC.user_cache_path	  ó   € ô �D×'Ñ'Ó(Ð(r   c                ó,   • [        U R                  5      $ )z$:returns: cache path shared by users)r   rP   r5   s    r   Úsite_cache_pathÚPlatformDirsABC.site_cache_path  r–   r   c                ó,   • [        U R                  5      $ )z%:returns: state path tied to the user)r   rS   r5   s    r   Úuser_state_pathÚPlatformDirsABC.user_state_path  r–   r   c                ó,   • [        U R                  5      $ )z$:returns: state path shared by users)r   rV   r5   s    r   Úsite_state_pathÚPlatformDirsABC.site_state_path  r–   r   c                ó,   • [        U R                  5      $ )z#:returns: log path tied to the user)r   rY   r5   s    r   Úuser_log_pathÚPlatformDirsABC.user_log_path  ó   € ô �D×%Ñ%Ó&Ð&r   c                ó,   • [        U R                  5      $ )z":returns: log path shared by users)r   r\   r5   s    r   Úsite_log_pathÚPlatformDirsABC.site_log_path"  r£   r   c                ó,   • [        U R                  5      $ )z):returns: documents path tied to the user)r   r_   r5   s    r   Úuser_documents_pathÚ#PlatformDirsABC.user_documents_path'  ó   € ô �D×+Ñ+Ó,Ð,r   c                ó,   • [        U R                  5      $ )z):returns: downloads path tied to the user)r   rb   r5   s    r   Úuser_downloads_pathÚ#PlatformDirsABC.user_downloads_path,  rª   r   c                ó,   • [        U R                  5      $ )z(:returns: pictures path tied to the user)r   re   r5   s    r   Úuser_pictures_pathÚ"PlatformDirsABC.user_pictures_path1  s   € ô �D×*Ñ*Ó+Ð+r   c                ó,   • [        U R                  5      $ )z&:returns: videos path tied to the user)r   rh   r5   s    r   Úuser_videos_pathÚ PlatformDirsABC.user_videos_path6  r�   r   c                ó,   • [        U R                  5      $ )z%:returns: music path tied to the user)r   rk   r5   s    r   Úuser_music_pathÚPlatformDirsABC.user_music_path;  r–   r   c                ó,   • [        U R                  5      $ )z':returns: desktop path tied to the user)r   rn   r5   s    r   Úuser_desktop_pathÚ!PlatformDirsABC.user_desktop_path@  ó   € ô �D×)Ñ)Ó*Ð*r   c                ó,   • [        U R                  5      $ )z#:returns: bin path tied to the user)r   rq   r5   s    r   Úuser_bin_pathÚPlatformDirsABC.user_bin_pathE  r£   r   c                ó,   • [        U R                  5      $ )z":returns: bin path shared by users)r   rt   r5   s    r   Úsite_bin_pathÚPlatformDirsABC.site_bin_pathJ  r£   r   c                ó,   • [        U R                  5      $ )z,:returns: applications path tied to the user)r   rw   r5   s    r   Úuser_applications_pathÚ&PlatformDirsABC.user_applications_pathO  ó   € ô �D×.Ñ.Ó/Ð/r   c                ó,   • [        U R                  5      $ )z+:returns: applications path shared by users)r   rz   r5   s    r   Úsite_applications_pathÚ&PlatformDirsABC.site_applications_pathT  rÄ   r   c                ó,   • [        U R                  5      $ )z':returns: runtime path tied to the user)r   r€   r5   s    r   Úuser_runtime_pathÚ!PlatformDirsABC.user_runtime_pathY  rº   r   c                ó,   • [        U R                  5      $ )z&:returns: runtime path shared by users)r   rƒ   r5   s    r   Úsite_runtime_pathÚ!PlatformDirsABC.site_runtime_path^  rº   r   c              #  óD   #   • U R                   v •  U R                  v •  g7f)z4:yield: all user and site configuration directories.N)rD   rG   r5   s    r   Úiter_config_dirsÚ PlatformDirsABC.iter_config_dirsc  s   é € à×"Ñ"Ò"Ø×"Ñ"Ó"ùó   ‚ c              #  óD   #   • U R                   v •  U R                  v •  g7f)z+:yield: all user and site data directories.N)r6   r:   r5   s    r   Úiter_data_dirsÚPlatformDirsABC.iter_data_dirsh  s   é € à× Ñ Ò Ø× Ñ Ó ùrÑ   c              #  óD   #   • U R                   v •  U R                  v •  g7f)z,:yield: all user and site cache directories.N)rM   rP   r5   s    r   Úiter_cache_dirsÚPlatformDirsABC.iter_cache_dirsm  ó   é € à×!Ñ!Ò!Ø×!Ñ!Ó!ùrÑ   c              #  óD   #   • U R                   v •  U R                  v •  g7f)z,:yield: all user and site state directories.N)rS   rV   r5   s    r   Úiter_state_dirsÚPlatformDirsABC.iter_state_dirsr  rØ   rÑ   c              #  óD   #   • U R                   v •  U R                  v •  g7f)z*:yield: all user and site log directories.N)rY   r\   r5   s    r   Úiter_log_dirsÚPlatformDirsABC.iter_log_dirsw  s   é € à×ÑÒØ×ÑÓùrÑ   c              #  óD   #   • U R                   v •  U R                  v •  g7f)z.:yield: all user and site runtime directories.N)r€   rƒ   r5   s    r   Úiter_runtime_dirsÚ!PlatformDirsABC.iter_runtime_dirs|  s   é € à×#Ñ#Ò#Ø×#Ñ#Ó#ùrÑ   c              #  óT   #   • U R                  5        H  n[        U5      v •  M     g7f)z.:yield: all user and site configuration paths.N)rÏ   r   r+   s     r   Úiter_config_pathsÚ!PlatformDirsABC.iter_config_paths�  s"   é € à×)Ñ)Ö+ˆDÜ�t“*Ôò ,ùó   ‚&(c              #  óT   #   • U R                  5        H  n[        U5      v •  M     g7f)z%:yield: all user and site data paths.N)rÓ   r   r+   s     r   Úiter_data_pathsÚPlatformDirsABC.iter_data_paths†  s"   é € à×'Ñ'Ö)ˆDÜ�t“*Ôò *ùrå   c              #  óT   #   • U R                  5        H  n[        U5      v •  M     g7f)z&:yield: all user and site cache paths.N)rÖ   r   r+   s     r   Úiter_cache_pathsÚ PlatformDirsABC.iter_cache_paths‹  ó"   é € à×(Ñ(Ö*ˆDÜ�t“*Ôò +ùrå   c              #  óT   #   • U R                  5        H  n[        U5      v •  M     g7f)z&:yield: all user and site state paths.N)rÚ   r   r+   s     r   Úiter_state_pathsÚ PlatformDirsABC.iter_state_paths�  rì   rå   c              #  óT   #   • U R                  5        H  n[        U5      v •  M     g7f)z$:yield: all user and site log paths.N)rÝ   r   r+   s     r   Úiter_log_pathsÚPlatformDirsABC.iter_log_paths•  s"   é € à×&Ñ&Ö(ˆDÜ�t“*Ôò )ùrå   c              #  óT   #   • U R                  5        H  n[        U5      v •  M     g7f)z(:yield: all user and site runtime paths.N)rà   r   r+   s     r   Úiter_runtime_pathsÚ"PlatformDirsABC.iter_runtime_pathsš  s"   é € à×*Ñ*Ö,ˆDÜ�t“*Ôò -ùrå   )r   r   r   r   r   r   r   r   )NNNFFTFF)r   ú
str | Noner   zstr | Literal[False] | Noner   rö   r   Úboolr   r÷   r   r÷   r   r÷   r   r÷   ÚreturnÚNone)r#   Ústrrø   rú   )r    rú   rø   rù   )r0   rú   rø   r   )rø   rú   )rø   z	list[str])rø   r   )rø   zIterator[str])rø   zIterator[Path])GÚ__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__r   r%   r"   r1   Úpropertyr   r6   r:   r@   rD   rG   rJ   rM   rP   rS   rV   rY   r\   r_   rb   re   rh   rk   rn   rq   rt   rw   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ô   Ú__static_attributes__r4   r   r   r   r      s2  † ñð #Ø15Ø"ØØØØ#Ø"'ðMàðMð /ðMð ð	Mð
 ðMð ðMð ðMð ðMð  ðMð 
õ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   )rÿ   Ú
__future__r   r   Úabcr   r   Úpathlibr   Útypingr   Úcollections.abcr   r	   r   r4   r   r   Ú<module>r     s.   ðÙ å "ã 	ß #Ý Ý  æÝ(ÝôN�cõ Nr   