+
    }i                         R t ^ RIHt ^ RIt^ RIt^ 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)XDGMixin)PlatformDirsABC)Pathc                     ] 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&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   "d/Users/ahmad/.openclaw/workspace/my-crawler/.venv/lib/python3.14/site-packages/platformdirs/macos.py__annotate___MacOSDefaults.__annotate__   s     f fs f    c                ^    V P                  \        P                  P                  R4      4      # )zb:return: 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      # )zh:return: 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                   # )zC:return: 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   1   s     $ $9 $r   c                	    V P                   # )N)r+   r   s   &r   _site_config_dirs _MacOSDefaults._site_config_dirs0   s    ###r   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   5   s     Y Y Yr   c                ^    V P                  \        P                  P                  R4      4      # )zV:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``z~/Library/Cachesr   r   s   &r   user_cache_dir_MacOSDefaults.user_cache_dir4   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  
:return: 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_dir9   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   L   s     J J Jr   c                8    V P                  V P                  4      # )zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r0   rG   r   s   &r   site_cache_path_MacOSDefaults.site_cache_pathK   s     44T5H5HIIr   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   Q   s     " " "r   c                    V P                   # )zB:return: state directory tied to the user, same as `user_data_dir`r6   r   s   &r   user_state_dir_MacOSDefaults.user_state_dirP   r9   r   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   V   s     W Wc Wr   c                ^    V P                  \        P                  P                  R4      4      # )zR:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``z~/Library/Logsr   r   s   &r   user_log_dir_MacOSDefaults.user_log_dirU   s%     001C1CDT1UVVr   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   [        1 1C 1r   c                @    \         P                  P                  R4      # )zC:return: documents directory tied to the user, e.g. ``~/Documents``z~/Documentsr   r   r   r   s   &r   user_documents_dir!_MacOSDefaults.user_documents_dirZ        ww!!-00r   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   `   rV   r   c                @    \         P                  P                  R4      # )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``z~/DownloadsrX   r   s   &r   user_downloads_dir!_MacOSDefaults.user_downloads_dir_   r[   r   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   e   s     0 03 0r   c                @    \         P                  P                  R4      # )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``z
~/PicturesrX   r   s   &r   user_pictures_dir _MacOSDefaults.user_pictures_dird   s     ww!!,//r   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   j   s     . . .r   c                @    \         P                  P                  R4      # )z=:return: videos directory tied to the user, e.g. ``~/Movies``z~/MoviesrX   r   s   &r   user_videos_dir_MacOSDefaults.user_videos_diri   s     ww!!*--r   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   o   s     - - -r   c                @    \         P                  P                  R4      # )z;:return: music directory tied to the user, e.g. ``~/Music``z~/MusicrX   r   s   &r   user_music_dir_MacOSDefaults.user_music_dirn   s     ww!!),,r   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   t   s     / /# /r   c                @    \         P                  P                  R4      # )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``z	~/DesktoprX   r   s   &r   user_desktop_dir_MacOSDefaults.user_desktop_dirs   s     ww!!+..r   c                   V ^8  d   QhRR/# r
   r   )r   s   "r   r   r   y   s     h h# hr   c                ^    V P                  \        P                  P                  R4      4      # )zg:return: 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_dirx   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                   # )zF:return: runtime directory shared by users, same as `user_runtime_dir`)rr   r   s   &r   site_runtime_dir_MacOSDefaults.site_runtime_dir}   s     $$$r   r   N)__name__
__module____qualname____firstlineno____doc__propertyr   r+   r2   r7   r<   r@   rG   rK   rO   rS   rY   r^   rb   rf   rj   rn   rr   rv   __static_attributes__r   r   r   r   r      s{    f f   I I " " $ $ Y Y  " J J " " W W 1 1 1 1 0 0 . . - - / / 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)rx   ry   rz   r{   r|   r~   r   r   r   r   r      s    r   r   )r|   
__future__r   os.pathr   r#   typingr   _xdgr   apir   pathlibr   r   r   __all__r   r   r   <module>r      sI     "  
     p%_ p%fHn   r   