66 lines
2.3 KiB
Python
66 lines
2.3 KiB
Python
"""为未覆盖的 E-AC-3 JOC/EMDF 变体生成结构化错误和维修报告。"""
|
|
import hashlib
|
|
import json
|
|
from pathlib import Path
|
|
|
|
|
|
def bytes_descriptor(data):
|
|
"""返回足以识别载荷、但不会复制整段载荷的摘要。"""
|
|
raw = bytes(data)
|
|
return {
|
|
"bytes": len(raw),
|
|
"sha256": hashlib.sha256(raw).hexdigest(),
|
|
"prefix_hex": raw[:32].hex(),
|
|
"suffix_hex": raw[-16:].hex() if raw else "",
|
|
}
|
|
|
|
|
|
class UnsupportedVariantError(ValueError):
|
|
"""表示输入结构有效或疑似有效,但当前解析器没有覆盖该变体。"""
|
|
|
|
def __init__(self, stage, variant, message, *, frame=None, details=None):
|
|
self.stage = str(stage)
|
|
self.variant = str(variant)
|
|
self.message = str(message)
|
|
self.frame = frame
|
|
self.details = dict(details or {})
|
|
super().__init__(self.__str__())
|
|
|
|
def add_context(self, *, frame=None, details=None):
|
|
if self.frame is None and frame is not None:
|
|
self.frame = int(frame)
|
|
if details:
|
|
for key, value in details.items():
|
|
self.details.setdefault(key, value)
|
|
self.args = (self.__str__(),)
|
|
return self
|
|
|
|
def to_dict(self):
|
|
return {
|
|
"report_schema": 1,
|
|
"error": "unsupported_variant",
|
|
"stage": self.stage,
|
|
"variant": self.variant,
|
|
"frame": self.frame,
|
|
"message": self.message,
|
|
"details": self.details,
|
|
}
|
|
|
|
def __str__(self):
|
|
where = f" frame={self.frame}" if self.frame is not None else ""
|
|
detail = json.dumps(self.details, ensure_ascii=False, separators=(",", ":"))
|
|
return f"[{self.stage}/{self.variant}]{where} {self.message}; details={detail}"
|
|
|
|
|
|
def write_variant_report(path, error, *, input_path=None, output_path=None):
|
|
"""将变体错误写成可交给后续维修工具的 JSON。"""
|
|
report = error.to_dict()
|
|
if input_path is not None:
|
|
report["input"] = str(Path(input_path))
|
|
if output_path is not None:
|
|
report["requested_output"] = str(Path(output_path))
|
|
target = Path(path)
|
|
target.parent.mkdir(parents=True, exist_ok=True)
|
|
target.write_text(json.dumps(report, ensure_ascii=False, indent=2), encoding="utf-8")
|
|
return target
|