+
    %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                  p   ] tR t^tRtR R ltR R l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4       t]R6 R7 l4       t R8 R9 lt!R: R; lt"R<t#R=# )>_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   "P/var/www/html/photoedit/myenv/lib/python3.14/site-packages/platformdirs/macos.py__annotate___MacOSDefaults.__annotate__   s     f fC f    c                	^    V P                  \        P                  P                  R 4      4      # )z~/Library/Application Support_append_app_name_and_versionospath
expanduserselfs   &r   _base_user_app_support_dir)_MacOSDefaults._base_user_app_support_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   _base_site_dirs_MacOSDefaults._base_site_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   s   "r   r   r   '   s     1 1s 1r   c                "    V P                  4       # )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                   V ^8  d   QhRR/# r    r   )r   s   "r   r   r   ,   s     & & &r   c                	"    V P                  4       # Nr,   r   s   &r   _site_data_dirs_MacOSDefaults._site_data_dirs+       ##%%r   c                   V ^8  d   QhRR/# r   r   r   r   )r   s   "r   r   r   0   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   5   s     1 1 1r   c                "    V P                  4       # )zD:returns: config directory tied to the user, same as `user_data_dir`r0   r   s   &r   user_config_dir_MacOSDefaults.user_config_dir4   r3   r   c                   V ^8  d   QhRR/# r    r   )r   s   "r   r   r   :   s     & &9 &r   c                	"    V P                  4       # r6   r7   r   s   &r   _site_config_dirs _MacOSDefaults._site_config_dirs9   r:   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   >   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_dir=   s%     001C1CDV1WXXr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   C   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_dirB   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   N   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``)r>   rS   r   s   &r   site_cache_path_MacOSDefaults.site_cache_pathM   s     44T5H5HIIr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   S   s     1 1 1r   c                "    V P                  4       # )zC:returns: state directory tied to the user, same as `user_data_dir`r0   r   s   &r   user_state_dir_MacOSDefaults.user_state_dirR   r3   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   X   s     ) ) )r   c                0    V P                  4       ^ ,          # )zB:returns: state directory shared by users, same as `site_data_dir`r7   r   s   &r   site_state_dir_MacOSDefaults.site_state_dirW   s     ##%a((r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   ]   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_dir\   s%     001C1CDT1UVVr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   b   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_dira   s     00AAr   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   g        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_dirf        ww!!-00r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   l   rj   r   c                @    \         P                  P                  R4      # )zD:returns: downloads directory tied to the user, e.g. ``~/Downloads``z~/Downloadsrl   r   s   &r   user_downloads_dir!_MacOSDefaults.user_downloads_dirk   ro   r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   q   s     0 03 0r   c                @    \         P                  P                  R4      # )zB:returns: pictures directory tied to the user, e.g. ``~/Pictures``z
~/Picturesrl   r   s   &r   user_pictures_dir _MacOSDefaults.user_pictures_dirp   s     ww!!,//r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   v   s     . . .r   c                @    \         P                  P                  R4      # )z>:returns: videos directory tied to the user, e.g. ``~/Movies``z~/Moviesrl   r   s   &r   user_videos_dir_MacOSDefaults.user_videos_diru   s     ww!!*--r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r   {   s     - - -r   c                @    \         P                  P                  R4      # )z<:returns: music directory tied to the user, e.g. ``~/Music``z~/Musicrl   r   s   &r   user_music_dir_MacOSDefaults.user_music_dirz   s     ww!!),,r   c                   V ^8  d   QhRR/# r   r   )r   s   "r   r   r      s     / /# /r   c                @    \         P                  P                  R4      # )z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``z	~/Desktoprl   r   s   &r   user_desktop_dir_MacOSDefaults.user_desktop_dir   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/binrl   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~/Applicationsrl   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   rP   r   rQ   rR   )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)rD   rH   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)r1   r8   r   s   &r   iter_data_dirs_MacOSDefaults.iter_data_dirs   s         ''''r   r   N)$__name__
__module____qualname____firstlineno____doc__r   r,   propertyr1   r8   r@   rD   rH   rL   rS   rW   r[   r_   rc   rg   rm   rr   rv   rz   r~   r   r   r   r   r   r   r   r   r   r   __static_attributes__r   r   r   r	   r	      s#   f 1 1 & & I I 1 1 & & Y Y   J J 1 1 ) ) 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     "  
  (   \(_ \(~
Hn 
 r   