Files
FacereDataset/tools/epro2/kicad/_sexpr_reader.py
Knowit 9213429a57 tools/epro2/kicad: Phase-1 EPRO2 → KiCad schematic exporter
写第一版 EPRO2 → .kicad_sch 转换:把 SCH_PAGE Document 的 wires +
COMPONENT placements + TEXT 输出到一个可被 KiCad 7+ 打开的 sch 文件。
不含 symbol 主体(lib_symbols 留空 stub),所以 KiCad 里组件会渲染
成红色 "?" 占位,但布线 + 位置 + Designator/Value 属性都正确。完整
symbol 库导出留 Phase 2。

模块结构:
  tools/epro2/kicad/sexpr.py        手写 S-expr emitter,Sym 标记裸符号,
                                    str 自动加引号 + 转义;float 去尾零;
                                    bool→yes/no;NaN/Inf 主动报错
  tools/epro2/kicad/_sexpr_reader.py  极简 S-expr parser,仅给 round-trip
                                    测试用(非完整 KiCad reader)
  tools/epro2/kicad/sch_writer.py   write_sch_page(doc) → str;处理:
                                      LINE  → (wire (pts ...) ...)
                                      COMPONENT → (symbol (lib_id facere:<partId>)
                                                  (at x y rot) (property Reference ...) ...)
                                      TEXT  → (text "..." (at ...))
                                    单位 mil → mm × 0.0254;零长 wire 跳过
  tools/epro2/kicad/__main__.py     CLI: --doc <uuid> | --all-sch

ESP-VoCat 验证(python -m tools.epro2.kicad <project> --all-sch):
  9 SCH_PAGE 全部转换成功
  P1_408c9f4f.kicad_sch    wires=  6  symbols= 10  text=  0  skipped= 2  (370 lines)
  P1_ee409917.kicad_sch    wires= 20  symbols= 14  text=  0  skipped= 3
  P1_54743d77.kicad_sch    wires= 42  symbols= 30  text=  3
  Overview_dc13d6d2.kicad_sch wires=  0  symbols=  1  text= 34   (说明页)
  MCU_510cff33.kicad_sch   wires= 91  symbols= 86  text=  9
  Interface_b336a7c7.kicad_sch wires= 99  symbols= 95  text=  6
  P1_5c38f45b.kicad_sch    wires=179  symbols= 86  text=  9
  P1_45092758.kicad_sch    wires=187  symbols=138  text= 10  (主图)
  codec_0b0163fa.kicad_sch wires=190  symbols=112  text= 10

输出落在 data/processed/kicad_sch/<filename>.kicad_sch(gitignore 内,
可重新生成;不入库)。

测试:6 个 sexpr 测 + 6 个 sch_writer 测,含 round-trip parse 验证。
parser/relations/project_relations 的旧 21 个不动,合计 **33/33 通过**。

下一步:
1. Phase 2 — symbol library 导出 (.kicad_sym),把 SYMBOL doc 的 PIN/RECT/
   TEXT primitives 转 KiCad symbol 主体;填 lib_symbols 块让组件渲染
   出真正的 schematic 符号
2. footprint library + .kicad_pcb 导出
3. 用 KiCad CLI (kicad-cli sch erc) 跑 ERC 校验

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-28 22:29:15 +08:00

89 lines
2.4 KiB
Python

"""Tiny S-expression parser used by tests for round-trip validation.
Not a full KiCad reader — just enough to confirm our writer output is
syntactically valid Lisp-flavored S-expr (balanced parens, quoted strings,
numbers, symbols).
"""
from __future__ import annotations
from typing import Iterator
def tokens(src: str) -> Iterator[str]:
i, n = 0, len(src)
while i < n:
c = src[i]
if c.isspace():
i += 1
continue
if c == "(":
yield "("
i += 1
continue
if c == ")":
yield ")"
i += 1
continue
if c == '"':
j = i + 1
buf = []
while j < n:
ch = src[j]
if ch == "\\" and j + 1 < n:
nxt = src[j + 1]
buf.append({"\\": "\\", '"': '"', "n": "\n", "t": "\t"}.get(nxt, nxt))
j += 2
continue
if ch == '"':
break
buf.append(ch)
j += 1
if j >= n:
raise SyntaxError("unterminated string")
yield '"' + "".join(buf) + '"'
i = j + 1
continue
# bare token until whitespace or paren
j = i
while j < n and not src[j].isspace() and src[j] not in "()":
j += 1
yield src[i:j]
i = j
def parse(src: str):
it = iter(tokens(src))
def _read(tok):
if tok == "(":
out = []
while True:
try:
nxt = next(it)
except StopIteration:
raise SyntaxError("unterminated list")
if nxt == ")":
return out
out.append(_read(nxt))
if tok == ")":
raise SyntaxError("unexpected )")
if tok.startswith('"') and tok.endswith('"'):
return tok[1:-1]
try:
return int(tok)
except ValueError:
try:
return float(tok)
except ValueError:
return tok # symbol
try:
first = next(it)
except StopIteration:
raise SyntaxError("empty input")
val = _read(first)
# Expect EOF
for extra in it:
raise SyntaxError(f"unexpected trailing token: {extra!r}")
return val