Files
kicad-mcp-server/tests/test_add_wire_sub_sheet.py
Matthew Runo e66c13361b fix(add_schematic_wire): support hierarchical sub-sheets (#170)
WireManager.add_wire and add_polyline_wire bailed out with
"No sheet_instances section found in schematic" when called on a
hierarchical sub-sheet — that block only exists in the root .kicad_sch.
The handler in kicad_interface.py converted the False return into a
flat "Failed to add wire" message, leaving callers with no diagnostic.

Apply the same fallback that WireManager.add_label has used since the
hierarchical-design support: when (sheet_instances ...) is absent,
append the new (wire ...) item at the end of the outer (kicad_sch ...)
form.

Adds tests/test_add_wire_sub_sheet.py with 6 regression tests covering
both add_wire and add_polyline_wire on a sub-sheet, including paren
balance, sexpdata round-trip, and segment count for an N-point polyline.
2026-05-18 14:05:18 -04:00

136 lines
4.5 KiB
Python

"""
Regression tests for WireManager.add_wire / add_polyline_wire on hierarchical
sub-sheets.
Sub-sheets do not carry a (sheet_instances ...) block — that block is only
emitted on the root .kicad_sch in a hierarchical design. Before the fix, both
methods bailed out with "No sheet_instances section found in schematic" and
returned False, so users saw "Failed to add wire" on every call into a child
sheet.
"""
import sys
from pathlib import Path
from typing import Any
import pytest
sys.path.insert(0, str(Path(__file__).parent.parent / "python"))
# Minimal sub-sheet content: same outer (kicad_sch ...) form as a root sheet
# but WITHOUT (sheet_instances ...).
SUB_SHEET_NO_SHEET_INSTANCES = """(kicad_sch
\t(version 20260306)
\t(generator "eeschema")
\t(generator_version "10.0")
\t(uuid "bbbb2222-2222-2222-2222-bbbbbbbbbbbb")
\t(paper "A4")
\t(lib_symbols)
)
"""
def _write_sub_sheet(tmp_path: Path) -> Path:
sch = tmp_path / "child.kicad_sch"
sch.write_text(SUB_SHEET_NO_SHEET_INSTANCES, encoding="utf-8")
return sch
@pytest.mark.unit
class TestAddWireSubSheet:
"""WireManager.add_wire must succeed on hierarchical sub-sheets."""
def setup_method(self) -> None:
from commands.wire_manager import WireManager
self.WireManager = WireManager
def test_add_wire_succeeds_on_sub_sheet(self, tmp_path: Any) -> None:
sch = _write_sub_sheet(tmp_path)
ok = self.WireManager.add_wire(sch, [40.0, 40.0], [40.0, 50.0])
assert ok is True
content = sch.read_text(encoding="utf-8")
# The sexpdata writer emits the wire form somewhere in the file.
assert "wire" in content
assert "40.0" in content or "40 " in content
def test_add_wire_keeps_outer_form_balanced_on_sub_sheet(self, tmp_path: Any) -> None:
sch = _write_sub_sheet(tmp_path)
self.WireManager.add_wire(sch, [10.0, 10.0], [10.0, 20.0])
content = sch.read_text(encoding="utf-8")
assert content.count("(") == content.count(
")"
), "Inserting into a sub-sheet must keep parens balanced"
import sexpdata
parsed = sexpdata.loads(content)
assert parsed[0] == sexpdata.Symbol("kicad_sch")
def test_add_wire_writes_endpoints_on_sub_sheet(self, tmp_path: Any) -> None:
"""The new wire must round-trip through sexpdata with the requested endpoints."""
import sexpdata
sch = _write_sub_sheet(tmp_path)
self.WireManager.add_wire(sch, [12.5, 22.5], [42.5, 22.5])
parsed = sexpdata.loads(sch.read_text(encoding="utf-8"))
wires = [
item
for item in parsed[1:]
if isinstance(item, list) and len(item) > 0 and item[0] == sexpdata.Symbol("wire")
]
assert wires, "expected at least one (wire ...) item at top level after insert"
# Find xy points among the wire's children
wire_text = sexpdata.dumps(wires[0])
assert "12.5" in wire_text and "22.5" in wire_text and "42.5" in wire_text
@pytest.mark.unit
class TestAddPolylineWireSubSheet:
"""WireManager.add_polyline_wire must succeed on hierarchical sub-sheets."""
def setup_method(self) -> None:
from commands.wire_manager import WireManager
self.WireManager = WireManager
def test_add_polyline_wire_succeeds_on_sub_sheet(self, tmp_path: Any) -> None:
sch = _write_sub_sheet(tmp_path)
ok = self.WireManager.add_polyline_wire(sch, [[10.0, 10.0], [20.0, 10.0], [20.0, 30.0]])
assert ok is True
def test_add_polyline_wire_writes_n_minus_1_segments(self, tmp_path: Any) -> None:
"""A 4-point polyline must insert 3 (wire ...) segments into the file."""
import sexpdata
sch = _write_sub_sheet(tmp_path)
self.WireManager.add_polyline_wire(
sch, [[0.0, 0.0], [10.0, 0.0], [10.0, 10.0], [20.0, 10.0]]
)
parsed = sexpdata.loads(sch.read_text(encoding="utf-8"))
wires = [
item
for item in parsed[1:]
if isinstance(item, list) and len(item) > 0 and item[0] == sexpdata.Symbol("wire")
]
assert len(wires) == 3, f"expected 3 wire segments, got {len(wires)}"
def test_add_polyline_wire_keeps_outer_form_balanced_on_sub_sheet(self, tmp_path: Any) -> None:
sch = _write_sub_sheet(tmp_path)
self.WireManager.add_polyline_wire(sch, [[0.0, 0.0], [10.0, 0.0], [10.0, 10.0]])
content = sch.read_text(encoding="utf-8")
assert content.count("(") == content.count(")")