Bisect

Fortgeschrittenes Git

Amanda Crawford-Adamo

Software and Data Engineer

Was ist git bisect?

Ein Tool, das per binärer Suche den Commit findet, der einen Bug eingeführt hat

Git-Bisect-Befehl

git bisect

Zweck

Finde den fehlerhaften Commit schnell
Unverzichtbar fürs Debuggen von Daten
Beschleunigt die Ursachenanalyse

Bisect – Start

Git-bisect-Session starten
```
git bisect start
```
Aktuellen Zustand als „bad" markieren
```
git bisect bad
```
Letzten bekannten „good"-Zustand markieren
```
git bisect good <commit-hash>
```

Grafik von Commits: Die ersten zwei Commits sind grün (gut). Der letzte Commit ist rot (bekannt fehlerhaft). Dazwischen liegen drei graue Commits mit unbekanntem Status. Der letzte gute Commit ist mit git bisect good markiert, der fehlerhafte mit git bisect bad.

Bisect – Suche

Markiert den Commit-Zustand als „bad"
```
git bisect bad
```
Markiert den Commit-Zustand als „good"
```
git bisect good
```

Grafik von Commits: Die ersten zwei Commits sind grün (gut). Der letzte Commit ist rot (bekannt fehlerhaft). Dazwischen liegen drei graue Commits mit unbekanntem Status. Git bisect nutzt binäre Suche und startet mit dem mittleren Commit und prüft dann links oder rechts weiter.

Bisect – automatisierte Suche

Prüft per Skript, ob ein Commit gut oder schlecht ist.

git bisect run <script_name>

Das Skript muss 0 zurückgeben, wenn die Tests bestehen.
Bei Fehltests soll es eine von 0 verschiedene Zahl zurückgeben.

Bisect – Ergebnis

Beispielausgabe von Git Bisect

$ git log
b1a534f ist der erste fehlerhafte Commit
commit b1a534f89l2c3d4e5f6g7h8i9j0k1l2m3n4o5p
Author: Jane Doe <[email protected]>
Date:   Thu Mar 14 14:30:00 2024 -0500

Update data transformation logic

Beendet den Bisect-Prozess und kehrt zu unserem aktuellen HEAD zurück

git bisect reset

Wann du git bisect nutzt

Anwendungsfälle

Regressionen in Daten-Workflows finden
Testskripte für schnelleres Debugging nutzen

Tipps

Tests mit git bisect run <test-script> automatisieren
Aussagekräftige Commit-Messages helfen beim Prozess

Lass uns üben!

Fortgeschrittenes Git