rippy/src/rippy/platform/dateiangaben.py

"""Was eine Windows-Datei über sich selbst sagt — und warum das hier zählt.

## Wozu (28.08.2026)

Rippy lädt den MakeMKV-Installer notfalls aus einer Ausweichquelle, weil
makemkv.com tagelang mit HTTP 525 antwortet. Eine Datei von woanders zu
holen und ungeprüft auszuführen wäre leichtsinnig.

Der naheliegende Schutz — die digitale Signatur — geht NICHT:

    Get-AuthenticodeSignature Setup_MakeMKV_v1.18.4.exe
    Status: NotSigned

Am 28.08.2026 an der echten Datei gemessen: **MakeMKV signiert seinen
Installer nicht.** Eine Signaturprüfung wäre also eine Prüfung, die immer
fehlschlägt — schlimmer als keine, weil sie Sicherheit vortäuscht und dann
den richtigen Weg blockiert.

Prüfbar ist die **Versions-Ressource**. An derselben Datei gemessen:

    CompanyName      GuinpinSoft inc
    FileDescription  MakeMKV installer
    FileVersion      v1.18.4
    ProductName      MakeMKV

Das ist kein Ersatz für eine Signatur — wer die Datei fälscht, kann auch die
Ressource fälschen. Aber es fängt zuverlässig ab, was hier wirklich droht:
eine Fehlerseite, ein umbenanntes Archiv, eine falsche Version, ein
abgebrochener Download. Und es sagt dem Nutzer, WAS er da bekommen hat.
"""

import os

FELDER = ("CompanyName", "FileDescription", "FileVersion", "ProductName",
          "ProductVersion")


def versionsangaben(pfad: str) -> dict:
    """Die Versions-Ressource einer Windows-Datei. Leer, wenn keine da ist.

    Wirft nicht: Eine Datei ohne Ressource ist ein gültiges Ergebnis (und
    genau das, was eine Fehlerseite mit `.exe`-Namen hätte).
    """
    if os.name != "nt" or not os.path.isfile(pfad):
        return {}
    import ctypes

    try:
        version = ctypes.WinDLL("version")
        groesse = version.GetFileVersionInfoSizeW(pfad, None)
        if not groesse:
            return {}
        puffer = ctypes.create_string_buffer(groesse)
        if not version.GetFileVersionInfoW(pfad, 0, groesse, puffer):
            return {}

        zeiger = ctypes.c_void_p()
        laenge = ctypes.c_uint()
        if not version.VerQueryValueW(puffer, r"\VarFileInfo\Translation",
                                      ctypes.byref(zeiger), ctypes.byref(laenge)):
            return {}
        paar = ctypes.cast(zeiger, ctypes.POINTER(ctypes.c_uint16))
        sprache = "%04x%04x" % (paar[0], paar[1])

        ergebnis = {}
        for feld in FELDER:
            z = ctypes.c_void_p()
            n = ctypes.c_uint()
            pfad_im_block = "\\StringFileInfo\\%s\\%s" % (sprache, feld)
            if version.VerQueryValueW(puffer, pfad_im_block,
                                      ctypes.byref(z), ctypes.byref(n)) and n.value:
                ergebnis[feld] = ctypes.wstring_at(z.value, n.value - 1).strip()
        return ergebnis
    except (AttributeError, OSError, ValueError):
        return {}


def ist_programm(pfad: str) -> bool:
    """Fängt die Datei mit `MZ` an? (Das tut jedes Windows-Programm.)

    Der billigste und wirksamste Test gegen das, was wirklich passiert: eine
    HTML-Fehlerseite, die unter dem Namen `Setup_MakeMKV_v1.18.4.exe`
    gespeichert wurde.
    """
    try:
        with open(pfad, "rb") as f:
            return f.read(2) == b"MZ"
    except OSError:
        return False


# ── Die Prüfung als reine Funktion ──────────────────────────────────────
def passt(angaben: dict, firma: str = "", produkt: str = "",
          version: str = "") -> tuple:
    """Passen die Angaben zu dem, was erwartet wird? (ja/nein, Begründung)

    Reine Funktion — damit jeder Fall prüfbar ist, ohne eine Datei zu haben.
    Leere Erwartungen werden nicht geprüft: Wer nichts fordert, bekommt kein
    Urteil vorgesetzt.
    """
    if not angaben:
        return False, "Die Datei hat keine Versionsangaben — das ist kein " \
                      "Installationsprogramm, sondern vermutlich eine Fehlerseite."

    gefunden_firma = angaben.get("CompanyName", "")
    if firma and firma.lower() not in gefunden_firma.lower():
        return False, ("Die Datei stammt laut ihren eigenen Angaben von "
                       "%r, erwartet war %r." % (gefunden_firma or "niemandem", firma))

    text = " ".join(angaben.get(f, "") for f in
                    ("ProductName", "FileDescription")).lower()
    if produkt and produkt.lower() not in text:
        return False, ("Die Datei bezeichnet sich als %r, erwartet war %r."
                       % (text.strip() or "nichts", produkt))

    if version:
        gefunden = (angaben.get("FileVersion") or
                    angaben.get("ProductVersion") or "").lstrip("vV")
        if gefunden and not gefunden.startswith(version):
            return False, ("Die Datei ist Fassung %s, erwartet war %s."
                           % (gefunden, version))

    return True, "%s %s" % (angaben.get("ProductName", "?"),
                            angaben.get("FileVersion", "?"))