Loading files
This file is pinned to the selected release. Download the original to open it in your design tool.
ecdbde7d0This file is pinned to the selected release. Download the original to open it in your design tool.
"""Tests for :mod:`akcli.drivers.kicad_cli` — optional ERC wrapper (SPEC §3.7).
``kicad-cli`` is an **optional** secondary verifier; the primary gate is the pure
Python :mod:`..writers.connectivity`. The behavioural tests therefore ``skipif`` the
tool is not installed (the dev/CI mac has no KiCad), while the *graceful-degradation*
tests — that absence is non-fatal — run everywhere.
"""
from __future__ import annotations
import shutil
from pathlib import Path
import pytest
from akcli.drivers import kicad_cli
FIX = Path(__file__).parent / "fixtures" / "kicad"
V8 = FIX / "board_v8.kicad_sch"
_HAVE = kicad_cli.find() is not None
needs_cli = pytest.mark.skipif(not _HAVE, reason="kicad-cli not installed")
def _force_absent(monkeypatch):
"""Blind every rung of the discovery ladder."""
monkeypatch.delenv("KICAD_CLI", raising=False)
monkeypatch.setattr(shutil, "which", lambda _name: None)
monkeypatch.setattr(kicad_cli, "_FALLBACKS", ())
monkeypatch.setattr(kicad_cli, "_WIN_GLOB", "/nonexistent/*/kicad-cli")
# --------------------------------------------------------------------------- #
# graceful degradation (runs with or without kicad-cli)
# --------------------------------------------------------------------------- #
def test_available_matches_find():
assert isinstance(kicad_cli.available(), bool)
assert kicad_cli.available() == (kicad_cli.find() is not None)
def test_find_env_override_wins(monkeypatch, tmp_path):
stub = tmp_path / "kicad-cli"
stub.write_text("#!/bin/sh\n")
monkeypatch.setenv("KICAD_CLI", str(stub))
assert kicad_cli.find() == str(stub)
# env set but pointing nowhere: explicit None, never a silent fallback
monkeypatch.setenv("KICAD_CLI", str(tmp_path / "missing"))
assert kicad_cli.find() is None
def test_find_fallback_rung(monkeypatch, tmp_path):
_force_absent(monkeypatch)
bundle = tmp_path / "bundled-kicad-cli"
bundle.write_text("")
monkeypatch.setattr(kicad_cli, "_FALLBACKS", (str(bundle),))
assert kicad_cli.find() == str(bundle)
def test_windows_glob_prefers_newest_version():
key = kicad_cli._version_key
paths = [r"C:\Program Files\KiCad\9.0\bin\kicad-cli.exe",
r"C:\Program Files\KiCad\10.0\bin\kicad-cli.exe"]
assert max(paths, key=key).startswith(r"C:\Program Files\KiCad\10.0")
def test_absent_tool_is_non_fatal(monkeypatch):
# Force "tool absent" and assert every entry point degrades to None (no raise).
_force_absent(monkeypatch)
assert kicad_cli.available() is False
assert kicad_cli.version() is None
assert kicad_cli.erc(str(V8)) is None
assert kicad_cli.netlist(str(V8)) is None
def test_parse_version_helper():
assert kicad_cli._parse_version("8.0.4") == (8, 0, 4)
assert kicad_cli._parse_version("kicad-cli 7.0.11+foo") == (7, 0, 11)
assert kicad_cli._parse_version("no version here") is None
# --------------------------------------------------------------------------- #
# real kicad-cli (skipped when not installed)
# --------------------------------------------------------------------------- #
@needs_cli
def test_version_when_installed():
v = kicad_cli.version()
assert v is not None and isinstance(v[0], int)
@needs_cli
def test_erc_when_installed():
rep = kicad_cli.erc(str(V8))
assert rep is None or isinstance(rep, dict)
if isinstance(rep, dict):
assert "exit_code" in rep
@needs_cli
def test_netlist_when_installed():
rep = kicad_cli.netlist(str(V8))
assert rep is None or isinstance(rep, dict)