ó
    T=ŒjB%  ã                  ó°   • S r SSKJr  SSKrSSKrSSKJr  \(       a  SSKJ	r	  SSK
Jr  SSKJr  \(       a  SS	KJr   " S
 S\5      r " S S\\5      rS/rg)zmacOS.é    )ÚannotationsN)ÚTYPE_CHECKING)ÚIteratoré   )ÚXDGMixin)ÚPlatformDirsABC)ÚPathc                  ó¬  • \ rS rSrSrS(S jrS)S jr\S(S j5       r\S)S j5       r	\S*S j5       r
\S*S j5       r\S(S	 j5       r\S)S
 j5       r\S(S j5       r\S(S j5       r\S*S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r\S(S j5       r \S(S j5       r!\S(S j5       r"\S)S  j5       r#\S(S! j5       r$\S(S" j5       r%\S(S# j5       r&S+S$ jr'S+S% jr(S&r)g'),Ú_MacOSDefaultsé   ax  Default platform directories for macOS without XDG environment variable overrides.

Follows the guidance from `Apple's File System Programming Guide
<https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_.
The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`.

c                ó^   • U R                  [        R                  R                  S5      5      $ )Nz~/Library/Application Support©Ú_append_app_name_and_versionÚosÚpathÚ
expanduser©Úselfs    Úb/Users/stevendouglas/BidBrain/.venv/lib/python3.13/site-packages/pip/_vendor/platformdirs/macos.pyÚ_base_user_app_support_dirÚ)_MacOSDefaults._base_user_app_support_dir   s#   € Ø×0Ñ0´·±×1CÑ1CÐDcÓ1dÓeÐeó    c                óþ   • S[         R                  ;   nU(       a"  [         R                  R                  S5      S   OSnU(       a  U R                  U S35      /O/ nUR	                  U R                  S5      5        U$ )Nú/opt/pythonr   Ú z/sharez/Library/Application Support)ÚsysÚprefixÚsplitr   Úappend©r   Úis_homebrewÚhomebrew_prefixÚ	path_lists       r   Ú_base_site_dirsÚ_MacOSDefaults._base_site_dirs   sn   € Ø#¤s§z¡zÑ1ˆÞ@Kœ#Ÿ*™*×*Ñ*¨=Ó9¸!Ò<ÐQSˆÞWb�T×6Ñ6¸/Ð9JÈ&Ð7QÓRÑSÐhjˆ	Ø×Ñ˜×:Ñ:Ð;YÓZÔ[ØÐr   c                ó"   • U R                  5       $ )zc:returns: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``©r   r   s    r   Úuser_data_dirÚ_MacOSDefaults.user_data_dir&   ó   € ð ×.Ñ.Ó0Ð0r   c                ó"   • U R                  5       $ ©N©r$   r   s    r   Ú_site_data_dirsÚ_MacOSDefaults._site_data_dirs+   ó   € à×#Ñ#Ó%Ð%r   c                ó8   • U R                  U R                  5      $ )zi:returns: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)Ú _first_item_as_path_if_multipathÚsite_data_dirr   s    r   Úsite_data_pathÚ_MacOSDefaults.site_data_path/   s   € ð ×4Ñ4°T×5GÑ5GÓHÐHr   c                ó8   • U R                  U R                  5      $ )zk:returns: config path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r2   Úsite_config_dirr   s    r   Úsite_config_pathÚ_MacOSDefaults.site_config_path4   s   € ð ×4Ñ4°T×5IÑ5IÓJÐJr   c                ó"   • U R                  5       $ )zD:returns: config directory tied to the user, same as `user_data_dir`r'   r   s    r   Úuser_config_dirÚ_MacOSDefaults.user_config_dir9   r*   r   c                ó"   • U R                  5       $ r,   r-   r   s    r   Ú_site_config_dirsÚ _MacOSDefaults._site_config_dirs>   r0   r   c                ó^   • U R                  [        R                  R                  S5      5      $ )zW:returns: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``z~/Library/Cachesr   r   s    r   Úuser_cache_dirÚ_MacOSDefaults.user_cache_dirB   s%   € ð ×0Ñ0´·±×1CÑ1CÐDVÓ1WÓXÐXr   c                ód  • S[         R                  ;   nU(       a"  [         R                  R                  S5      S   OSnU(       a  U R                  U S35      /O/ nUR	                  U R                  S5      5        U R
                  (       a  [        R                  R                  U5      $ US   $ )aô  :returns: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``. If we're using a Python binary managed by `Homebrew <https://brew.sh>`_, the directory will be under the Homebrew prefix, e.g. ``$homebrew_prefix/var/cache/$appname/$version``. If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled, and we're in Homebrew, the response is a multi-path string separated by ":", e.g. ``$homebrew_prefix/var/cache/$appname/$version:/Library/Caches/$appname/$version``r   r   r   z
/var/cachez/Library/Caches)	r   r   r   r   r   Ú	multipathr   ÚpathsepÚjoinr    s       r   Úsite_cache_dirÚ_MacOSDefaults.site_cache_dirG   sŽ   € ð $¤s§z¡zÑ1ˆÞ@Kœ#Ÿ*™*×*Ñ*¨=Ó9¸!Ò<ÐQSˆÞ[f�T×6Ñ6¸/Ð9JÈ*Ð7UÓVÑWÐlnˆ	Ø×Ñ˜×:Ñ:Ð;LÓMÔNØ�>�>Ü—:‘:—?‘? 9Ó-Ð-Ø˜‰|Ðr   c                ó8   • U R                  U R                  5      $ )zj:returns: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r2   rG   r   s    r   Úsite_cache_pathÚ_MacOSDefaults.site_cache_pathR   s   € ð ×4Ñ4°T×5HÑ5HÓIÐIr   c                ó"   • U R                  5       $ )zC:returns: state directory tied to the user, same as `user_data_dir`r'   r   s    r   Úuser_state_dirÚ_MacOSDefaults.user_state_dirW   r*   r   c                ó(   • U R                  5       S   $ )zB:returns: state directory shared by users, same as `site_data_dir`r   r-   r   s    r   Úsite_state_dirÚ_MacOSDefaults.site_state_dir\   s   € ð ×#Ñ#Ó% aÑ(Ð(r   c                ó^   • U R                  [        R                  R                  S5      5      $ )zS:returns: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``z~/Library/Logsr   r   s    r   Úuser_log_dirÚ_MacOSDefaults.user_log_dira   s%   € ð ×0Ñ0´·±×1CÑ1CÐDTÓ1UÓVÐVr   c                ó$   • U R                  S5      $ )zQ:returns: log directory shared by users, e.g. ``/Library/Logs/$appname/$version``z/Library/Logs)r   r   s    r   Úsite_log_dirÚ_MacOSDefaults.site_log_dirf   s   € ð ×0Ñ0°ÓAÐAr   c                ó@   • [         R                  R                  S5      $ )zD:returns: documents directory tied to the user, e.g. ``~/Documents``z~/Documents©r   r   r   r   s    r   Úuser_documents_dirÚ!_MacOSDefaults.user_documents_dirk   ó   € ô �w‰w×!Ñ! -Ó0Ð0r   c                ó@   • [         R                  R                  S5      $ )zD:returns: downloads directory tied to the user, e.g. ``~/Downloads``z~/DownloadsrY   r   s    r   Úuser_downloads_dirÚ!_MacOSDefaults.user_downloads_dirp   r\   r   c                ó@   • [         R                  R                  S5      $ )zB:returns: pictures directory tied to the user, e.g. ``~/Pictures``z
~/PicturesrY   r   s    r   Úuser_pictures_dirÚ _MacOSDefaults.user_pictures_diru   ó   € ô �w‰w×!Ñ! ,Ó/Ð/r   c                ó@   • [         R                  R                  S5      $ )z>:returns: videos directory tied to the user, e.g. ``~/Movies``z~/MoviesrY   r   s    r   Úuser_videos_dirÚ_MacOSDefaults.user_videos_dirz   ó   € ô �w‰w×!Ñ! *Ó-Ð-r   c                ó@   • [         R                  R                  S5      $ )z<:returns: music directory tied to the user, e.g. ``~/Music``z~/MusicrY   r   s    r   Úuser_music_dirÚ_MacOSDefaults.user_music_dir   s   € ô �w‰w×!Ñ! )Ó,Ð,r   c                ó@   • [         R                  R                  S5      $ )z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``z	~/DesktoprY   r   s    r   Úuser_desktop_dirÚ_MacOSDefaults.user_desktop_dir„   s   € ô �w‰w×!Ñ! +Ó.Ð.r   c                ó@   • [         R                  R                  S5      $ )zB:returns: projects directory tied to the user, e.g. ``~/Projects``z
~/ProjectsrY   r   s    r   Úuser_projects_dirÚ _MacOSDefaults.user_projects_dir‰   rc   r   c                ó@   • [         R                  R                  S5      $ )zD:returns: public share directory tied to the user, e.g. ``~/Public``z~/PublicrY   r   s    r   Úuser_publicshare_dirÚ#_MacOSDefaults.user_publicshare_dirŽ   rg   r   c                ó@   • [         R                  R                  S5      $ )zD:returns: templates directory tied to the user, e.g. ``~/Templates``z~/TemplatesrY   r   s    r   Úuser_templates_dirÚ!_MacOSDefaults.user_templates_dir“   r\   r   c                ó@   • [         R                  R                  S5      $ )zD:returns: fonts directory tied to the user, e.g. ``~/Library/Fonts``z~/Library/FontsrY   r   s    r   Úuser_fonts_dirÚ_MacOSDefaults.user_fonts_dir˜   s   € ô �w‰w×!Ñ!Ð"3Ó4Ð4r   c                ó^   • U R                  [        R                  R                  S5      5      $ )zW:returns: preference directory tied to the user, e.g. ``~/Library/Preferences/AppName``z~/Library/Preferencesr   r   s    r   Úuser_preference_dirÚ"_MacOSDefaults.user_preference_dir�   s%   € ð ×0Ñ0´·±×1CÑ1CÐD[Ó1\Ó]Ð]r   c                ó@   • [         R                  R                  S5      $ )z?:returns: bin directory tied to the user, e.g. ``~/.local/bin``z~/.local/binrY   r   s    r   Úuser_bin_dirÚ_MacOSDefaults.user_bin_dir¢   s   € ô �w‰w×!Ñ! .Ó1Ð1r   c                ó   • g)z@:returns: bin directory shared by users, e.g. ``/usr/local/bin``z/usr/local/bin© r   s    r   Úsite_bin_dirÚ_MacOSDefaults.site_bin_dir§   s   € ð  r   c                ó@   • [         R                  R                  S5      $ )zJ:returns: applications directory tied to the user, e.g. ``~/Applications``z~/ApplicationsrY   r   s    r   Úuser_applications_dirÚ$_MacOSDefaults.user_applications_dir¬   s   € ô �w‰w×!Ñ!Ð"2Ó3Ð3r   c                ó   • S/$ )Nz/Applicationsr�   r   s    r   Ú_site_applications_dirsÚ&_MacOSDefaults._site_applications_dirs±   s   € àÐ Ð r   c                ó„   • U R                   nU R                  (       a  [        R                  R	                  U5      $ US   $ )zH:returns: applications directory shared by users, e.g. ``/Applications``r   )rˆ   rD   r   rE   rF   )r   Údirss     r   Úsite_applications_dirÚ$_MacOSDefaults.site_applications_dirµ   s1   € ð ×+Ñ+ˆØ(,¯¯Œr�z‰z�‰˜tÓ$ÐC¸DÀ¹GÐCr   c                ó^   • U R                  [        R                  R                  S5      5      $ )zh:returns: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``z~/Library/Caches/TemporaryItemsr   r   s    r   Úuser_runtime_dirÚ_MacOSDefaults.user_runtime_dir»   s%   € ð ×0Ñ0´·±×1CÑ1CÐDeÓ1fÓgÐgr   c                ó   • U R                   $ )zG:returns: runtime directory shared by users, same as `user_runtime_dir`)r�   r   s    r   Úsite_runtime_dirÚ_MacOSDefaults.site_runtime_dirÀ   s   € ð ×$Ñ$Ð$r   c              #  óT   #   • U R                   v •  U R                   Sh  v•N   g N7f)z4:yield: all user and site configuration directories.N)r;   r>   r   s    r   Úiter_config_dirsÚ_MacOSDefaults.iter_config_dirsÅ   s    é € à×"Ñ"Ò"Ø×)Ñ)×)Ó)ùó   ‚( &¡(c              #  óT   #   • U R                   v •  U R                   Sh  v•N   g N7f)z+:yield: all user and site data directories.N)r(   r.   r   s    r   Úiter_data_dirsÚ_MacOSDefaults.iter_data_dirsÊ   s    é € à× Ñ Ò Ø×'Ñ'×'Ó'ùr—   r�   N)ÚreturnÚstr)r›   z	list[str])r›   r	   )r›   zIterator[str])*Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__r   r$   Úpropertyr(   r.   r4   r8   r;   r>   rA   rG   rJ   rM   rP   rS   rV   rZ   r^   ra   re   ri   rl   ro   rr   ru   rx   r{   r~   r‚   r…   rˆ   rŒ   r�   r’   r•   r™   Ú__static_attributes__r�   r   r   r   r      sš  † ñôfôð ó1ó ð1ð ó&ó ð&ð óIó ðIð óKó ðKð ó1ó ð1ð ó&ó ð&ð óYó ðYð óó ðð óJó ðJð ó1ó ð1ð ó)ó ð)ð óWó ðWð óBó ðBð ó1ó ð1ð ó1ó ð1ð ó0ó ð0ð ó.ó ð.ð ó-ó ð-ð ó/ó ð/ð ó0ó ð0ð ó.ó ð.ð ó1ó ð1ð ó5ó ð5ð ó^ó ð^ð ó2ó ð2ð ó ó ð ð ó4ó ð4ð ó!ó ð!ð óDó ðDð
 óhó ðhð ó%ó ð%ô*÷
(r   r   c                  ó   • \ rS rSrSrSrg)ÚMacOSéÐ   a.  Platform directories for the macOS operating system.

Follows the guidance from `Apple documentation
<https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_.
Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `version
<platformdirs.api.PlatformDirsABC.version>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.

XDG environment variables (e.g. ``$XDG_DATA_HOME``) are supported and take precedence over macOS defaults.

r�   N)r�   rž   rŸ   r    r¡   r£   r�   r   r   r¥   r¥   Ð   s   † ô	r   r¥   )r¡   Ú
__future__r   Úos.pathr   r   Útypingr   Úcollections.abcr   Ú_xdgr   Úapir   Úpathlibr	   r   r¥   Ú__all__r�   r   r   Ú<module>r¯      sO   ðÙ å "ã Û 
Ý  æÝ(å Ý  æÝôz(�_ô z(ôz
ˆH�nô 
ð ð�r   