+
    ˷i                        R t ^ RIHt ^ RIt^ RIt^ RIHt ]'       d   ^ RIH	t	 ^RI
Ht ^RIHt ]'       d   ^ RIHt  ! R R	]4      t ! R
 R]]4      tR.tR# )zmacOS.)annotationsN)TYPE_CHECKING)Iterator)XDGMixin)PlatformDirsABC)Pathc                  X   ] tR t^tRt]R R l4       t]R R l4       t]R R l4       t]R R	 l4       t	]R
 R l4       t
]R R l4       t]R R l4       t]R R l4       t]R R l4       t]R R l4       t]R R l4       t]R R l4       t]R R l4       t]R R l4       t]R R l4       t]R  R! l4       t]R" R# l4       t]R$ R% l4       t]R& R' l4       t]R( R) l4       t]R* R+ l4       t]R, R- l4       t]R. R/ l4       t]R0 R1 l4       t]R2 R3 l4       tR4 R5 ltR6 R7 lt R8t!R9# ):_MacOSDefaultsax  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                   V ^8  d   QhRR/#    returnstr )formats   "2lib/python3.14/site-packages/platformdirs/macos.py__annotate___MacOSDefaults.__annotate__   s     f fs f    c                ^    V P                  \        P                  P                  R4      4      # )zc:returns: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``z~/Library/Application Support_append_app_name_and_versionospath
expanduserselfs   &r   user_data_dir_MacOSDefaults.user_data_dir   s%     001C1CDc1deer   c                   V ^8  d   QhRR/# r   r   z	list[str]r   )r   s   "r   r   r   "   s       r   c                	
   R \         P                  9   pV'       d'   \         P                  P                  R 4      ^ ,          MRpV'       d   V P                  V R24      .M. pVP	                  V P                  R4      4       V# )/opt/python z/sharez/Library/Application Support)sysprefixsplitr   appendr   is_homebrewhomebrew_prefix	path_lists   &   r   _site_data_dirs_MacOSDefaults._site_data_dirs!   sn    #szz1@K#****=9!<QSWbT66/9J&7QRShj	::;YZ[r   c                   V ^8  d   QhRR/# r   r   r   r   )r   s   "r   r   r   *   s     I I Ir   c                8    V P                  V P                  4      # )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4T5G5GHHr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   /   s     " " "r   c                    V P                   # )zD:returns: config directory tied to the user, same as `user_data_dir`r   r   s   &r   user_config_dir_MacOSDefaults.user_config_dir.        !!!r   c                   V ^8  d   QhRR/# r    r   )r   s   "r   r   r   4   s     $ $9 $r   c                	    V P                   # )N)r,   r   s   &r   _site_config_dirs _MacOSDefaults._site_config_dirs3   s    ###r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   8   s     Y Y Yr   c                ^    V P                  \        P                  P                  R4      4      # )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_dir7   s%     001C1CDV1WXXr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   =   s       r   c                z   R\         P                  9   pV'       d'   \         P                  P                  R4      ^ ,          MRpV'       d   V P                  V R24      .M. pVP	                  V P                  R4      4       V P
                  '       d    \        P                  P                  V4      # V^ ,          # )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#   z
