Automatisation des hooks Git avec lefthook
Décision
- Adopter
lefthookpour la gestion des hooks Git. - Exécuter
biome format --writepuisbiome check --writesur les fichiers indexés danspre-commit. - Exécuter également
biome format --writepuisbiome check --writesur les fichiers indexés danspre-push. - Centraliser la définition des hooks dans
lefthook.ymlà la racine du dépôt.
Contexte
Quand le formatage ou le lint n’est pas exécuté en local, les revues contiennent des diffs et remarques non essentielles. Les configurations de hooks variaient aussi selon les développeurs, d’où le besoin d’une approche versionnée et reproductible.
Alternatives
- Hooks Git natifs dans
.git/hooksconfigurés manuellement : faible reproductibilité et partage difficile. - Husky : solution éprouvée, mais
lefthooka été privilégié ici pour une configuration plus légère et plus simple. - Validation uniquement en CI : retour plus lent et absence de détection précoce en local.
Conséquences
- Les contrôles qualité sont automatisés avant le commit et avant le push.
- Les problèmes de formatage sont détectés tôt, réduisant les écarts de style.
- En cas d’échec, le commit/push est bloqué jusqu’à correction et relance des vérifications.
hsb.horse