ó
    T=Œj':  ã                  ó€   • 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                  óp  • \ rS rSrSr        SN                 SOS jjrSPS jrSQS jrSRS jr\	\
SSS j5       5       r\	\
SSS	 j5       5       r\	STS
 j5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	STS j5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r\	\
SSS j5       5       r \	\
SSS j5       5       r!\	\
SSS j5       5       r"\	\
SSS  j5       5       r#\	\
SSS! j5       5       r$\	\
SSS" j5       5       r%\	STS# j5       r&\	\
SSS$ j5       5       r'\	\
SSS% j5       5       r(\	SUS& j5       r)\	SUS' j5       r*\	SUS( j5       r+\	SUS) j5       r,\	SUS* j5       r-\	SUS+ j5       r.\	SUS, j5       r/\	SUS- j5       r0\	SUS. j5       r1\	SUS/ j5       r2\	SUS0 j5       r3\	SUS1 j5       r4\	SUS2 j5       r5\	SUS3 j5       r6\	SUS4 j5       r7\	SUS5 j5       r8\	SUS6 j5       r9\	SUS7 j5       r:\	SUS8 j5       r;\	SUS9 j5       r<\	SUS: j5       r=\	SUS; j5       r>\	SUS< j5       r?\	SUS= j5       r@\	SUS> j5       rA\	SUS? j5       rB\	SUS@ j5       rCSVSA jrDSVSB jrESVSC jrFSVSD jrGSVSE jrHSVSF jrISWSG jrJSWSH jrKSWSI jrLSWSJ jrMSWSK jrNSWSL jrOSMrPg)XÚ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	            Ú`/Users/stevendouglas/BidBrain/.venv/lib/python3.13/site-packages/pip/_vendor/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: projects directory tied to the userNr4   r5   s    r   Úuser_projects_dirÚ!PlatformDirsABC.user_projects_dirÓ   r8   r   c                ó   • g)z1:returns: public share directory tied to the userNr4   r5   s    r   Úuser_publicshare_dirÚ$PlatformDirsABC.user_publicshare_dirØ   r8   r   c                ó   • g)z.:returns: templates directory tied to the userNr4   r5   s    r   Úuser_templates_dirÚ"PlatformDirsABC.user_templates_dirÝ   r8   r   c                ó   • g)z*:returns: fonts directory tied to the userNr4   r5   s    r   Úuser_fonts_dirÚPlatformDirsABC.user_fonts_dirâ   r8   r   c                ó   • g)z/:returns: preference directory tied to the userNr4   r5   s    r   Úuser_preference_dirÚ#PlatformDirsABC.user_preference_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_path1  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_path6  ó   € ô �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_pathE  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_pathJ  ó   € ô �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_pathO  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_pathT  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_pathY  ó   € ô �D×)Ñ)Ó*Ð*r   c                ó,   • [        U R                  5      $ )z(:returns: projects path tied to the user)r   rq   r5   s    r   Úuser_projects_pathÚ"PlatformDirsABC.user_projects_path^  rÀ   r   c                ó,   • [        U R                  5      $ )z,:returns: public share path tied to the user)r   rt   r5   s    r   Úuser_publicshare_pathÚ%PlatformDirsABC.user_publicshare_pathc  s   € ô �D×-Ñ-Ó.Ð.r   c                ó,   • [        U R                  5      $ )z):returns: templates path tied to the user)r   rw   r5   s    r   Úuser_templates_pathÚ#PlatformDirsABC.user_templates_pathh  r¹   r   c                ó,   • [        U R                  5      $ )z%:returns: fonts path tied to the user)r   rz   r5   s    r   Úuser_fonts_pathÚPlatformDirsABC.user_fonts_pathm  r¥   r   c                ó,   • [        U R                  5      $ )z*:returns: preference path tied to the user)r   r}   r5   s    r   Úuser_preference_pathÚ$PlatformDirsABC.user_preference_pathr  s   € ô �D×,Ñ,Ó-Ð-r   c                ó,   • [        U R                  5      $ )z#:returns: bin path tied to the user)r   r€   r5   s    r   Úuser_bin_pathÚPlatformDirsABC.user_bin_pathw  r²   r   c                ó,   • [        U R                  5      $ )z":returns: bin path shared by users)r   rƒ   r5   s    r   Úsite_bin_pathÚPlatformDirsABC.site_bin_path|  r²   r   c                ó,   • [        U R                  5      $ )z,:returns: applications path tied to the user)r   r†   r5   s    r   Úuser_applications_pathÚ&PlatformDirsABC.user_applications_path�  ó   € ô �D×.Ñ.Ó/Ð/r   c                ó,   • [        U R                  5      $ )z+:returns: applications path shared by users)r   r‰   r5   s    r   Úsite_applications_pathÚ&PlatformDirsABC.site_applications_path†  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_path‹  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_dirs•  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_dirsš  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_dirsŸ  ó   é € à×!Ñ!Ò!Ø×!Ñ!Ó!ù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_dirs¤  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_dirs©  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])QÚ__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ò   rõ   rù   rü   rÿ   r  r  r	  r  r  r  Ú__static_attributes__r4   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   r4   r   r   Ú<module>r&     s.   ðÙ å "ã 	ß #Ý Ý  æÝ(Ýô@�cõ @r   