Bisect

Advanced Git

Amanda Crawford-Adamo

Software and Data Engineer

Co je git bisect?

Nástroj využívající binární vyhledávání k nalezení commitu, který zavedl chybu

Příkaz git bisect

git bisect

Účel

Rychlé nalezení špatného commitu
Nezbytné pro ladění dat
Urychluje analýzu příčin

Bisect – zahájení

Zahájení relace git bisect
```
git bisect start
```
Označení aktuálního stavu jako špatného
```
git bisect bad
```
Označení posledního známého dobrého stavu
```
git bisect good <commit-hash>
```

Graf commitů zobrazující první dva jako dobré (zeleně). Poslední commit je červený – jde o známý špatný commit. Mezi dobrými a špatnými commity jsou tři commity neznámého stavu (šedě). Poslední dobrý commit je označen příkazem git bisect good a špatný commit příkazem git bisect bad.

Bisect – vyhledávání

Označí stav commitu jako špatný
```
git bisect bad
```
Označí stav commitu jako dobrý
```
git bisect good
```

Graf commitů zobrazující první dva jako dobré (zeleně). Poslední commit je červený – jde o známý špatný commit. Mezi dobrými a špatnými commity jsou tři commity neznámého stavu (šedě). Git bisect využívá binární vyhledávání a začíná prostředním commitem, poté zkontroluje commit vlevo nebo vpravo.

Bisect – automatické vyhledávání

Zkontroluje, zda je verze commitu dobrá nebo špatná, spuštěním automatizovaného testovacího skriptu.

git bisect run <script_name>

Skript musí vrátit 0, pokud testy prošly.
Pokud testy selžou, musí vrátit nenulové číslo.

Graf commitů zobrazující první dva jako dobré (zeleně). Poslední commit je červený – jde o známý špatný commit. Mezi dobrými a špatnými commity jsou tři commity neznámého stavu (šedě). Git bisect využívá binární vyhledávání a začíná prostředním commitem, poté zkontroluje commit vlevo nebo vpravo.

Bisect – výsledek

Příklad výstupu git bisect

$ git log
b1a534f is the first bad commit
commit b1a534f89l2c3d4e5f6g7h8i9j0k1l2m3n4o5p
Author: Jane Doe <[email protected]>
Date:   Thu Mar 14 14:30:00 2024 -0500

Update data transformation logic

Ukončí proces bisekce a vrátí se na aktuální HEAD

git bisect reset

Kdy použít git bisect

Případy užití

Hledání regresí v datových workflow
Použití testovacích skriptů pro rychlejší ladění

Tipy

Automatizujte testování pomocí git bisect run <test-script>
Používejte popisné zprávy commitů pro usnadnění procesu

Pojďme procvičovat!

Advanced Git