o h @sbdZddlmZddlZddlZddlmZddlm Z er$ddl m Z Gdd d e Z d gZ dS) zmacOS.) annotationsN) TYPE_CHECKING)PlatformDirsABC)Pathc@s eZdZdZed*ddZed*ddZed+d d Zed*d d Zed*d dZ ed*ddZ ed*ddZ ed+ddZ ed*ddZ ed*ddZed*ddZed*ddZed*ddZed*dd Zed*d!d"Zed*d#d$Zed*d%d&Zed*d'd(Zd)S),MacOSa Platform directories for the macOS operating system. Follows the guidance from `Apple documentation `_. Makes use of the `appname `, `version `, `ensure_exists `. returnstrcC|tjdS)zb:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``z~/Library/Application Support_append_app_name_and_versionospath expanduserselfrQ/var/www/html/venv/lib/python3.10/site-packages/pip/_vendor/platformdirs/macos.py user_data_dirzMacOS.user_data_dircCJtjd}|r|dgng}||d|jr!tj|S|dS)aB :return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``. If we're using a Python binary managed by `Homebrew `_, the directory will be under the Homebrew prefix, e.g. ``/opt/homebrew/share/$appname/$version``. If `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 sysprefix startswithr append multipathr pathsepjoinr is_homebrew path_listrrr site_data_dir  zMacOS.site_data_dirrcC ||jS)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#rrrrsite_data_path1 zMacOS.site_data_pathcC|jS)zC:return: config directory tied to the user, same as `user_data_dir`rrrrruser_config_dir6zMacOS.user_config_dircCr))zF:return: config directory shared by the users, same as `site_data_dir`)r#rrrrsite_config_dir;r,zMacOS.site_config_dircCr )zV:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``z~/Library/Cachesr rrrruser_cache_dir@rzMacOS.user_cache_dircCr)a1 :return: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``. If we're using a Python binary managed by `Homebrew `_, the directory will be under the Homebrew prefix, e.g. ``/opt/homebrew/var/cache/$appname/$version``. If `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`` rz/opt/homebrew/var/cachez/Library/Cachesrrr rrrsite_cache_dirEr$zMacOS.site_cache_dircCr%)zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r&r/rrrrsite_cache_pathVr(zMacOS.site_cache_pathcCr))zB:return: state directory tied to the user, same as `user_data_dir`r*rrrruser_state_dir[r,zMacOS.user_state_dircCr )zR:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``z~/Library/Logsr rrrr user_log_dir`rzMacOS.user_log_dircC tjdS)zC:return: documents directory tied to the user, e.g. ``~/Documents``z ~/Documentsr rrrrrruser_documents_direr(zMacOS.user_documents_dircCr3)zC:return: downloads directory tied to the user, e.g. ``~/Downloads``z ~/Downloadsr4rrrruser_downloads_dirjr(zMacOS.user_downloads_dircCr3)zA:return: pictures directory tied to the user, e.g. ``~/Pictures``z ~/Picturesr4rrrruser_pictures_diror(zMacOS.user_pictures_dircCr3)z=:return: videos directory tied to the user, e.g. ``~/Movies``z~/Moviesr4rrrruser_videos_dirtr(zMacOS.user_videos_dircCr3)z;:return: music directory tied to the user, e.g. ``~/Music``z~/Musicr4rrrruser_music_diryr(zMacOS.user_music_dircCr3)z?:return: desktop directory tied to the user, e.g. ``~/Desktop``z ~/Desktopr4rrrruser_desktop_dir~r(zMacOS.user_desktop_dircCr )zg:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``z~/Library/Caches/TemporaryItemsr rrrruser_runtime_dirrzMacOS.user_runtime_dircCr))zF:return: runtime directory shared by users, same as `user_runtime_dir`)r;rrrrsite_runtime_dirr,zMacOS.site_runtime_dirN)rr )rr)__name__ __module__ __qualname____doc__propertyrr#r'r+r-r.r/r0r1r2r5r6r7r8r9r:r;r<rrrrrsL                 r)r@ __future__ros.pathr rtypingrapirpathlibrr__all__rrrrs