Accueil › Git & CI/CD › Un pre-commit qu'on ne contourne pas
Un pre-commit qu'on ne contourne pas
Hooks et qualité automatiqueavance
Un pre-commit utile tient en trois règles : rapide, sur les fichiers
indexés, avec un message qui dit quoi faire.
#!/bin/sh
# .githooks/pre-commit
fichiers=$(git diff --cached --name-only --diff-filter=ACM)
[ -z "$fichiers" ] && exit 0
if echo "$fichiers" | grep -qE '(^|/)\.env$'; then
echo "Refus : un fichier .env est indexé."
echo " git restore --staged .env"
exit 1
fi
--diff-filter=ACM écarte les fichiers supprimés : les passer à un linter
provoque une erreur de fichier introuvable, et ce hook-là donne l'impression
que l'outil est cassé.
Ce qui a sa place dedans
| Contrôle | Durée | Dans pre-commit |
|---|---|---|
| Formatage des fichiers indexés | < 1 s | oui |
| Linter sur les fichiers indexés | 1 à 3 s | oui |
| Détection de secrets | < 1 s | oui |
| Tests unitaires du projet | 30 s à plusieurs minutes | non |
| Compilation complète | idem | non |
Le critère
Un contrôle mérite une place dans pre-commit si le coût de le découvrir
plus tard dépasse le coût de l'exécuter maintenant. Un secret poussé est
compromis : il faut le révoquer. Un test cassé découvert dans l'intégration
continue coûte quelques minutes d'attente.
Le piège de l'index
npx prettier --write src/ # modifie le disque
git commit # commite l'INDEX, pas le disque
Le commit contient l'ancien contenu. Si un hook reformate, il doit réindexer :
npx prettier --write $fichiers && git add $fichiers
Les termes à connaître
- Fichiers indexés
Ce que
git diff --cached --name-onlyliste. C'est le seul périmètre correct pour unpre-commit: vérifier tout le dépôt punit l'auteur pour des fautes qu'il n'a pas commises.- Formatage automatique
Réécrire le code selon une règle de style sans discussion possible. Le gain n'est pas esthétique : c'est la suppression d'une catégorie entière de commentaires de revue.
- Linter
Outil d'analyse statique qui signale les constructions douteuses. À séparer du formateur : l'un détecte des bogues, l'autre déplace des espaces.
- Contenu indexé
Le contenu réellement commité, qui peut différer du fichier sur le disque si l'indexation était partielle. Un hook qui lit le disque valide alors autre chose que ce qui part dans le commit.
- Détection de secrets
Recherche de motifs ressemblant à des clés ou des jetons dans les fichiers indexés. Le seul contrôle de
pre-commitdont l'absence coûte vraiment cher.- Budget de temps
La durée acceptable d'un hook client. Au-delà de quelques secondes, il est contourné — et un hook contourné ne protège de rien.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.