1idZddlmZddlZddlZddlmZerddlm Z ddl m Z ddl m Z erdd lmZGd d e ZGd d e eZd gZdS)zmacOS.) annotationsN) TYPE_CHECKING)Iterator)XDGMixin)PlatformDirsABC)PathczeZdZdZed#dZed$dZed%dZed#d Zed$d Z ed#d Z ed#d Z ed%d Z ed#dZ ed#dZed#dZed#dZed#dZed#dZed#dZed#dZed#dZed#dZed#dZed#dZed#dZed$dZed#dZed#dZed#dZd&d Zd&d!Zd"S)'_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`. returnstrcf|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 expanduserselfs P/var/www/html/speakWrite/venv/lib/python3.11/site-packages/platformdirs/macos.py user_data_dirz_MacOSDefaults.user_data_dirs)001C1CDc1d1deee list[str]cdtjv}|r%tjddnd}|r||dgng}||d|S)N /opt/pythonrz/sharez/Library/Application Support)sysprefixsplitrappendr is_homebrewhomebrew_prefix path_lists r_site_data_dirsz_MacOSDefaults._site_data_dirs!s#sz1 @KS#***=99!<`_, 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 multipathrpathsepjoinr!s rsite_cache_dirz_MacOSDefaults.site_cache_dir<s$sz1 @KS#***=99!< .:??9-- -|rc6||jS)zj:returns: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r'r6rs rsite_cache_pathz_MacOSDefaults.site_cache_pathGs44T5HIIIrc|jS)zC:returns: state directory tied to the user, same as `user_data_dir`r+rs ruser_state_dirz_MacOSDefaults.user_state_dirLr-rc|jS)zB:returns: state directory shared by users, same as `site_data_dir`)r(rs rsite_state_dirz_MacOSDefaults.site_state_dirQr-rcf|tjdS)zS:returns: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``z~/Library/Logsrrs r user_log_dirz_MacOSDefaults.user_log_dirVs)001C1CDT1U1UVVVrc,|dS)zQ:returns: log directory shared by users, e.g. ``/Library/Logs/$appname/$version``z /Library/Logs)rrs r site_log_dirz_MacOSDefaults.site_log_dir[s00AAArc@tjdS)zD:returns: documents directory tied to the user, e.g. ``~/Documents``z ~/Documentsrrrrs ruser_documents_dirz!_MacOSDefaults.user_documents_dir`w!!-000rc@tjdS)zD:returns: downloads directory tied to the user, e.g. ``~/Downloads``z ~/DownloadsrBrs ruser_downloads_dirz!_MacOSDefaults.user_downloads_direrDrc@tjdS)zB:returns: pictures directory tied to the user, e.g. ``~/Pictures``z ~/PicturesrBrs ruser_pictures_dirz _MacOSDefaults.user_pictures_dirjsw!!,///rc@tjdS)z>:returns: videos directory tied to the user, e.g. ``~/Movies``z~/MoviesrBrs ruser_videos_dirz_MacOSDefaults.user_videos_dirosw!!*---rc@tjdS)z<:returns: music directory tied to the user, e.g. ``~/Music``z~/MusicrBrs ruser_music_dirz_MacOSDefaults.user_music_dirtsw!!),,,rc@tjdS)z@:returns: desktop directory tied to the user, e.g. ``~/Desktop``z ~/DesktoprBrs ruser_desktop_dirz_MacOSDefaults.user_desktop_dirysw!!+...rc@tjdS)z?:returns: bin directory tied to the user, e.g. ``~/.local/bin``z ~/.local/binrBrs r user_bin_dirz_MacOSDefaults.user_bin_dir~sw!!.111rcdS)z@:returns: bin directory shared by users, e.g. ``/usr/local/bin``z/usr/local/binrs r site_bin_dirz_MacOSDefaults.site_bin_dirs  rc@tjdS)zJ:returns: applications directory tied to the user, e.g. ``~/Applications``z~/ApplicationsrBrs ruser_applications_dirz$_MacOSDefaults.user_applications_dirsw!!"2333rcdgS)Nz /ApplicationsrRrs r_site_applications_dirsz&_MacOSDefaults._site_applications_dirss   rcl|j}|jrtj|n|dS)zH:returns: applications directory shared by users, e.g. ``/Applications``r)rWr3rr4r5)rdirss rsite_applications_dirz$_MacOSDefaults.site_applications_dirs0+(,Crzt$$$DGCrcf|tjdS)zh:returns: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``z~/Library/Caches/TemporaryItemsrrs ruser_runtime_dirz_MacOSDefaults.user_runtime_dirs)001C1CDe1f1fgggrc|jS)zG:returns: runtime directory shared by users, same as `user_runtime_dir`)r\rs rsite_runtime_dirz_MacOSDefaults.site_runtime_dirs $$r Iterator[str]c#6K|jV|jEd{VdS)z4:yield: all user and site configuration directories.N)r,r/rs riter_config_dirsz_MacOSDefaults.iter_config_dirss6""""))))))))))rc#6K|jV|jEd{VdS)z+:yield: all user and site data directories.N)rr%rs riter_data_dirsz_MacOSDefaults.iter_data_dirss6    ''''''''''rN)r r )r r)r r )r r_) __name__ __module__ __qualname____doc__propertyrr%r)r,r/r1r6r8r:r<r>r@rCrFrHrJrLrNrPrSrUrWrZr\r^rarcrRrrr r sfffXfXIIIXI"""X"$$$X$YYYXYXJJJXJ"""X""""X"WWWXWBBBXB111X1111X1000X0...X.---X-///X/222X2   X 444X4!!!X!DDDXD hhhXh%%%X%**** ((((((rr ceZdZdZdS)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)rdrerfrgrRrrrjrjs    rrj)rg __future__ros.pathrrtypingrcollections.abcr_xdgrapirpathlibr r rj__all__rRrrrss """""" )(((((( V(V(V(V(V(_V(V(V(r     Hn     r