Diff gains a type_events axis keyed by (script type, event). The tracker lists each type's original events (vftable list, or the nearest class list up the constructor chain for Piklib 6.1) and where the emulator names them: the type's class, Variable.java or other engine code. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
68 lines
1.8 KiB
Python
68 lines
1.8 KiB
Python
"""Loading and light typed access to an engine-surface snapshot.json."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
from dataclasses import dataclass
|
|
from typing import Any
|
|
|
|
|
|
@dataclass
|
|
class Snapshot:
|
|
"""Thin wrapper over a parsed snapshot.json. Axes are returned as plain lists of dicts so
|
|
they round-trip cleanly to JSON; the diff engine works directly on those records."""
|
|
|
|
raw: dict[str, Any]
|
|
|
|
@classmethod
|
|
def load(cls, path: str) -> "Snapshot":
|
|
with open(path, "r", encoding="utf-8") as fh:
|
|
return cls(json.load(fh))
|
|
|
|
@property
|
|
def binary(self) -> dict[str, Any]:
|
|
return self.raw.get("binary", {})
|
|
|
|
@property
|
|
def types(self) -> list[dict]:
|
|
return self.raw.get("types", [])
|
|
|
|
@property
|
|
def methods(self) -> list[dict]:
|
|
return self.raw.get("methods", [])
|
|
|
|
@property
|
|
def events(self) -> list[dict]:
|
|
return self.raw.get("events", [])
|
|
|
|
@property
|
|
def type_events(self) -> list[dict]:
|
|
"""Events per script type, read through each type's own vftable (schema 6)."""
|
|
return self.raw.get("type_events", [])
|
|
|
|
@property
|
|
def fields(self) -> list[dict]:
|
|
return self.raw.get("fields", [])
|
|
|
|
@property
|
|
def struct_layout(self) -> list[dict]:
|
|
return self.raw.get("struct_layout", [])
|
|
|
|
@property
|
|
def method_dispatch(self) -> list[dict]:
|
|
return self.raw.get("method_dispatch", [])
|
|
|
|
@property
|
|
def method_inheritance(self) -> list[dict]:
|
|
return self.raw.get("method_inheritance", [])
|
|
|
|
@property
|
|
def field_inheritance(self) -> list[dict]:
|
|
return self.raw.get("field_inheritance", [])
|
|
|
|
@property
|
|
def label(self) -> str:
|
|
b = self.binary
|
|
return "{0} [{1}/{2}]".format(
|
|
b.get("name", "?"), b.get("engine", "?"), b.get("compiler", "?"))
|