2.3 Git Basics - De commit geschiedenis bekijken

Nadat je een aantal commits gemaakt hebt, of als je een repository met een bestaande commit-geschiedenis gekloond hebt, zul je waarschijnlijk terug willen zien wat er gebeurd is. De meest eenvoudige en krachtige tool om dit te doen is het git log commando.

Deze voorbeelden maken gebruik van een eenvoudig project genaamd “simplegit”. Om het project op te halen, voer je dit uit

Als je git log in dit project uitvoert, zou je uitvoer moeten krijgen die er ongeveer zo uitziet:

Zonder argumenten toont git log standaard de commits die gedaan zijn in die repository, in omgekeerd chronologische volgorde, dus de meest recente wijziging bovenaan. Zoals je kunt zien, toont dit commando iedere commit met zijn SHA-1 checksum, de naam van de auteur en zijn e-mail, de datum van opslaan, en de commit boodschap.

Een gigantisch aantal en variëteit aan opties zijn beschikbaar voor het git log commando om je precies te laten zien waar je naar op zoek bent. Hier laten we je een aantal van de meest gebruikte opties zien.

Een van de meest behulpzame opties is -p of --patch, wat het verschil (de patch uitvoer) laat zien van de dingen die in iedere commit geïntroduceerd zijn. Je kunt ook -2 gebruiken, om alleen de laatste twee items te laten zien:

Deze optie toont dezelfde informatie, maar dan met een diff direct volgend op elk item. Dit is erg handig voor een code review, of om snel te zien wat er tijdens een reeks commits gebeurd is die een medewerker toegevoegd heeft. Je kunt ook een serie samenvattende opties met git log gebruiken. Bijvoorbeeld, als je wat verkorte statistieken bij elke commit wilt zien, kun je de --stat optie gebruiken:

Zoals je ziet, drukt de --stat optie onder elke commit een lijst gewijzigde bestanden af, hoeveel bestanden gewijzigd zijn, en hoeveel regels in die bestanden zijn toegevoegd en verwijderd. Het toont ook een samenvatting van de informatie aan het einde.

Een andere handige optie is --pretty. Deze optie verandert de log uitvoer naar een ander formaat dan de standaard. Er zijn al een paar voorgebouwde opties voor je beschikbaar. De oneline optie drukt elke commit op een eigen regel af, wat handig is als je naar veel commits kijkt. Daarnaast tonen de short, full en fuller opties de output in grofweg hetzelfde formaat, maar respectievelijk met minder of meer informatie:

De meest interessante optie is format, waarmee je je eigen log-uitvoer-formaat kunt specificeren. Dit is in het bijzonder handig als je output aan het genereren bent voor automatische verwerking; omdat je expliciet het formaat kunt specificeren, weet je dat het niet zal veranderen bij volgende versies van Git:

Nuttige opties voor git log --pretty=format toont een aantal handige opties die aan format gegeven kunnen worden.

Je zult je misschien afvragen wat het verschil is tussen auteur en committer. De auteur is de persoon die het werk oorspronkelijk geschreven heeft, terwijl de committer de persoon is die de patch als laatste heeft toegepast. Dus als je een patch naar een project stuurt en een van de kernleden past de patch toe, krijgen jullie beiden de eer, jij als de auteur en het kernlid als de committer. We gaan hier wat verder op in in Gedistribueerd Git.

De oneline en format opties zijn erg handig in combinatie met een andere log optie genaamd --graph. Deze optie maakt een mooie ASCII grafiek waarin je branch- en merge-geschiedenis getoond worden:

Dit type uitvoer zal interessanter worden als we branching en merging gaan behandelen in het volgende hoofdstuk.

Dit zijn slechts een paar simpele uitvoer formaat opties voor git log; er zijn er nog veel meer. Gebruikelijke opties bij git log toont de opties waarover we het tot nog toe gehad hebben, en wat veelvoorkomende formaat opties die handig kunnen zijn, samen met hoe ze de uitvoer van het log commando veranderen.