git diff

Laten we nu een meer gedetailleerde uitsplitsing van de diff-output bekijken.

Deze regel geeft de inputbronnen van de diff weer. We zien dat a/diff_test.txt en b/diff_test.txt zijn doorgegeven aan de diff.

Met deze regel worden enkele interne Git-metagegevens weergegeven. Je hebt deze informatie waarschijnlijk niet nodig. De cijfers in deze uitvoer komen overeen met de hash-ID's van de versie van het Git-object.

Deze regels zijn een legenda die symbolen toewijst aan elke diff-inputbron. In dit geval worden veranderingen ten opzichte van a/diff_test.txt gemarkeerd met --- en de veranderingen ten opzichte van b/diff_test.txt worden gemarkeerd met het symbool +++.

De rest van de diff-output is een lijst met diff-'segmenten'. Een diff geeft alleen de gedeelten van het bestand weer die wijzigingen bevatten. In ons huidige voorbeeld hebben we maar één segment omdat we met een eenvoudig scenario werken. Segmenten hebben hun eigen granulaire outputsemantiek.

De eerste regel is de segmentheader. Elk segment wordt voorafgegaan door een header tussen de @@-symbolen. De inhoud van de header is een overzicht van de wijzigingen die in het bestand zijn aangebracht. In ons vereenvoudigde voorbeeld staat -1 +1, wat betekent dat er in regel één wijzigingen zitten. In een meer realistische diff zou je een header zien als:

In dit headervoorbeeld zijn er 6 regels geëxtraheerd vanaf regel 34. Daarnaast zijn er 8 regels toegevoegd vanaf regel 34.

De resterende inhoud van het diff-segment geeft de recente veranderingen weer. Elke gewijzigde regel wordt voorafgegaan door een +- of --symbool, dat aangeeft van welke versie van de diff-input de veranderingen afkomstig zijn. Zoals we eerder hebben besproken, geeft - veranderingen aan ten opzichte van a/diff_test.txt en + geeft veranderingen aan ten opzichte van b/diff_test.txt.

Nu worden in de output alleen de kleurgecodeerde woorden weergegeven die zijn gewijzigd.

Als je de Git-bron kloont, vind je een submap met de naam contrib. Deze bevat een heleboel tools die verband houden met Git, naast andere interessante onderdelen die het nog niet hebben gemaakt tot Git core. Eén daarvan is een Perl-script met de naam diff-highlight. Diff-highlight koppelt overeenkomende regels van de diff-output aan elkaar en markeert gewijzigde subwoordfragmenten.

Nu hebben we onze diff teruggebracht tot de kleinst mogelijke wijziging.

Git heeft wel een functie waarmee je een shell-opdracht kunt specificeren om de inhoud van je binaire bestanden om te zetten in tekst voordat je de diff uitvoert. Dit vraagt wel enige configuratie. Eerst moet je een textconv-filter specificeren die beschrijft hoe je een bepaald type binair bestand naar tekst converteert. We gebruiken een eenvoudig hulpprogramma genaamd pdftohtml (beschikbaar via homebrew) om mijn pdf's om te zetten in voor mensen leesbare HTML. Je kunt dit configureren voor één repository door je .git/config-bestand te bewerken of dit globaal doen door ~ /.gitconfig te bewerken

Dan hoef je alleen maar een of meer bestandspatronen te koppelen aan onze pdfconv-filter. Je kunt dit doen door een .gitattributes-bestand te maken in de hoofdmap van je repository.

Eenmaal geconfigureerd, voert git diff eerst het binaire bestand uit via het geconfigureerde conversiescript en wordt er een diff gemaakt van de conversieoutput. Dezelfde techniek kan worden toegepast om nuttige diffs op te halen uit allerlei soorten binaire bestanden, bijvoorbeeld: zip's, jar's en andere archieven: als je unzip -l (of iets dergelijks) gebruikt in plaats van pdftohtml, krijg je de paden te zien die zijn toegevoegd of verwijderd tussen commitimages. exiv2 kan worden gebruikt om veranderingen in metagegevens weer te geven, zoals documenten met image-afmetingen. Er bestaan conversietools voor het transformeren van .odf, .doc en van andere documentformaten naar platte tekst. In geval van nood werkt strings vaak voor binaire bestanden waarvoor geen formele converter bestaat.

Dit voorbeeld is gericht op ./path/to/file. Indien aangeroepen, worden de specifieke veranderingen in de werkmap vergeleken met de index, waarbij de veranderingen worden weergegeven die nog niet zijn gestaged. git diff voert de vergelijking standaard uit ten opzichte van HEAD. Weglaten van HEAD in het voorbeeld hierboven git diff ./pad/to/file heeft hetzelfde effect.

Wanneer git diff wordt aangeroepen met de optie --cached, vergelijkt de diff de gestagede wijzigingen met de lokale repository. De optie --cached is een synoniem van --staged.

Als je git diff aanroept zonder een bestandspad, worden de wijzigingen in de hele repository vergeleken. De bovenstaande, bestandsspecifieke voorbeelden, kunnen worden aangeroepen zonder het argument ./path/to/file en kunnen dezelfde outputresultaten hebben voor alle bestanden in de lokale repo.

git diff toont standaard alle niet-gecommitte wijzigingen sinds de laatste commit.

git diff kan Git-refs naar commits voor diff doorgestuurd krijgen. Enkele voorbeelden van refs zijn HEAD, tags en branchnamen. Elke commit in Git heeft een commit-ID, die je kunt verkrijgen wanneer je GIT LOG uitvoert. Je kunt deze commit-ID ook doorgeven aan git diff.

In dit voorbeeld wordt de puntoperator geïntroduceerd. De twee punten in dit voorbeeld geven aan dat de diff-input bestaat uit de uiteinden van beide branches. Hetzelfde effect treedt op als de punten worden weggelaten en er een spatie wordt gebruikt tussen de branches. Daarnaast is er een operator met drie punten:

De operator met drie punten initieert de diff door de eerste invoerparameter branch1 te wijzigen. Dit verandert branch1 in een referentie van de gedeelde gemeenschappelijke bovenliggende commit van de twee diff-inputs, de gedeelde voorouder van branch1 en de andere functiebranch. De inputparameter van de laatste parameter blijft ongewijzigd als het uiteinde van other-feature-branch.