o wi@sdZddlmZddlZddlZddlmZerddlm Z ddl m Z ddl m Z er2dd lmZGd d d e ZGd d d e eZd gZdS)zmacOS.) annotationsN) TYPE_CHECKING)Iterator)XDGMixin)PlatformDirsABC)Pathc@seZdZdZed>ddZed?ddZed@d d Zed>d d Zed?ddZ ed>ddZ ed>ddZ ed@ddZ ed>ddZ ed>ddZed>ddZed>ddZed>ddZed>d d!Zed>d"d#Zed>d$d%Zed>d&d'Zed>d(d)Zed>d*d+Zed>d,d-Zed>d.d/Zed?d0d1Zed>d2d3Zed>d4d5Zed>d6d7ZdAd9d:ZdAd;d<Zd=S)B_MacOSDefaultsaDefault platform directories for macOS without XDG environment variable overrides. Follows the guidance from `Apple's File System Programming Guide `_. The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`. returnstrcC|tjdS)zc:returns: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``z~/Library/Application Support_append_app_name_and_versionospath expanduserselfrO/home/ubuntu/sommelier/.venv/lib/python3.10/site-packages/platformdirs/macos.py user_data_dirz_MacOSDefaults.user_data_dir list[str]cCsPdtjv}|rtjddnd}|r||dgng}||d|S)N /opt/pythonrz/sharez/Library/Application Support)sysprefixsplitrappendr is_homebrewhomebrew_prefix path_listrrr_site_data_dirs!s z_MacOSDefaults._site_data_dirsrcC ||jS)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_dirrrrrsite_data_path) z_MacOSDefaults.site_data_pathcC|jS)zD:returns: config directory tied to the user, same as `user_data_dir`rrrrruser_config_dir.z_MacOSDefaults.user_config_dircCr))N)r#rrrr_site_config_dirs3z _MacOSDefaults._site_config_dirscCr )zW:returns: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``z~/Library/Cachesr rrrruser_cache_dir7rz_MacOSDefaults.user_cache_dircCsfdtjv}|rtjddnd}|r||dgng}||d|jr/tj|S|dS)a:returns: 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. ``$homebrew_prefix/var/cache/$appname/$version``. If `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``rrrz /var/cachez/Library/Caches) rrrrr multipathrpathsepjoinrrrrsite_cache_dir<s  z_MacOSDefaults.site_cache_dircCr$)zj:returns: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r%r3rrrrsite_cache_pathGr(z_MacOSDefaults.site_cache_pathcCr))zC:returns: state directory tied to the user, same as `user_data_dir`r*rrrruser_state_dirLr,z_MacOSDefaults.user_state_dircCr))zB:returns: state directory shared by users, same as `site_data_dir`)r&rrrrsite_state_dirQr,z_MacOSDefaults.site_state_dircCr )zS:returns: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``z~/Library/Logsr rrrr user_log_dirVrz_MacOSDefaults.user_log_dircCs |dS)zQ:returns: log directory shared by users, e.g. ``/Library/Logs/$appname/$version``z /Library/Logs)rrrrr site_log_dir[s z_MacOSDefaults.site_log_dircC tjdS)zD:returns: documents directory tied to the user, e.g. ``~/Documents``z ~/Documentsrrrrrrruser_documents_dir`r(z!_MacOSDefaults.user_documents_dircCr9)zD:returns: downloads directory tied to the user, e.g. ``~/Downloads``z ~/Downloadsr:rrrruser_downloads_direr(z!_MacOSDefaults.user_downloads_dircCr9)zB:returns: pictures directory tied to the user, e.g. ``~/Pictures``z ~/Picturesr:rrrruser_pictures_dirjr(z _MacOSDefaults.user_pictures_dircCr9)z>:returns: videos directory tied to the user, e.g. ``~/Movies``z~/Moviesr:rrrruser_videos_diror(z_MacOSDefaults.user_videos_dircCr9)z<:returns: music directory tied to the user, e.g. ``~/Music``z~/Musicr:rrrruser_music_dirtr(z_MacOSDefaults.user_music_dircCr9)z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``z ~/Desktopr:rrrruser_desktop_diryr(z_MacOSDefaults.user_desktop_dircCr9)z?:returns: bin directory tied to the user, e.g. ``~/.local/bin``z ~/.local/binr:rrrr user_bin_dir~r(z_MacOSDefaults.user_bin_dircCsdS)z@:returns: bin directory shared by users, e.g. ``/usr/local/bin``z/usr/local/binrrrrr site_bin_dirsz_MacOSDefaults.site_bin_dircCr9)zJ:returns: applications directory tied to the user, e.g. ``~/Applications``z~/Applicationsr:rrrruser_applications_dirr(z$_MacOSDefaults.user_applications_dircCsdgS)Nz /Applicationsrrrrr_site_applications_dirsr.z&_MacOSDefaults._site_applications_dirscCs |j}|jr tj|S|dS)zH:returns: applications directory shared by users, e.g. ``/Applications``r)rDr0rr1r2)rdirsrrrsite_applications_dirsz$_MacOSDefaults.site_applications_dircCr )zh:returns: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``z~/Library/Caches/TemporaryItemsr rrrruser_runtime_dirrz_MacOSDefaults.user_runtime_dircCr))zG:returns: runtime directory shared by users, same as `user_runtime_dir`)rGrrrrsite_runtime_dirr,z_MacOSDefaults.site_runtime_dir Iterator[str]cc|jV|jEdHdS)z4:yield: all user and site configuration directories.N)r+r-rrrriter_config_dirsz_MacOSDefaults.iter_config_dirsccrJ)z+:yield: all user and site data directories.N)rr#rrrriter_data_dirsrLz_MacOSDefaults.iter_data_dirsN)r r )r r)r r)r rI) __name__ __module__ __qualname____doc__propertyrr#r'r+r-r/r3r4r5r6r7r8r;r<r=r>r?r@rArBrCrDrFrGrHrKrMrrrrr sl                          r c@seZdZdZdS)MacOSaFPlatform directories for the macOS operating system. Follows the guidance from `Apple documentation `_. Makes use of the `appname `, `version `, `ensure_exists `. XDG environment variables (e.g. ``$XDG_DATA_HOME``) are supported and take precedence over macOS defaults. N)rNrOrPrQrrrrrSsrS)rQ __future__ros.pathrrtypingrcollections.abcr_xdgrapirpathlibrr rS__all__rrrrs