]> danix's work - publisher.git/commitdiff
fix: remove unused field import, document orphan-discard contract in save_taxonomy
authorDanilo M. <redacted>
Sun, 3 May 2026 08:00:51 +0000 (10:00 +0200)
committerDanilo M. <redacted>
Sun, 3 May 2026 08:00:51 +0000 (10:00 +0200)
core/taxonomy.py

index 9d71a915b665a452922a20f41fc03966b8d11ea0..8aee0aac9b5d664f3cf9ab25262b82b5ffad5ba0 100644 (file)
@@ -1,5 +1,5 @@
 from __future__ import annotations
-from dataclasses import dataclass, field
+from dataclasses import dataclass
 from pathlib import Path
 
 @dataclass
@@ -18,6 +18,7 @@ def load_taxonomy(it_path: Path, en_path: Path) -> TaxonomyModel:
     return TaxonomyModel(it_to_en=it_to_en, orphans_it=orphans_it, orphans_en=orphans_en)
 
 def save_taxonomy(model: TaxonomyModel, it_path: Path, en_path: Path) -> None:
+    """Write paired terms to disk, sorted by IT term. Orphans are NOT written — callers must resolve them first."""
     pairs = sorted(model.it_to_en.items(), key=lambda x: x[0])
     it_path.write_text("\n".join(k for k, _ in pairs) + "\n")
     en_path.write_text("\n".join(v for _, v in pairs) + "\n")