| """Load and write canonical 0.3 records.""" | |
| from __future__ import annotations | |
| import json | |
| from pathlib import Path | |
| from typing import Any, Mapping | |
| from .canonical import canonical_bytes | |
| from .model import IntervalWorld | |
| def load_record(path: str | Path) -> dict[str, Any]: | |
| value = json.loads(Path(path).read_text(encoding="utf-8")) | |
| if not isinstance(value, dict): | |
| raise ValueError("JSON root must be an object") | |
| return value | |
| def load_world(path: str | Path) -> tuple[dict[str, Any], IntervalWorld]: | |
| record = load_record(path) | |
| return record, IntervalWorld.from_record(record) | |
| def write_canonical(path: str | Path, value: Mapping[str, Any] | list[Any]) -> None: | |
| target = Path(path) | |
| target.parent.mkdir(parents=True, exist_ok=True) | |
| target.write_bytes(canonical_bytes(value) + b"\n") | |