Formations — 1 037 leçons en français

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-only liste. C'est le seul périmètre correct pour un pre-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-commit dont 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.

Lire l'explication détaillée et faire le quiz →

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.