pyzig

Pyzig to system wiązań między Zigiem a Pythonem używany w projektach Faebryk do tworzenia wydajnych modułów natywnych. Obsługuje automatyczną kompilację przy imporcie, generowanie wrappersów, zarządzanie własnością obiektów oraz bezpośrednie wywołania CPython C-API. Zawiera trzy warstwy: loader Pythona z synchronizacją stubów, build Ziga generujący rozszerzenia .so, oraz narzędzia do generowania bindingów. Idealne do dodawania nowych wiązań Zig-Python, modyfikowania natywnych rozszerzeń i debugowania interakcji C-API.

1. Zainstaluj projekt Faebryk i upewnij się, że masz dostęp do repozytorium atopile/atopile zawierającego skill pyzig w katalogu .claude/skills/pyzig.

2. Uruchom kompilację projektu poleceniem ato dev compile, które zbuduje moduły Ziga i wygeneruje niezbędne pliki .so oraz stuby .pyi.

3. Zaimportuj moduł poleceniem python -c "import faebryk.core.zig; import faebryk.core.graph", aby załadować warstwę interoperacyjności i sprawdzić, czy kompilacja przebiegła pomyślnie.

4. Jeśli chcesz dodać nowe bindingu Zig-Python, edytuj odpowiedni plik w src/faebryk/core/zig/src/python/ (np. graph_py.zig dla bindingów grafu) i użyj narzędzi z src/faebryk/core/zig/src/pyzig/ do generowania wrapperów.

5. Dla debugowania lub modyfikacji zachowania kompilacji, sprawdź zmienne środowiskowe ZIG_NORECOMPILE i ZIG_RELEASEMODE w pliku src/faebryk/core/zig/__init__.py, które kontrolują tryb budowania.

6. Po zmianach w kodzie Ziga uruchom ponownie ato dev compile, aby regenerować stuby i przebudować rozszerzenia natywne.