
    q"h
                    r    S r SSKJr  SSKrSSKrSSKJr  SSKJ	r	  \(       a  SSK
Jr   " S S	\	5      rS	/rg)
zmacOS.    )annotationsN)TYPE_CHECKING   )PlatformDirsABC)Pathc                     \ rS rSrS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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>`.

c                ^    U R                  [        R                  R                  S5      5      $ )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    P/var/www/html/env/lib/python3.13/site-packages/pip/_vendor/platformdirs/macos.pyuser_data_dirMacOS.user_data_dir   s%     001C1CDc1dee    c                    [         R                  R                  S5      nU(       a  U R                  S5      /O/ nUR	                  U R                  S5      5        U R
                  (       a  [        R                  R                  U5      $ US   $ )a
  
:return: data directory shared by users, e.g. ``/Library/Application Support/$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. ``/opt/homebrew/share/$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.
  ``/opt/homebrew/share/$appname/$version:/Library/Application Support/$appname/$version``
/opt/homebrewz/opt/homebrew/sharez/Library/Application Supportr   	sysprefix
startswithr   append	multipathr   pathsepjoinr   is_homebrew	path_lists      r   site_data_dirMacOS.site_data_dir    so     jj++O<R]T667LMNce	::;YZ[>>::??9--|r   c                8    U R                  U R                  5      $ )zh:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``) _first_item_as_path_if_multipathr$   r   s    r   site_data_pathMacOS.site_data_path1   s     44T5G5GHHr   c                    U R                   $ )zC:return: config directory tied to the user, same as `user_data_dir`r   r   s    r   user_config_dirMacOS.user_config_dir6        !!!r   c                    U R                   $ )zF:return: config directory shared by the users, same as `site_data_dir`)r$   r   s    r   site_config_dirMacOS.site_config_dir;   r.   r   c                ^    U R                  [        R                  R                  S5      5      $ )zV:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``z~/Library/Cachesr   r   s    r   user_cache_dirMacOS.user_cache_dir@   s%     001C1CDV1WXXr   c                    [         R                  R                  S5      nU(       a  U R                  S5      /O/ nUR	                  U R                  S5      5        U R
                  (       a  [        R                  R                  U5      $ US   $ )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. ``/opt/homebrew/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.
  ``/opt/homebrew/var/cache/$appname/$version:/Library/Caches/$appname/$version``
r   z/opt/homebrew/var/cachez/Library/Cachesr   r   r!   s      r   site_cache_dirMacOS.site_cache_dirE   so     jj++O<VaT667PQRgi	::;LMN>>::??9--|r   c                8    U R                  U R                  5      $ )zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r'   r6   r   s    r   site_cache_pathMacOS.site_cache_pathV   s     44T5H5HIIr   c                    U R                   $ )zB:return: state directory tied to the user, same as `user_data_dir`r+   r   s    r   user_state_dirMacOS.user_state_dir[   r.   r   c                ^    U R                  [        R                  R                  S5      5      $ )zR:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``z~/Library/Logsr   r   s    r   user_log_dirMacOS.user_log_dir`   s%     001C1CDT1UVVr   c                @    [         R                  R                  S5      $ )zC:return: documents directory tied to the user, e.g. ``~/Documents``z~/Documentsr   r   r   r   s    r   user_documents_dirMacOS.user_documents_dire        ww!!-00r   c                @    [         R                  R                  S5      $ )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``z~/DownloadsrB   r   s    r   user_downloads_dirMacOS.user_downloads_dirj   rE   r   c                @    [         R                  R                  S5      $ )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``z
~/PicturesrB   r   s    r   user_pictures_dirMacOS.user_pictures_diro   s     ww!!,//r   c                @    [         R                  R                  S5      $ )z=:return: videos directory tied to the user, e.g. ``~/Movies``z~/MoviesrB   r   s    r   user_videos_dirMacOS.user_videos_dirt   s     ww!!*--r   c                @    [         R                  R                  S5      $ )z;:return: music directory tied to the user, e.g. ``~/Music``z~/MusicrB   r   s    r   user_music_dirMacOS.user_music_diry   s     ww!!),,r   c                @    [         R                  R                  S5      $ )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``z	~/DesktoprB   r   s    r   user_desktop_dirMacOS.user_desktop_dir~   s     ww!!+..r   c                ^    U R                  [        R                  R                  S5      5      $ )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MacOS.user_runtime_dir   s%     001C1CDe1fggr   c                    U R                   $ )zF:return: runtime directory shared by users, same as `user_runtime_dir`)rV   r   s    r   site_runtime_dirMacOS.site_runtime_dir   s     $$$r    N)returnstr)r\   r   )__name__
__module____qualname____firstlineno____doc__propertyr   r$   r(   r,   r0   r3   r6   r9   r<   r?   rC   rG   rJ   rM   rP   rS   rV   rY   __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	   )rb   
__future__r   os.pathr   r   typingr   apir   pathlibr   r	   __all__r[   r   r   <module>rk      s8     "  
    |%O |%@ r   