Files
linuxcncWebWASM/scripts/generate_python_api_report.py

64 lines
3.2 KiB
Python

#!/usr/bin/env python3
"""Generate deterministic P5-02 Python compatibility API evidence."""
from __future__ import annotations
import argparse
import hashlib
import json
import subprocess
from pathlib import Path
from typing import Any
OUTPUTS = (Path("web/worker/python-bridge.mjs"), Path("web/worker/test_python_bridge.mjs"), Path("web/worker/test_python_session.mjs"), Path("python-runtime/compat.mjs"))
def canonical(value: Any) -> str:
return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"))
def sha256(path: Path) -> str:
return hashlib.sha256(path.read_bytes()).hexdigest()
def run(root: Path, command: list[str]) -> dict[str, Any]:
result = subprocess.run(command, cwd=root, stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=False)
return {"status": "verified" if result.returncode == 0 else "blocked", "command": " ".join(command), "returncode": result.returncode, "stdout": result.stdout.decode("utf-8", errors="replace")[-3000:], "stderr": result.stderr.decode("utf-8", errors="replace")[-2000:]}
def generate(root: Path, report_path: Path) -> dict[str, Any]:
bridge = run(root, ["node", "web/worker/test_python_bridge.mjs"])
session = run(root, ["node", "web/worker/test_python_session.mjs"])
report: dict[str, Any] = {
"schema": "python-api-report.v1",
"task_id": "P5-02",
"context_id": "linuxcnc-2.10.0-pre0-wasm-m1-py-c1",
"status": "verified" if bridge["status"] == "verified" and session["status"] == "verified" else "blocked",
"apis": {"linuxcnc": ["command", "stat", "error"], "hal": ["component", "pin", "param", "signal", "thread"], "INI": ["find", "findall", "sections"], "tool": ["get", "set"], "parameter": ["get", "set"]},
"errors": ["invalid_module", "invalid_symbol", "invalid_argument", "source_limit", "call_limit", "clock_regression", "host_capability_denied", "ini_shape", "tool_number", "parameter_name"],
"state": {"checkpoint": True, "state_hash": "fnv1a64 bridge imports/calls/api state", "logical_clock": True},
"bridge": bridge,
"session": session,
"outputs": [{"path": path.as_posix(), "bytes": (root / path).stat().st_size, "sha256": sha256(root / path)} for path in OUTPUTS],
"known_boundaries": ["remap/filter/VCP callback lifecycle is P5-03", "Pyodide artifact remains pinned by P5-01"],
}
report["report_sha256"] = hashlib.sha256(canonical(report).encode("utf-8")).hexdigest()
report_path.parent.mkdir(parents=True, exist_ok=True)
report_path.write_text(json.dumps(report, ensure_ascii=False, sort_keys=True, indent=2) + "\n", encoding="utf-8")
return report
def main() -> int:
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--repo-root", type=Path, default=Path(__file__).resolve().parents[1])
parser.add_argument("--report", type=Path, default=Path("coverage/python-api.report.json"))
args = parser.parse_args()
report = generate(args.repo_root.resolve(), args.repo_root.resolve() / args.report)
print(f"python_api={report['status']} bridge={report['bridge']['status']} session={report['session']['status']}")
return 0 if report["status"] == "verified" else 1
if __name__ == "__main__":
raise SystemExit(main())