Beta Shell v2.0

File Manager

~ /usr/local/python-3.10/lib/python3.10/site-packages/platformdirs

Name	Size	Perms	Modified	Actions
[ .. / .. ]
__init__.py	12.56 KB	-rw-r--r--	2023-02-03 07:20:33	Edit Del
__main__.py	1.14 KB	-rw-r--r--	2023-02-03 07:20:33	Edit Del
__pycache__	-	drwxr-xr-x	2023-02-03 07:20:33	Del
android.py	3.97 KB	-rw-r--r--	2023-02-03 07:20:33	Edit Del
api.py	4.79 KB	-rw-r--r--	2023-02-03 07:20:33	Edit Del
macos.py	2.59 KB	-rw-r--r--	2023-02-03 07:20:33	Edit Del
py.typed	0 B	-rw-r--r--	2023-02-03 07:20:33	Edit Del
unix.py	6.75 KB	-rw-r--r--	2023-02-03 07:20:33	Edit Del
version.py	160 B	-rw-r--r--	2023-02-03 07:20:33	Edit Del
windows.py	6.44 KB	-rw-r--r--	2023-02-03 07:20:33	Edit Del

Editing: macos.py (2.59 KB)

from __future__ import annotations

import os

from .api import PlatformDirsABC


class MacOS(PlatformDirsABC):
    """
    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>` and
    `version <platformdirs.api.PlatformDirsABC.version>`.
    """

    @property
    def user_data_dir(self) -> str:
        """:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``"""
        return self._append_app_name_and_version(os.path.expanduser("~/Library/Application Support/"))

    @property
    def site_data_dir(self) -> str:
        """:return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``"""
        return self._append_app_name_and_version("/Library/Application Support")

    @property
    def user_config_dir(self) -> str:
        """:return: config directory tied to the user, e.g. ``~/Library/Preferences/$appname/$version``"""
        return self._append_app_name_and_version(os.path.expanduser("~/Library/Preferences/"))

    @property
    def site_config_dir(self) -> str:
        """:return: config directory shared by the users, e.g. ``/Library/Preferences/$appname``"""
        return self._append_app_name_and_version("/Library/Preferences")

    @property
    def user_cache_dir(self) -> str:
        """:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``"""
        return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches"))

    @property
    def user_state_dir(self) -> str:
        """:return: state directory tied to the user, same as `user_data_dir`"""
        return self.user_data_dir

    @property
    def user_log_dir(self) -> str:
        """:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``"""
        return self._append_app_name_and_version(os.path.expanduser("~/Library/Logs"))

    @property
    def user_documents_dir(self) -> str:
        """:return: documents directory tied to the user, e.g. ``~/Documents``"""
        return os.path.expanduser("~/Documents")

    @property
    def user_runtime_dir(self) -> str:
        """:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``"""
        return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches/TemporaryItems"))


__all__ = [
    "MacOS",
]