o Tj(@sUdZddlmZddlZddlZddlZddlmZm Z er%ddl m Z ddl m Z ddlmZer9dd lmZGd d d eZGd d d e eZedejZded<dddZd gZdS)zmacOS.) annotationsN) TYPE_CHECKINGFinal)Iterator)XDGMixin)PlatformDirsABC)Pathc@seZdZdZdRddZdSddZedRd d ZedSd d ZedTddZ edTddZ edRddZ edSddZ edRddZ edSddZedRddZedTddZedRddZedRd d!ZedRd"d#ZedRd$d%ZedRd&d'ZedRd(d)ZedRd*d+ZedRd,d-ZedRd.d/ZedRd0d1ZedRd2d3ZedRd4d5ZedRd6d7ZedRd8d9ZedRd:d;ZedRdd?Z!edRd@dAZ"edSdBdCZ#edRdDdEZ$edRdFdGZ%edRdHdIZ&dUdKdLZ'dUdMdNZ(dUdOdPZ)dQS)V_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)Nz~/Library/Application Support_append_app_name_and_versionospath expanduserselfrU/home/dinkstrade/pdmp-scanner/venv/lib/python3.10/site-packages/platformdirs/macos.py_base_user_app_support_dirsz)_MacOSDefaults._base_user_app_support_dir list[str]cC4t}r||dgng}||d|S)Nz/sharez/Library/Application Support_homebrew_prefix_join_app_name_and_versionappendrprefix path_listrrr_base_site_dirs s z_MacOSDefaults._base_site_dirscC|S)zZData directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``.rrrrr user_data_dir%z_MacOSDefaults.user_data_dircCr"Nr!rrrr_site_data_dirs*z_MacOSDefaults._site_data_dirsr cC ||jS)z`Data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``.)_first_site_dir_as_pathr(rrrrsite_data_path. z_MacOSDefaults.site_data_pathcCr*)zbConfig path shared by users. Only return the first item, even if ``multipath`` is set to ``True``.)r+_site_config_dirsrrrrsite_config_path3r-z_MacOSDefaults.site_config_pathcCr")z;Config directory tied to the user, same as `user_data_dir`.r#rrrruser_config_dir8r%z_MacOSDefaults.user_config_dircCr"r&r'rrrrr.=r)z _MacOSDefaults._site_config_dirscCr )zNCache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``.z~/Library/Cachesrrrrruser_cache_dirAz_MacOSDefaults.user_cache_dircCr)Nz /var/cachez/Library/Cachesrrrrr_site_cache_dirsFs z_MacOSDefaults._site_cache_dirscCr*)aCache 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``.)_select_site_dirsr3rrrrsite_cache_dirLr-z_MacOSDefaults.site_cache_dircCr*)zaCache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``.)r+r3rrrrsite_cache_pathQr-z_MacOSDefaults.site_cache_pathcCr")zState directory tied to the user, same as `user_data_dir` without ``$XDG_DATA_HOME``, e.g. ``~/Library/Application Support/$appname/$version``.r#rrrruser_state_dirVr%z_MacOSDefaults.user_state_dircCs|d}|||S)zState directory shared by users, the first entry of `site_data_dir` without ``$XDG_DATA_DIRS``, ignoring `multipath `.r)r!_optionally_create_directory)rrrrrsite_state_dir[s  z_MacOSDefaults.site_state_dircCr )zJLog directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``.z~/Library/Logsrrrrr user_log_dirbr2z_MacOSDefaults.user_log_dircCs |dS)zHLog directory shared by users, e.g. ``/Library/Logs/$appname/$version``.z /Library/Logs)rrrrr site_log_dirgs z_MacOSDefaults.site_log_dircC tjdS)z;Documents directory tied to the user, e.g. ``~/Documents``.z ~/Documentsrrrrrrruser_documents_dirlr-z!_MacOSDefaults.user_documents_dircCr<)z;Downloads directory tied to the user, e.g. ``~/Downloads``.z ~/Downloadsr=rrrruser_downloads_dirqr-z!_MacOSDefaults.user_downloads_dircCr<)z9Pictures directory tied to the user, e.g. ``~/Pictures``.z ~/Picturesr=rrrruser_pictures_dirvr-z _MacOSDefaults.user_pictures_dircCr<)z5Videos directory tied to the user, e.g. ``~/Movies``.z~/Moviesr=rrrruser_videos_dir{r-z_MacOSDefaults.user_videos_dircCr<)z3Music directory tied to the user, e.g. ``~/Music``.z~/Musicr=rrrruser_music_dirr-z_MacOSDefaults.user_music_dircCr<)z7Desktop directory tied to the user, e.g. ``~/Desktop``.z ~/Desktopr=rrrruser_desktop_dirr-z_MacOSDefaults.user_desktop_dircCr<)z9Projects directory tied to the user, e.g. ``~/Projects``.z ~/Projectsr=rrrruser_projects_dirr-z _MacOSDefaults.user_projects_dircCr<)z;Public share directory tied to the user, e.g. ``~/Public``.z~/Publicr=rrrruser_publicshare_dirr-z#_MacOSDefaults.user_publicshare_dircCr<)z;Templates directory tied to the user, e.g. ``~/Templates``.z ~/Templatesr=rrrruser_templates_dirr-z!_MacOSDefaults.user_templates_dircCr<)z;Fonts directory tied to the user, e.g. ``~/Library/Fonts``.z~/Library/Fontsr=rrrruser_fonts_dirr-z_MacOSDefaults.user_fonts_dircCr )zNPreference directory tied to the user, e.g. ``~/Library/Preferences/AppName``.z~/Library/Preferencesrrrrruser_preference_dirr2z"_MacOSDefaults.user_preference_dircCr<)z6Bin directory tied to the user, e.g. ``~/.local/bin``.z ~/.local/binr=rrrr user_bin_dirr-z_MacOSDefaults.user_bin_dircCsdS)z7Bin directory shared by users, e.g. ``/usr/local/bin``.z/usr/local/binrrrrr site_bin_dirsz_MacOSDefaults.site_bin_dircCr<)zAApplications directory tied to the user, e.g. ``~/Applications``.z~/Applicationsr=rrrruser_applications_dirr-z$_MacOSDefaults.user_applications_dircCsdgS)Nz /Applicationsrrrrr_site_applications_dirssz&_MacOSDefaults._site_applications_dirscCs |j}|jr tj|S|dS)z?Applications directory shared by users, e.g. ``/Applications``.r)rL multipathrpathsepjoin)rdirsrrrsite_applications_dirsz$_MacOSDefaults.site_applications_dircCr )z_Runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``.z~/Library/Caches/TemporaryItemsrrrrruser_runtime_dirr2z_MacOSDefaults.user_runtime_dircCs|jS)z>Runtime directory shared by users, same as `user_runtime_dir`.)rRrrrrsite_runtime_dirsz_MacOSDefaults.site_runtime_dir Iterator[str]cc |jV||jEdHdSr&)r0_create_as_yieldedr.rrrr_iter_config_dirsz _MacOSDefaults._iter_config_dirsccrUr&)r$rVr(rrrr_iter_data_dirsrXz_MacOSDefaults._iter_data_dirsccrUr&)r1rVr3rrrr_iter_cache_dirsrXz_MacOSDefaults._iter_cache_dirsN)r r )r r)r r )r rT)*__name__ __module__ __qualname____doc__rr!propertyr$r(r,r/r0r.r1r3r5r6r7r9r:r;r>r?r@rArBrCrDrErFrGrHrIrJrKrLrQrRrSrWrYrZrrrrr s                                    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)r[r\r]r^rrrrr`sr`a. (?P.+) # $HOMEBREW_PREFIX, such as /opt/homebrew or /usr/local /opt/python[^/]* # formula link: python, python3 or python@3.13 /Frameworks/Python\.framework # framework build /Versions/[^/]+ # interpreter version, such as 3.13 r_HOMEBREW_PYTHONr str | NonecCsttj}r |dSdS)Nr)ra fullmatchsys base_prefix)matchrrrrsr)r rb)r^ __future__ros.pathrrerdtypingrrcollections.abcr_xdgrapirpathlibr r r`compileVERBOSEra__annotations__r__all__rrrrs,     @