Bisect

Git avancé

Amanda Crawford-Adamo

Software and Data Engineer

Qu'est-ce que git bisect ?

Un outil qui utilise la recherche binaire pour trouver le commit qui a introduit un bogue

Commande Git bisect

git bisect

Objectif

Trouver rapidement le mauvais commit
Essentiel pour le débogage des données
Accélère l'analyse des causes profondes

Bisect - démarrer

Démarrer une session git bisect
```
git bisect start
```
Marquer l'état actuel comme défectueux
```
git bisect bad
```
Indiquer le dernier état fonctionnel
```
git bisect good <commit-hash>
```

Graphe de commits montrant les deux premiers comme « bons » en vert. Le dernier est rouge, marquant le commit défectueux connu. Entre les deux, trois commits sont « inconnus » en gris. Le dernier bon commit est marqué par git bisect good et le mauvais par git bisect bad.

Bisect - recherche

Marquer l'état du commit comme défectueux
```
git bisect bad
```
Marquer l'état du commit comme bon
```
git bisect good
```

Graphe de commits montrant les deux premiers comme « bons » en vert. Le dernier est rouge, marquant le commit défectueux connu. Entre les deux, trois commits sont « inconnus » en gris. Git bisect utilise une recherche binaire : il commence par vérifier le commit du milieu, puis celui à gauche ou à droite.

Bisect - recherche automatisée

Vérifie si le commit est bon ou mauvais en exécutant un script de test automatisé.

git bisect run <script_name>

Le script doit retourner 0 si les tests réussissent.
En cas d'échec, il doit retourner une valeur non nulle.

Graphe de commits montrant les deux premiers comme « bons » en vert. Le dernier est rouge, marquant le commit défectueux connu. Entre les deux, trois commits sont « inconnus » en gris. Git bisect utilise une recherche binaire : il commence par vérifier le commit du milieu, puis celui à gauche ou à droite.

Bisect - résultat

Exemple de sortie Git bisect

$ git log
b1a534f est le premier mauvais commit
commit b1a534f89l2c3d4e5f6g7h8i9j0k1l2m3n4o5p
Author: Jane Doe <[email protected]>
Date:   Thu Mar 14 14:30:00 2024 -0500

Update data transformation logic

Quitte le processus de bissection et revient à notre HEAD actuel

git bisect reset

Quand utiliser git bisect

Cas d'usage

Repérer les régressions dans les flux de données
Utiliser des scripts de test pour accélérer le débogage

Conseils

Automatisez les tests avec git bisect run <test-script>
Rédigez des messages de commit descriptifs pour faciliter le processus

Passons à la pratique !

Git avancé