Ë
    ÅÍáj':  ã                  óv   — d Z ddlmZ ddlZddlmZmZ ddlmZ ddl	m
Z
 e
rddlmZ ddl	mZ  G d	„ d
e«      Zy)z	Base API.é    )ÚannotationsN)ÚABCÚabstractmethod)ÚPath)ÚTYPE_CHECKING)ÚIterator)ÚLiteralc                  óÔ  — e Zd ZdZ	 	 	 	 	 	 	 	 dL	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dMd„ZdNd„ZdOd„ZdPd„Zee	dQd„«       «       Z
ee	dQd„«       «       ZedRd	„«       Zee	dQd
„«       «       Zee	dQd„«       «       ZedRd„«       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Zee	dQd„«       «       Z ee	dQd„«       «       Z!ee	dQd„«       «       Z"ee	dQd „«       «       Z#ee	dQd!„«       «       Z$edRd"„«       Z%ee	dQd#„«       «       Z&ee	dQd$„«       «       Z'edSd%„«       Z(edSd&„«       Z)edSd'„«       Z*edSd(„«       Z+edSd)„«       Z,edSd*„«       Z-edSd+„«       Z.edSd,„«       Z/edSd-„«       Z0edSd.„«       Z1edSd/„«       Z2edSd0„«       Z3edSd1„«       Z4edSd2„«       Z5edSd3„«       Z6edSd4„«       Z7edSd5„«       Z8edSd6„«       Z9edSd7„«       Z:edSd8„«       Z;edSd9„«       Z<edSd:„«       Z=edSd;„«       Z>edSd<„«       Z?edSd=„«       Z@edSd>„«       ZAedSd?„«       ZBdTd@„ZCdTdA„ZDdTdB„ZEdTdC„ZFdTdD„ZGdTdE„ZHdUdF„ZIdUdG„ZJdUdH„ZKdUdI„ZLdUdJ„ZMdUdK„ZNy)VÚPlatformDirsABCav  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	                ó€   — || _         || _        	 || _        	 || _        	 || _        	 || _        	 || _        	 || _        y)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`.
        :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	            úT/data/www/html/cgi-venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.pyÚ__init__zPlatformDirsABC.__init__   sm   € ð. ˆŒØ"ˆŒð	ð ˆŒð	ð ˆŒð	ð #ˆŒð	ð ˆŒð	ð +ˆÔð	ð
 "3ˆÔð	ó    c                ó&  — t        |dd  «      }| j                  rB|j                  | j                  «       | j                  r|j                  | j                  «       t	        j
                  j                  |d   g|¢­Ž }| j                  |«       |S )Né   r   )Úlistr   Úappendr   ÚosÚpathÚjoinÚ_optionally_create_directory)r   ÚbaseÚparamsr   s       r   Ú_append_app_name_and_versionz,PlatformDirsABC._append_app_name_and_versiong   sm   € Ü�d˜1˜2�h“ˆØ�<Š<Ø�M‰M˜$Ÿ,™,Ô'Ø�|Š|Ø—‘˜dŸl™lÔ+Ü�w‰w�|‰|˜D ™GÐ- fÒ-ˆØ×)Ñ)¨$Ô/Øˆr   c                óV   — | j                   rt        |«      j                  dd¬«       y y )NT)ÚparentsÚexist_ok)r   r   Úmkdir©r   r   s     r   r    z,PlatformDirsABC._optionally_create_directoryq   s'   € Ø×ÒÜ�‹J×Ñ T°DÐÕ9ð r   c                ót   — | j                   r"|j                  t        j                  «      d   }t	        |«      S )Nr   )r   Ú	partitionr   Úpathsepr   )r   Ú	directorys     r   Ú _first_item_as_path_if_multipathz0PlatformDirsABC._first_item_as_path_if_multipathu   s,   € Ø�>Š>à!×+Ñ+¬B¯J©JÓ7¸Ñ:ˆIÜ�I‹Ðr   c                 ó   — y)z):returns: data directory tied to the userN© ©r   s    r   Úuser_data_dirzPlatformDirsABC.user_data_dir{   ó   � r   c                 ó   — y)z(:returns: data directory shared by usersNr/   r0   s    r   Úsite_data_dirzPlatformDirsABC.site_data_dir€   r2   r   c                ó   — t         ‚©N©ÚNotImplementedErrorr0   s    r   Ú_site_data_dirszPlatformDirsABC._site_data_dirs…   ó   € ä!Ð!r   c                 ó   — y)z+:returns: config directory tied to the userNr/   r0   s    r   Úuser_config_dirzPlatformDirsABC.user_config_dir‰   r2   r   c                 ó   — y)z*:returns: config directory shared by usersNr/   r0   s    r   Úsite_config_dirzPlatformDirsABC.site_config_dirŽ   r2   r   c                ó   — t         ‚r6   r7   r0   s    r   Ú_site_config_dirsz!PlatformDirsABC._site_config_dirs“   r:   r   c                 ó   — y)z*:returns: cache directory tied to the userNr/   r0   s    r   Úuser_cache_dirzPlatformDirsABC.user_cache_dir—   r2   r   c                 ó   — y)z):returns: cache directory shared by usersNr/   r0   s    r   Úsite_cache_dirzPlatformDirsABC.site_cache_dirœ   r2   r   c                 ó   — y)z*:returns: state directory tied to the userNr/   r0   s    r   Úuser_state_dirzPlatformDirsABC.user_state_dir¡   r2   r   c                 ó   — y)z):returns: state directory shared by usersNr/   r0   s    r   Úsite_state_dirzPlatformDirsABC.site_state_dir¦   r2   r   c                 ó   — y)z(:returns: log directory tied to the userNr/   r0   s    r   Úuser_log_dirzPlatformDirsABC.user_log_dir«   r2   r   c                 ó   — y)z':returns: log directory shared by usersNr/   r0   s    r   Úsite_log_dirzPlatformDirsABC.site_log_dir°   r2   r   c                 ó   — y)z.:returns: documents directory tied to the userNr/   r0   s    r   Úuser_documents_dirz"PlatformDirsABC.user_documents_dirµ   r2   r   c                 ó   — y)z.:returns: downloads directory tied to the userNr/   r0   s    r   Úuser_downloads_dirz"PlatformDirsABC.user_downloads_dirº   r2   r   c                 ó   — y)z-:returns: pictures directory tied to the userNr/   r0   s    r   Úuser_pictures_dirz!PlatformDirsABC.user_pictures_dir¿   r2   r   c                 ó   — y)z+:returns: videos directory tied to the userNr/   r0   s    r   Úuser_videos_dirzPlatformDirsABC.user_videos_dirÄ   r2   r   c                 ó   — y)z*:returns: music directory tied to the userNr/   r0   s    r   Úuser_music_dirzPlatformDirsABC.user_music_dirÉ   r2   r   c                 ó   — y)z,:returns: desktop directory tied to the userNr/   r0   s    r   Úuser_desktop_dirz PlatformDirsABC.user_desktop_dirÎ   r2   r   c                 ó   — y)z-:returns: projects directory tied to the userNr/   r0   s    r   Úuser_projects_dirz!PlatformDirsABC.user_projects_dirÓ   r2   r   c                 ó   — y)z1:returns: public share directory tied to the userNr/   r0   s    r   Úuser_publicshare_dirz$PlatformDirsABC.user_publicshare_dirØ   r2   r   c                 ó   — y)z.:returns: templates directory tied to the userNr/   r0   s    r   Úuser_templates_dirz"PlatformDirsABC.user_templates_dirÝ   r2   r   c                 ó   — y)z*:returns: fonts directory tied to the userNr/   r0   s    r   Úuser_fonts_dirzPlatformDirsABC.user_fonts_dirâ   r2   r   c                 ó   — y)z/:returns: preference directory tied to the userNr/   r0   s    r   Úuser_preference_dirz#PlatformDirsABC.user_preference_dirç   r2   r   c                 ó   — y)z(:returns: bin directory tied to the userNr/   r0   s    r   Úuser_bin_dirzPlatformDirsABC.user_bin_dirì   r2   r   c                 ó   — y)z':returns: bin directory shared by usersNr/   r0   s    r   Úsite_bin_dirzPlatformDirsABC.site_bin_dirñ   r2   r   c                 ó   — y)z1:returns: applications directory tied to the userNr/   r0   s    r   Úuser_applications_dirz%PlatformDirsABC.user_applications_dirö   r2   r   c                 ó   — y)z0:returns: applications directory shared by usersNr/   r0   s    r   Úsite_applications_dirz%PlatformDirsABC.site_applications_dirû   r2   r   c                ó   — t         ‚r6   r7   r0   s    r   Ú_site_applications_dirsz'PlatformDirsABC._site_applications_dirs   r:   r   c                 ó   — y)z,:returns: runtime directory tied to the userNr/   r0   s    r   Úuser_runtime_dirz PlatformDirsABC.user_runtime_dir  r2   r   c                 ó   — y)z+:returns: runtime directory shared by usersNr/   r0   s    r   Úsite_runtime_dirz PlatformDirsABC.site_runtime_dir	  r2   r   c                ó,   — t        | j                  «      S )z$:returns: data path tied to the user)r   r1   r0   s    r   Úuser_data_pathzPlatformDirsABC.user_data_path  ó   € ô �D×&Ñ&Ó'Ð'r   c                ó,   — t        | j                  «      S )z#:returns: data path shared by users)r   r4   r0   s    r   Úsite_data_pathzPlatformDirsABC.site_data_path  rs   r   c                ó,   — t        | j                  «      S )z&:returns: config path tied to the user)r   r<   r0   s    r   Úuser_config_pathz PlatformDirsABC.user_config_path  ó   € ô �D×(Ñ(Ó)Ð)r   c                ó,   — t        | j                  «      S )z%:returns: config path shared by users)r   r>   r0   s    r   Úsite_config_pathz PlatformDirsABC.site_config_path  rx   r   c                ó,   — t        | j                  «      S )z%:returns: cache path tied to the user)r   rB   r0   s    r   Úuser_cache_pathzPlatformDirsABC.user_cache_path"  ó   € ô �D×'Ñ'Ó(Ð(r   c                ó,   — t        | j                  «      S )z$:returns: cache path shared by users)r   rD   r0   s    r   Úsite_cache_pathzPlatformDirsABC.site_cache_path'  r}   r   c                ó,   — t        | j                  «      S )z%:returns: state path tied to the user)r   rF   r0   s    r   Úuser_state_pathzPlatformDirsABC.user_state_path,  r}   r   c                ó,   — t        | j                  «      S )z$:returns: state path shared by users)r   rH   r0   s    r   Úsite_state_pathzPlatformDirsABC.site_state_path1  r}   r   c                ó,   — t        | j                  «      S )z#:returns: log path tied to the user)r   rJ   r0   s    r   Úuser_log_pathzPlatformDirsABC.user_log_path6  ó   € ô �D×%Ñ%Ó&Ð&r   c                ó,   — t        | j                  «      S )z":returns: log path shared by users)r   rL   r0   s    r   Úsite_log_pathzPlatformDirsABC.site_log_path;  r†   r   c                ó,   — t        | j                  «      S )z):returns: documents path tied to the user)r   rN   r0   s    r   Úuser_documents_pathz#PlatformDirsABC.user_documents_path@  ó   € ô �D×+Ñ+Ó,Ð,r   c                ó,   — t        | j                  «      S )z):returns: downloads path tied to the user)r   rP   r0   s    r   Úuser_downloads_pathz#PlatformDirsABC.user_downloads_pathE  r‹   r   c                ó,   — t        | j                  «      S )z(:returns: pictures path tied to the user)r   rR   r0   s    r   Úuser_pictures_pathz"PlatformDirsABC.user_pictures_pathJ  ó   € ô �D×*Ñ*Ó+Ð+r   c                ó,   — t        | j                  «      S )z&:returns: videos path tied to the user)r   rT   r0   s    r   Úuser_videos_pathz PlatformDirsABC.user_videos_pathO  rx   r   c                ó,   — t        | j                  «      S )z%:returns: music path tied to the user)r   rV   r0   s    r   Úuser_music_pathzPlatformDirsABC.user_music_pathT  r}   r   c                ó,   — t        | j                  «      S )z':returns: desktop path tied to the user)r   rX   r0   s    r   Úuser_desktop_pathz!PlatformDirsABC.user_desktop_pathY  ó   € ô �D×)Ñ)Ó*Ð*r   c                ó,   — t        | j                  «      S )z(:returns: projects path tied to the user)r   rZ   r0   s    r   Úuser_projects_pathz"PlatformDirsABC.user_projects_path^  r�   r   c                ó,   — t        | j                  «      S )z,:returns: public share path tied to the user)r   r\   r0   s    r   Úuser_publicshare_pathz%PlatformDirsABC.user_publicshare_pathc  s   € ô �D×-Ñ-Ó.Ð.r   c                ó,   — t        | j                  «      S )z):returns: templates path tied to the user)r   r^   r0   s    r   Úuser_templates_pathz#PlatformDirsABC.user_templates_pathh  r‹   r   c                ó,   — t        | j                  «      S )z%:returns: fonts path tied to the user)r   r`   r0   s    r   Úuser_fonts_pathzPlatformDirsABC.user_fonts_pathm  r}   r   c                ó,   — t        | j                  «      S )z*:returns: preference path tied to the user)r   rb   r0   s    r   Úuser_preference_pathz$PlatformDirsABC.user_preference_pathr  s   € ô �D×,Ñ,Ó-Ð-r   c                ó,   — t        | j                  «      S )z#:returns: bin path tied to the user)r   rd   r0   s    r   Úuser_bin_pathzPlatformDirsABC.user_bin_pathw  r†   r   c                ó,   — t        | j                  «      S )z":returns: bin path shared by users)r   rf   r0   s    r   Úsite_bin_pathzPlatformDirsABC.site_bin_path|  r†   r   c                ó,   — t        | j                  «      S )z,:returns: applications path tied to the user)r   rh   r0   s    r   Úuser_applications_pathz&PlatformDirsABC.user_applications_path�  ó   € ô �D×.Ñ.Ó/Ð/r   c                ó,   — t        | j                  «      S )z+:returns: applications path shared by users)r   rj   r0   s    r   Úsite_applications_pathz&PlatformDirsABC.site_applications_path†  r¨   r   c                ó,   — t        | j                  «      S )z':returns: runtime path tied to the user)r   rn   r0   s    r   Úuser_runtime_pathz!PlatformDirsABC.user_runtime_path‹  r—   r   c                ó,   — t        | j                  «      S )z&:returns: runtime path shared by users)r   rp   r0   s    r   Úsite_runtime_pathz!PlatformDirsABC.site_runtime_path�  r—   r   c              #  óD   K  — | j                   –— | j                  –— y­w)z4:yield: all user and site configuration directories.N)r<   r>   r0   s    r   Úiter_config_dirsz PlatformDirsABC.iter_config_dirs•  s   è ø€ à×"Ñ"Ò"Ø×"Ñ"Ó"ùó   ‚ c              #  óD   K  — | j                   –— | j                  –— y­w)z+:yield: all user and site data directories.N)r1   r4   r0   s    r   Úiter_data_dirszPlatformDirsABC.iter_data_dirsš  s   è ø€ à× Ñ Ò Ø× Ñ Ó ùr±   c              #  óD   K  — | j                   –— | j                  –— y­w)z,:yield: all user and site cache directories.N)rB   rD   r0   s    r   Úiter_cache_dirszPlatformDirsABC.iter_cache_dirsŸ  ó   è ø€ à×!Ñ!Ò!Ø×!Ñ!Ó!ùr±   c              #  óD   K  — | j                   –— | j                  –— y­w)z,:yield: all user and site state directories.N)rF   rH   r0   s    r   Úiter_state_dirszPlatformDirsABC.iter_state_dirs¤  r¶   r±   c              #  óD   K  — | j                   –— | j                  –— y­w)z*:yield: all user and site log directories.N)rJ   rL   r0   s    r   Úiter_log_dirszPlatformDirsABC.iter_log_dirs©  s   è ø€ à×ÑÒØ×ÑÓùr±   c              #  óD   K  — | j                   –— | j                  –— y­w)z.:yield: all user and site runtime directories.N)rn   rp   r0   s    r   Úiter_runtime_dirsz!PlatformDirsABC.iter_runtime_dirs®  s   è ø€ à×#Ñ#Ò#Ø×#Ñ#Ó#ùr±   c              #  óP   K  — | j                  «       D ]  }t        |«      –— Œ y­w)z.:yield: all user and site configuration paths.N)r°   r   r(   s     r   Úiter_config_pathsz!PlatformDirsABC.iter_config_paths³  s(   è ø€ à×)Ñ)Ó+ò 	ˆDÜ�t“*Óñ	ùó   ‚$&c              #  óP   K  — | j                  «       D ]  }t        |«      –— Œ y­w)z%:yield: all user and site data paths.N)r³   r   r(   s     r   Úiter_data_pathszPlatformDirsABC.iter_data_paths¸  s(   è ø€ à×'Ñ'Ó)ò 	ˆDÜ�t“*Óñ	ùr¿   c              #  óP   K  — | j                  «       D ]  }t        |«      –— Œ y­w)z&:yield: all user and site cache paths.N)rµ   r   r(   s     r   Úiter_cache_pathsz PlatformDirsABC.iter_cache_paths½  ó(   è ø€ à×(Ñ(Ó*ò 	ˆDÜ�t“*Óñ	ùr¿   c              #  óP   K  — | j                  «       D ]  }t        |«      –— Œ y­w)z&:yield: all user and site state paths.N)r¸   r   r(   s     r   Úiter_state_pathsz PlatformDirsABC.iter_state_pathsÂ  rÄ   r¿   c              #  óP   K  — | j                  «       D ]  }t        |«      –— Œ y­w)z$:yield: all user and site log paths.N)rº   r   r(   s     r   Úiter_log_pathszPlatformDirsABC.iter_log_pathsÇ  s(   è ø€ à×&Ñ&Ó(ò 	ˆDÜ�t“*Óñ	ùr¿   c              #  óP   K  — | j                  «       D ]  }t        |«      –— Œ y­w)z(:yield: all user and site runtime paths.N)r¼   r   r(   s     r   Úiter_runtime_pathsz"PlatformDirsABC.iter_runtime_pathsÌ  s(   è ø€ à×*Ñ*Ó,ò 	ˆDÜ�t“*Óñ	ù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Î   )r,   rÏ   rÍ   r   )rÍ   rÏ   )rÍ   z	list[str])rÍ   r   )rÍ   zIterator[str])rÍ   zIterator[Path])OÚ__name__Ú
