Para que serve o `git diff --patience`?

Como o algoritmo de paciência difere do git diffalgoritmo padrão e quando eu gostaria de usá-lo?

Você pode ler uma postagem de Bram Cohen , o autor do algoritmo diff de paciência, mas eu encontrei esta postagem no blog para resumir muito bem o algoritmo diff de paciência:

Em vez disso, a paciência Diff concentra sua energia nas linhas de alto conteúdo e baixa frequência que servem como marcadores ou assinaturas de conteúdo importante no texto. Ainda é um diferencial baseado em LCS em sua essência, mas com uma diferença importante, pois considera apenas a subsequência comum mais longa das linhas de assinatura:

Encontre todas as linhas que ocorrem exatamente uma vez em ambos os lados e faça a subsequência comum mais longa nessas linhas, combinando-as.

Quando você deve usar a diferença de paciência? Segundo Bram, a diferença de paciência é boa para esta situação:

Os casos realmente ruins são aqueles em que duas versões divergem dramaticamente e o desenvolvedor não está tomando cuidado para manter o tamanho dos patches sob controle. Nessas circunstâncias, um algoritmo diff pode ocasionalmente se tornar 'desalinhado', pois combina longas seções de colchetes, mas acaba correlacionando os colchetes de funções em uma versão com os colchetes da próxima função posterior na outra versão. Essa situação é muito feia e pode resultar em um arquivo de conflito totalmente inutilizável na situação em que você precisa que essas coisas sejam apresentadas de maneira coerente ao máximo.

Você também pode usá-lo para mesclagens (funcionou muito bem aqui para alguns conflitos XML):

git merge --strategy-option=patience ...

O algoritmo diff de paciência é um algoritmo diff mais lento que mostra melhores resultados em alguns casos.

Suponha que você tenha o seguinte arquivo registrado no git:

.foo1 {
    margin: 0;
}

.bar {
    margin: 0;
}

Agora reordenamos as seções e adicionamos uma nova linha:

.bar {
    margin: 0;
}

.foo1 {
    margin: 0;
    color: green;
}

O algoritmo diff padrão afirma que os títulos das seções foram alterados:

$ git diff --diff-algorithm=myers   
diff --git a/example.css b/example.css
index 7f1bd1e..6a64c6f 100755
--- a/example.css
+++ b/example.css
@@ -1,7 +1,8 @@
-.foo1 {
+.bar {
     margin: 0;
 }

-.bar {
+.foo1 {
     margin: 0;
+    color: green;
 }

Enquanto a paciência diff mostra um resultado que é sem dúvida mais intuitivo:

$ git diff --diff-algorithm=patience
diff --git a/example.css b/example.css
index 7f1bd1e..6a64c6f 100755
--- a/example.css
+++ b/example.css
@@ -1,7 +1,8 @@
-.foo1 {
-    margin: 0;
-}
-
 .bar {
     margin: 0;
 }
+
+.foo1 {
+    margin: 0;
+    color: green;
+}

Há uma boa discussão sobre a qualidade diff subjetiva aqui , e o git 2.11 está explorando ainda mais as heurísticas da diff .

Observe que o algoritmo diff de paciência ainda possui alguns casos patológicos conhecidos .