kiutils_kicad 0.1.0

KiCad typed AST and file codecs built on kiutils_sexpr
Documentation

Typed KiCad file readers built on top of lossless S-expression CST parsing.

Scope (v1):

  • .kicad_pcb
  • .kicad_mod
  • .kicad_sch
  • .kicad_sym
  • fp-lib-table
  • sym-lib-table
  • .kicad_dru
  • .kicad_pro
  • .kicad_wks

Default write mode is lossless: parse -> modify typed AST -> write without regenerating unrelated formatting.

Policy notes:

  • AST *_count fields are debug-oriented convenience and are not stability guarantees.
  • Unknown token diagnostics are primarily developer-facing; end-user tooling should summarize.
  • Version compatibility checks run post-parse by default to maximize lossless ingestion.
  • .kicad_dru rule conditions are preserved as strings in v1.