platform_check.py

from __future__ import annotations

import ctypes.util
import os
import shutil
import sys


REQUIRED_LIBRARIES = [
    "xcb-cursor",
]

INSTALL_HINTS = [
    ("apt", "sudo apt install libxcb-cursor0"),
    ("dnf", "sudo dnf install libxcb-cursor"),
    ("yum", "sudo yum install libxcb-cursor"),
    ("pacman", "sudo pacman -S libxcb-cursor"),
    ("zypper", "sudo zypper install libxcb-cursor0"),
]


def missing_libraries() -> list[str]:
    absent: list[str] = []
    for library in REQUIRED_LIBRARIES:
        if ctypes.util.find_library(library) is None:
            absent.append(library)
    return absent


def install_hint() -> str:
    for manager, command in INSTALL_HINTS:
        if shutil.which(manager):
            return command
    return "Install libxcb-cursor0 using your distribution package manager"


def ensure_platform_ready() -> int:
    if os.environ.get("QT_QPA_PLATFORM") == "offscreen":
        return 0
    absent = missing_libraries()
    if not absent:
        return 0
    names = ", ".join(absent)
    print("Amper could not start because required system libraries are missing.", file=sys.stderr)
    print(f"Missing: {names}", file=sys.stderr)
    print(f"Fix: {install_hint()}", file=sys.stderr)
    print("Then run: python main.py", file=sys.stderr)
    return 1