/var/cachez/Library/Caches)	r$   r%   r&   r   r'   	multipathr   pathsepjoinr(   s   &   r   site_cache_dir_MacOSDefaults.site_cache_dir<   s     $szz1@K#****=9!<QS[fT66/9J*7UVWln	::;LMN>>>::??9--|r   c                   V ^8  d   QhRR/# r/   r   )r   s   "r   r   r   H   s     J J Jr   c                8    V P                  V P                  4      # )zj:returns: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r1   rH   r   s   &r   site_cache_path_MacOSDefaults.site_cache_pathG   s     44T5H5HIIr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   M        " " "r   c                    V P                   # )zC:returns: state directory tied to the user, same as `user_data_dir`r7   r   s   &r   user_state_dir_MacOSDefaults.user_state_dirL   r:   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   R   rO   r   c                    V P                   # )zB:returns: state directory shared by users, same as `site_data_dir`)r2   r   s   &r   site_state_dir_MacOSDefaults.site_state_dirQ   r:   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   W   s     W Wc Wr   c                ^    V P                  \        P                  P                  R4      4      # )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_dirV   s%     001C1CDT1UVVr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   \   s     B Bc Br   c                $    V P                  R4      # )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_dir[   s     00AAr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   a        1 1C 1r   c                @    \         P                  P                  R4      # )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_dir`        ww!!-00r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   f   r`   r   c                @    \         P                  P                  R4      # )zD:returns: downloads directory tied to the user, e.g. ``~/Downloads``z~/Downloadsrb   r   s   &r   user_downloads_dir!_MacOSDefaults.user_downloads_dire   re   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   k   s     0 03 0r   c                @    \         P                  P                  R4      # )zB:returns: pictures directory tied to the user, e.g. ``~/Pictures``z
~/Picturesrb   r   s   &r   user_pictures_dir _MacOSDefaults.user_pictures_dirj   s     ww!!,//r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   p   s     . . .r   c                @    \         P                  P                  R4      # )z>:returns: videos directory tied to the user, e.g. ``~/Movies``z~/Moviesrb   r   s   &r   user_videos_dir_MacOSDefaults.user_videos_diro   s     ww!!*--r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   u   s     - - -r   c                @    \         P                  P                  R4      # )z<:returns: music directory tied to the user, e.g. ``~/Music``z~/Musicrb   r   s   &r   user_music_dir_MacOSDefaults.user_music_dirt   s     ww!!),,r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   z   s     / /# /r   c                @    \         P                  P                  R4      # )z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``z	~/Desktoprb   r   s   &r   user_desktop_dir_MacOSDefaults.user_desktop_diry   s     ww!!+..r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r      s     2 2c 2r   c                @    \         P                  P                  R4      # )z?:returns: bin directory tied to the user, e.g. ``~/.local/bin``z~/.local/binrb   r   s   &r   user_bin_dir_MacOSDefaults.user_bin_dir~   s     ww!!.11r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r      s        c  r   c                    R# )z@:returns: bin directory shared by users, e.g. ``/usr/local/bin``z/usr/local/binr   r   s   &r   site_bin_dir_MacOSDefaults.site_bin_dir   s      r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r      s     4 4s 4r   c                @    \         P                  P                  R4      # )zJ:returns: applications directory tied to the user, e.g. ``~/Applications``z~/Applicationsrb   r   s   &r   user_applications_dir$_MacOSDefaults.user_applications_dir   s     ww!!"233r   c                   V ^8  d   QhRR/# r    r   )r   s   "r   r   r      s     ! ! !r   c                	    R .# )z/Applicationsr   r   s   &r   _site_applications_dirs&_MacOSDefaults._site_applications_dirs   s      r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r      s     D Ds Dr   c                    V P                   pV P                  '       d    \        P                  P	                  V4      # V^ ,          # )zH:returns: applications directory shared by users, e.g. ``/Applications``)r   rE   r   rF   rG   )r   dirss   & r   site_applications_dir$_MacOSDefaults.site_applications_dir   s3     ++(,rzzt$CDGCr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r      s     h h# hr   c                ^    V P                  \        P                  P                  R4      4      # )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1C1CDe1fggr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r      s     % %# %r   c                    V P                   # )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                   V ^8  d   QhRR/# r   r   zIterator[str]r   )r   s   "r   r   r      s     * *- *r   c              #  V   "   V P                   x  V P                   Rj  xL
  R#  L5i)z4:yield: all user and site configuration directories.N)r8   r=   r   s   &r   iter_config_dirs_MacOSDefaults.iter_config_dirs   s      """))))   )')c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r      s     ( ( (r   c              #  V   "   V P                   x  V P                   Rj  xL
  R#  L5i)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)"__name__
__module____qualname____firstlineno____doc__propertyr   r,   r3   r8   r=   rA   rH   rL   rQ   rU   rY   r]   rc   rh   rl   rp   rt   rx   r|   r   r   r   r   r   r   r   r   __static_attributes__r   r   r   r	   r	      s    f f   I I " " $ $ Y Y   J J " " " " W W B B 1 1 1 1 0 0 . . - - / / 2 2     4 4 ! ! D D
 h h % %*
( (r   r	   c                      ] tR t^tRtRtR# )MacOSa.  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     "  
  (   V(_ V(r
Hn 
 r   