feat(batch): upfront target validation (v0.2.2)

LOG.md

@@ -1,5 +1,10 @@
 # LOG
 
+## 2026-06-09 — v0.2.2 — validazione upfront target in `batch`
+
+- `batch`: check immediato che `--to` sia un target valido per `--from`; fallisce prima di leggere il CSV con messaggio chiaro (`Run 'openverto targets <from>'`).
+- 2 nuovi test offline (`test_batch_rejects_invalid_target`, `test_batch_accepts_valid_target_combination`).
+
 ## 2026-06-09 — docs: disclaimer non-affiliazione + nota Z/M planimetrica
 
 - Spunti da `sag1687/geobridge` (plugin QGIS per lo stesso servizio IGM): aggiunti due punti che mancavano.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openverto"
-version = "0.2.1"
+version = "0.2.2"
 description = "Python CLI and library for the official IGM Verto Online coordinate transforms between Italian reference systems"
 readme = "README.md"
 authors = [

src/openverto/cli.py

@@ -396,6 +396,16 @@ def batch(
     """
     in_e = _parse_epsg(from_epsg)
     out_e = _parse_epsg(to_epsg)
+    try:
+        valid_targets = lib_targets(in_e, with_live=False)
+    except KeyError:
+        _die(f"EPSG {in_e} is not IGM-supported; run 'openverto systems'", EXIT_NOT_FOUND)
+    if out_e not in {r["epsg"] for r in valid_targets}:
+        _die(
+            f"EPSG {out_e} is not a valid target for EPSG {in_e}. "
+            f"Run 'openverto targets {in_e}' to see valid options.",
+            EXIT_USAGE,
+        )
     if fmt not in ("csv", "geojson"):
         _die(f"--format must be 'csv' or 'geojson', got {fmt!r}", EXIT_USAGE)
     try:

tests/test_offline.py

@@ -159,3 +159,45 @@ def test_resolve_column_by_alias_and_missing():
     assert resolve_column(header, "nord", ["n"]) == 2  # explicit name
     with pytest.raises(ValueError):
         resolve_column(header, "manca", E_ALIASES)
+
+
+def test_batch_rejects_invalid_target(tmp_path):
+    """batch must fail upfront when --to is not a valid target for --from."""
+    from typer.testing import CliRunner
+
+    from openverto.cli import app
+
+    p = tmp_path / "coords.csv"
+    p.write_text("lon,lat\n12.0,41.0\n", encoding="utf-8")
+
+    runner = CliRunner()
+    result = runner.invoke(app, ["batch", str(p), "--from", "23033", "--to", "32633"])
+    normalized = " ".join(result.output.split())
+    assert result.exit_code != 0
+    assert "32633" in normalized
+    assert "23033" in normalized
+    assert "targets 23033" in normalized
+
+
+def test_batch_accepts_valid_target_combination(tmp_path, monkeypatch):
+    """batch must pass the target check for a known-valid from/to pair."""
+    import openverto.transform as convmod
+
+    def fake_post(body):
+        return {
+            "stato": "successo",
+            "coordinate": [{"e": c["e"] + 0.001, "n": c["n"] + 0.002} for c in body["coordinate"]],
+        }
+
+    monkeypatch.setattr(convmod, "post", fake_post)
+
+    from typer.testing import CliRunner
+
+    from openverto.cli import app
+
+    p = tmp_path / "coords.csv"
+    p.write_text("lon,lat\n290000.0,4640000.0\n", encoding="utf-8")
+
+    runner = CliRunner()
+    result = runner.invoke(app, ["batch", str(p), "--from", "23033", "--to", "6706"])
+    assert result.exit_code == 0