
    Xh                    h    d Z ddlmZ ddlZddlZddlmZ ddlm	Z	 erddl
mZ  G d d	e	      Zd	gZy)
zmacOS.    )annotationsN)TYPE_CHECKING   )PlatformDirsABC)Pathc                  T   e Zd ZdZedd       Zedd       Zedd       Zedd       Zedd       Z	edd       Z
edd       Zedd	       Zedd
       Zedd       Zedd       Zedd       Zedd       Zedd       Zedd       Zedd       Zedd       Zedd       Zy)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>`.

    c                ^    | j                  t        j                  j                  d            S )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    F/var/www/html/myenv/lib/python3.12/site-packages/platformdirs/macos.pyuser_data_dirzMacOS.user_data_dir   s%     001C1CDc1dee    c                D   dt         j                  v }|r"t         j                  j                  d      d   nd}|r| j                  | d      gng }|j	                  | j                  d             | j
                  rt        j                  j                  |      S |d   S )aH  
        :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. ``$homebrew_prefix/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.
          ``$homebrew_prefix/share/$appname/$version:/Library/Application Support/$appname/$version``
        /opt/pythonr    z/sharez/Library/Application Support	sysprefixsplitr   append	multipathr   pathsepjoinr   is_homebrewhomebrew_prefix	path_lists       r   site_data_dirzMacOS.site_data_dir    s     $szz1@K#****=9!<QSWbT66/9J&7QRShj	::;YZ[>>::??9--|r   c                8    | j                  | j                        S )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_pathzMacOS.site_data_path2   s     44T5G5GHHr   c                    | j                   S )zC:return: config directory tied to the user, same as `user_data_dir`r   r   s    r   user_config_dirzMacOS.user_config_dir7        !!!r   c                    | j                   S )zF:return: config directory shared by the users, same as `site_data_dir`)r$   r   s    r   site_config_dirzMacOS.site_config_dir<   r+   r   c                ^    | j                  t        j                  j                  d            S )zV:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``z~/Library/Cachesr   r   s    r   user_cache_dirzMacOS.user_cache_dirA   s%     001C1CDV1WXXr   c                D   dt         j                  v }|r"t         j                  j                  d      d   nd}|r| j                  | d      gng }|j	                  | j                  d             | j
                  rt        j                  j                  |      S |d   S )a7  
        :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   r   z
/var/cachez/Library/Cachesr   r    s       r   site_cache_dirzMacOS.site_cache_dirF   s     $szz1@K#****=9!<QS[fT66/9J*7UVWln	::;LMN>>::??9--|r   c                8    | j                  | j                        S )zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r&   r1   r   s    r   site_cache_pathzMacOS.site_cache_pathX   s     44T5H5HIIr   c                    | j                   S )zB:return: state directory tied to the user, same as `user_data_dir`r)   r   s    r   user_state_dirzMacOS.user_state_dir]   r+   r   c                ^    | j                  t        j                  j                  d            S )zR:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``z~/Library/Logsr   r   s    r   user_log_dirzMacOS.user_log_dirb   s%     001C1CDT1UVVr   c                @    t         j                  j                  d      S )zC:return: documents directory tied to the user, e.g. ``~/Documents``z~/Documentsr   r   r   r   s    r   user_documents_dirzMacOS.user_documents_dirg        ww!!-00r   c                @    t         j                  j                  d      S )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``z~/Downloadsr9   r   s    r   user_downloads_dirzMacOS.user_downloads_dirl   r;   r   c                @    t         j                  j                  d      S )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``z
~/Picturesr9   r   s    r   user_pictures_dirzMacOS.user_pictures_dirq   s     ww!!,//r   c                @    t         j                  j                  d      S )z=:return: videos directory tied to the user, e.g. ``~/Movies``z~/Moviesr9   r   s    r   user_videos_dirzMacOS.user_videos_dirv   s     ww!!*--r   c                @    t         j                  j                  d      S )z;:return: music directory tied to the user, e.g. ``~/Music``z~/Musicr9   r   s    r   user_music_dirzMacOS.user_music_dir{   s     ww!!),,r   c                @    t         j                  j                  d      S )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``z	~/Desktopr9   r   s    r   user_desktop_dirzMacOS.user_desktop_dir   s     ww!!+..r   c                ^    | j                  t        j                  j                  d            S )zg:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``z~/Library/Caches/TemporaryItemsr   r   s    r   user_runtime_dirzMacOS.user_runtime_dir   s%     001C1CDe1fggr   c                    | j                   S )zF:return: runtime directory shared by users, same as `user_runtime_dir`)rG   r   s    r   site_runtime_dirzMacOS.site_runtime_dir   s     $$$r   N)returnstr)rJ   r   )__name__
__module____qualname____doc__propertyr   r$   r'   r*   r-   r/   r1   r3   r5   r7   r:   r=   r?   rA   rC   rE   rG   rI    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	   )rO   
__future__r   os.pathr   r   typingr   apir   pathlibr   r	   __all__rQ   r   r   <module>rX      s8     "  
    ~%O ~%D r   