Avouch gjennomgår bare Python-koden du er i ferd med å pushe

En vanlig linter går gjennom alt som ligger i repoet, og du bruker like mye tid på arven etter forgjengeren din som på koden du skrev i dag. Avouch snur på det: verktøyet spør Git hva neste commit rører, og gjennomgår bare det. Gjennomgangssettet er sporede filer endret mot HEAD pluss usporede .py-filer, mens slettede stier, alt som ikke er Python og filer som ser genererte ut hoppes over. Prosjektets egen formulering er at hvert funn skal kunne tilskrives arbeidet du er i ferd med å pushe.

Hver fil parses med standardbibliotekets ast-modul, ikke med regulære uttrykk. Parametertelling, nestingsdybde og linjespenn blir dermed eksakte, og Avouch oppgir ikke et mål det ikke kan regne ut nøyaktig. Funnene rendres kompilatorstil: fil og linjenummer, regel-ID som SCR002 for bar except eller SCR014 for for mange parametre, og en caret under navnet som ble flagget. En fil som er uleselig eller syntaktisk ødelagt blir en ERROR-oppføring i rapporten i stedet for å avbryte gjennomgangen av de andre.

Hele kjøretiden er tre git-kall pluss ast og tomllib. Ingen daemon å holde i live, ingen nettverk, og tidsbruken følger størrelsen på diffen, ikke på repoet. Du trenger Python 3.10 eller nyere, fordi reglene bruker ast.Match og konfigurasjonen leses med tomllib, og Git må ligge på PATH. Grensene settes i avouch.toml. Flagget «--json» gir ett JSON-dokument på stdout med egen skjemaversjon, adskilt fra pakkeversjonen, så CI kan parse det uten å plukke felter fra en menneskerapport.

Avouch gjennomgår, men håndhever ikke. Sluttkoden er 0 for ren, 1 for funn og 2 for feil i verktøyet selv, og forfatteren mener håndhevingen hører hjemme i et grensesnitt du velger å slå på, ikke i noe du kjører før hver push. En fersk utsjekking på en CI-runner har ingen diff, og der må du bruke «--all-files». Mangler du Git helt, går «--not-git» gjennom alle .py-filer på disk.

Hva bør du gjøre?

1. Installer med «pip install avouch» og kjør «avouch» i et repo der du har uferdige endringer liggende.
2. Sett grensene i avouch.toml etter din egen kodestil. Standardverdiene er et utgangspunkt, ikke en fasit.
3. Skal den inn i CI, bruk «--all-files» der og «--json» hvis noe skal lese resultatet maskinelt.