__module__Ú__qualname__Ú__doc__r   r#   r    r-   Úpropertyr   r1   r4   r9   r<   r>   r@   rB   rD   rF   rH   rJ   rL   rN   rP   rR   rT   rV   rX   rZ   r\   r^   r`   rb   rd   rf   rh   rj   rl   rn   rp   rr   ru   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   r   r   r      s$  „ ñð #Ø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ð Øò;ó ó ð;ð Øò<ó ó ð<ð Øò@ó ó ð@ð Øò=ó ó ð=ð Øò9ó ó ð9ð Øò>ó ó ð>ð Øò7ó ó ð7ð Øò6ó ó ð6ð Øò@ó ó ð@ð Øò?ó ó ð?ð ò"ó ð"ð Øò;ó ó ð;ð Øò:ó ó ð:ð ò(ó ð(ð ò(ó ð(ð ò*ó ð*ð ò*ó ð*ð ò)ó ð)ð ò)ó ð)ð ò)ó ð)ð ò)ó ð)ð ò'ó ð'ð ò'ó ð'ð ò-ó ð-ð ò-ó ð-ð ò,ó ð,ð ò*ó ð*ð ò)ó ð)ð ò+ó ð+ð ò,ó ð,ð ò/ó ð/ð ò-ó ð-ð ò)ó ð)ð ò.ó ð.ð ò'ó ð'ð ò'ó ð'ð ò0ó ð0ð ò0ó ð0ð ò+ó ð+ð ò+ó ð+ó#ó
!ó
"ó
"ó
 ó
$ó
ó
ó
ó
ó
ô
r   r   )rÓ   Ú
__future__r   r   Úabcr   r   Úpathlibr   Útypingr   Úcollections.abcr   r	   r   r/   r   r   ú<module>rÚ      s.   ðÙ å "ã 	ß #Ý Ý  áÝ(Ýô@�cõ @r   