sexp

Skill do pracy z formatami KiCad (PCB, footprint, schemat, netlist) poprzez wydajny parser S-expression napisany w Zig. Moduł udostępnia typizowane modele KiCad i narzędzia do tokenizacji, parsowania oraz formatowania, dostępne z poziomu Pythona. Idealne do automatyzacji importu i eksportu projektów elektronicznych, synchronizacji layoutu oraz przetwarzania danych KiCad w swoich skryptach.

1. Zainstaluj moduł pyzig_sexp jako część pakietu faebryk zawierającego rozszerzenie Pythona. Moduł jest dostępny w src/faebryk/core/zig/gen/sexp/ jako wygenerowane stub-y typów.

2. Zaimportuj wygodny wrapper z biblioteki faebryk: from faebryk.libs.kicad.fileformats import kicad. Ten moduł obsługuje cache'owanie i udostępnia interfejs loads oraz dumps.

3. Wczytaj plik KiCad za pomocą kicad.loads(), przekazując typ pliku (np. kicad.pcb.PcbFile) i ścieżkę do pliku: pcb = kicad.loads(kicad.pcb.PcbFile, Path("board.kicad_pcb")).

4. Pracuj z wczytanym obiektem — możesz go modyfikować, analizować lub przetwarzać za pomocą typizowanych modeli KiCad dostępnych w module.

5. Zapisz zmiany z powrotem do formatu S-expression za pomocą kicad.dumps(pcb), która zwraca sformatowany tekst zgodny ze standardem KiCad.

6. W przypadku zaawansowanego użytku (parsowanie niestandardowych struktur, obsługa błędów tokenizacji) odwołaj się do dokumentacji w src/faebryk/core/zig/README.md oraz kodu źródłowego tokenizera i parsera AST w katalogu src/faebryk/core/zig/src/sexp/.