feat: catalog JSONL load/save/append

tests/test_catalog.py

@@ -92,3 +92,62 @@ def test_record_from_dict_rejects_missing_required_field():
     del data["title"]
     with pytest.raises(CatalogError):
         record_from_dict(data)
+
+
+from hef.catalog import load_catalog, save_catalog, append_record
+
+
+def test_save_then_load_round_trip(tmp_path):
+    path = tmp_path / "library.jsonl"
+    records = [make_record(id="a"), make_record(id="b", mode="audio")]
+    save_catalog(records, path)
+    loaded = load_catalog(path)
+    assert loaded == records
+
+
+def test_load_skips_blank_lines(tmp_path):
+    path = tmp_path / "library.jsonl"
+    save_catalog([make_record(id="a")], path)
+    with path.open("a", encoding="utf-8") as fh:
+        fh.write("\n   \n")
+    loaded = load_catalog(path)
+    assert len(loaded) == 1
+
+
+def test_load_empty_file_returns_empty_list(tmp_path):
+    path = tmp_path / "library.jsonl"
+    path.write_text("", encoding="utf-8")
+    assert load_catalog(path) == []
+
+
+def test_load_invalid_json_raises(tmp_path):
+    path = tmp_path / "library.jsonl"
+    path.write_text("{not json}\n", encoding="utf-8")
+    with pytest.raises(CatalogError):
+        load_catalog(path)
+
+
+def test_load_validates_records(tmp_path):
+    path = tmp_path / "library.jsonl"
+    save_catalog([make_record(id="a")], path)
+    import json
+    bad = record_to_dict(make_record(id="bad"))
+    bad["left"] = 9
+    with path.open("a", encoding="utf-8") as fh:
+        fh.write(json.dumps(bad) + "\n")
+    with pytest.raises(CatalogError):
+        load_catalog(path)
+
+
+def test_append_record(tmp_path):
+    path = tmp_path / "library.jsonl"
+    save_catalog([make_record(id="a")], path)
+    append_record(make_record(id="b"), path)
+    loaded = load_catalog(path)
+    assert [r.id for r in loaded] == ["a", "b"]
+
+
+def test_save_rejects_invalid_record(tmp_path):
+    path = tmp_path / "library.jsonl"
+    with pytest.raises(CatalogError):
+        save_catalog([make_record(mode="hologram")], path)