Technician tool v0.6

Imported from the Google Drive folder 004-technician_tool/v0.6.

tests/test_sd.py

@@ -5,9 +5,12 @@ import plistlib
 
 import pytest
 
-from kota_tech.sd.disks import MAX_CARD_BYTES, Disk, parse_macos, parse_windows
+import sys
+from pathlib import Path
+
+from kota_tech.sd.disks import MAX_CARD_BYTES, Disk, Volume, parse_macos, parse_windows
 from kota_tech.sd.envfile import EnvConfig, parse_env
-from kota_tech.sd.provision import check_card, windows_format_script, write_env
+from kota_tech.sd.provision import check_card, win_format_command, write_env
 
 URL = "https://influx.kota-app.com/api/v2/write?bucket=sensorbox&org=kota"
 TOKEN = "T" * 86 + "=="          # shape of an InfluxDB token, not a real one
@@ -108,15 +111,25 @@ def test_parse_macos_excludes_system_disk():
 
 # -------------------------------------------------------- format script
 
-def test_windows_script_rechecks_disk_before_erasing(tmp_path):
+def test_elevated_helper_command(tmp_path):
     disk = Disk("5", "SDXC Card", 63_864_569_856, "SD")
-    ps = windows_format_script(disk, tmp_path / "r.json")
-    erase = ps.index("Clear-Disk")
-    for guard in ("IsSystem -or $d.IsBoot", "'MMC','SD','USB'", "-ne 63864569856"):
-        assert guard in ps and ps.index(guard) < erase
-    assert "-PartitionStyle MBR" in ps and "-FileSystem FAT32" in ps
-    assert str(32 * 1024**3) in ps                          # FAT32 partition capped at 32 GB
-    assert "NewFileSystemLabel 'KOTA'" in ps
+    prog, params, cwd = win_format_command(disk, tmp_path / "r.json")
+    assert params.startswith("-m kota_tech.sd.win_format --disk 5 --size 63864569856 --label KOTA")
+    assert (Path(cwd) / "kota_tech").is_dir()                 # helper is importable from there
+
+
+@pytest.mark.skipif(sys.platform != "win32", reason="Windows formatter")
+@pytest.mark.parametrize("disks,msg", [
+    ([], "not a USB/SD/MMC"),                                                     # disk vanished / internal
+    ([Disk("5", "SD", 1_000, "SD")], "changed since it was selected"),              # swapped card
+    ([Disk("5", "SD", 31_457_280_000, "SD", [Volume("C:\\", "NTFS", "")])], "Windows drive"),
+])
+def test_formatter_guard_refuses_before_writing(monkeypatch, disks, msg):
+    from kota_tech.sd import win_format
+    monkeypatch.setattr(win_format.win_disks, "list_disks", lambda buses: disks)
+    monkeypatch.setattr(win_format, "RawDisk", lambda *a: pytest.fail("must not open the disk for writing"))
+    with pytest.raises(win_format.FormatError, match=msg):
+        win_format.format_card(5, 31_457_280_000, "KOTA", {})
 
 
 def test_large_disks_are_not_cards():