Generowanie klienta sync

Moduły async_* są ręcznie utrzymywanym źródłem prawdy dla parzystych API SDK. Ich odpowiedniki sync są commitowanymi artefaktami generowanymi przez scripts/gen_sync.py.

Zasada pracy

1. Edytuj źródło async_*.
2. Uruchom just gen-sync.
3. Przejrzyj diff wygenerowanych plików sync.
4. Uruchom just check-gen-sync i testy.

Nie edytuj plików z nagłówkiem Generated by scripts/gen_sync.py ręcznie. Jeżeli wynik jest zły, popraw źródło async albo generator.

Komendy

just gen-sync
just check-gen-sync
uv run python scripts/gen_sync.py --only src/ksef2/clients/async_invoices.py --diff

Guard check-gen-sync działa też w just release-check oraz w testach jednostkowych, więc nieaktualne artefakty sync powinny zostać złapane przed wydaniem.