7.9 Git Tools - Rerere

De functionaliteit van git rerere is een beetje onbekend. De naam staat voor “reuse recorded resolution” (hergebruik opgenomen resoluties/oplossingen) en zoals de naam al aangeeft, stelt het je in staat om Git te vragen te onthouden hoe je een bepaald deel van een conflict hebt opgelost zodat Git, als het de volgende keer een vergelijkbaar conflict ziet, deze automatisch voor je kan oplossen.

Er zijn een aantal scenarios waarin deze functionaliteit erg handig zou kunnen zijn. Een van de voorbeelden dat in de documentatie wordt genoemd is dat je ervoor wilt zorgen dat een langlevende topic branch netjes zal mergen maar dat je niet een berg tussenliggende merge commits hoeft te maken die je historie vervuilen. Met rerere ingeschakeld kan je af en toe mergen, de conflicten oplossen en dan de merge terugdraaien. Als je dit doorlopend doet, zou de laatste merge eenvoudig moeten zijn omdat rerere alles gewoon automatisch voor je kan doen.

Deze zelfde taktiek kan gebruikt worden als je een branch rebased wilt houden zodat je niet elke keer met dezelfde rebasing conflicten te maken krijgt elke keer als je dit doet. Of als je een branch hebt die je hebt gemerged en daar een bergje conflicten hebt opgelost en dan besluit om deze toch maar te rebasen — je zult waarschijnlijk niet dezelfde conflicten willen doorlopen.

Een andere toepassing van rerere is er een waar je een af en toe aantal in ontwikkeling zijnde topic branches wilt mergen in een testbare head, zoals in het Git project zelf ook vaark gebeurt. Als de tests falen, kan je de merges terugdraaien en ze weer doen zonder de topic branch die de tests liet falen zonder de conflicten opnieuw te moeten oplossen.

Om de rerere functionaliteit in te schakelen, kan je eenvoudigweg de volgende configuratie setting aanroepen:

Je kunt het ook inschakelen door de .git/rr-cache directory in een specifieke repository aan te maken, maar de configuratie setting is duidelijker en het kan globaal gedaan worden.

Laten we nu eens een eenvoudig voorbeeld bekijken, vergelijkbaar met de vorige. Laten we zeggen dat we een bestand hebben dat er als volgt uitziet:

In de ene branch hebben we het woord “hello” in “hola” gewijzigd, en daarna in de andere branch veranderen we “world” in “mundo”, net zoals eerder.

Als we de twee branches mergen, zullen we een merge conflict krijgen:

Je zult de nieuwe regel Recorded preimage for FILE hier opmerken. Verder zou het er precies als een normale merge conflict uit moeten zien. Op dit moment kan rerere ons een aantal dingen vertellen. Normaalgesproken zou je een git status kunnen aanroepen om te zien waar de conflicten zitten:

Echter, git rerere zal je ook vertellen waar het de pre-merge status voor heeft opgenomen met git rerere status:

En git rerere diff zal ons de huidige staat van de resolutie laten zien — waar je mee begonnen bent met oplossen en waar je het in hebt opgelost.

Daarnaast (en dit is eigenlijk niet gerelateerd aan rerere), kan je ls-files -u gebruiken om de conflicterende bestanden en de voor, links en rechts versies te zien:

Je kunt het oplossen zodat het alleen puts 'hola mundo' wordt en je kunt het rerere diff commando nog een keer aanroepen om te zien wat rerere zal onthouden:

Dit zegt eigenlijk dat, wanneer Git een conflict in een deel van een hello.rb bestand ziet waar “hello mundo” aan de ene en “hola world” aan de andere kant staat, het zal oplossen naar “hola mundo”.

Nu kunnen we het als opgelost markeren en committen:

Je kunt zien aan de boodschap "Recorded resolution for FILE" zien dat het de resolutie voor het bestand heeft opgeslagen.

Laten we nu die merge eens ongedaan maken, en in plaats daarvan deze op onze master branch gaan rebasen. We kunnen onze branch terugzetten door reset te gebruiken zoals we zagen in Reset ontrafeld.

Onze merge is ongedaan gemaakt. Laten we de topic branch gaan rebasen.

We hebben nu dezelfde merge conflict zoals verwacht, maar kijk eens naar de regel met Resolved FILE using previous resolution. Als we nu het bestand bekijken zullen we zien dat het al is opgelost, er staan geen merge conflict markeringen in.

Ook zal git diff je laten zien hoe het automatisch opnieuw was opgelost:

Je kunt ook de staat van het conflicterende bestand opnieuw creeëren met het git checkout commando:

We zagen hier eerder een voorbeeld van in Mergen voor gevorderden. Voor nu echter, laten we het opnieuw oplossen door eenvoudigweg weer rerere aan te roepen:

We hebben het bestand automatisch her-opgelost door de opgeslagen rerere resolutie te gebruiken. Je kunt het nu toevoegen en de rebase vervolgen om het te voltooien.

Dus, als je vaak opnieuw merget, of je wilt een topic branch up-to-date houden met je master branch zonder talloze merges, of als je vaak rebaset, kan je rerere aanzetten om je leven wat aangenamer te maken.