Git diff

Vamos agora examinar uma análise com mais informações sobre o resultado da comparação.

Esta linha exibe as fontes de entrada da comparação. A gente pode ver que o a/diff_test.txt e o b/diff_test.txt foram aprovados para a comparação.

Essa linha exibe alguns metadados internos do Git. Você com certeza não vai precisar dessas informações. Os números neste resultado correspondem aos identificadores de hash da versão do objeto Git.

Essas linhas são uma legenda que atribui símbolos a cada fonte de entrada de comparação. Nesse caso, as alterações de a/diff_test.txt são marcadas com --- e as alterações de b/diff_test.txt são marcadas com o símbolo +++.

O resultado restante da comparação é uma lista de "fragmentos" de comparação. Uma comparação exibe apenas as seções do arquivo que têm alterações. No exemplo atual, temos apenas um fragmento, pois estamos trabalhando com um cenário simples. Os fragmentos têm semântica granular de saída própria.

A primeira linha é o cabeçalho do fragmento. Cada fragmento é precedido por um cabeçalho inserido entre os símbolos @@. O conteúdo do cabeçalho é um resumo das alterações feitas no arquivo. No exemplo simplificado, temos -1 +1, significando que a linha um teve alterações. Em uma comparação mais realista, você veria um cabeçalho como:

Neste exemplo de cabeçalho, 6 linhas foram extraídas a partir da linha número 34. Além disso, 8 linhas foram adicionadas começando na linha número 34.

O conteúdo restante do fragmento de comparação exibe as alterações recentes. Cada linha alterada é anexada com um símbolo de + ou - indicando de qual versão da entrada de comparação as alterações vêm. Conforme discutimos anterior, o símbolo, - indica alterações do a/diff_test.txt e o + indica alterações do b/diff_test.txt.

Agora, o resultado exibe apenas as palavras codificadas por cores que foram alteradas.

Se você clonar a fonte do git, você vai encontrar um subdiretório chamado contrib. Ele contém várias ferramentas relacionadas ao git e outras informações interessantes que ainda não foram promovidos ao núcleo do git. Um deles é um script Perl chamado destaque da comparação. O destaque da comparação emparelha as linhas correspondentes do resultado da comparação e destaca os fragmentos de sub-palavras que foram alterados.

Agora, reduzimos a comparação para a menor alteração possível.

O Git tem uma função que permite especificar um comando shell para transformar o conteúdo de arquivos binários em texto antes de executar a comparação. No entanto, é preciso configurar algumas coisas. Primeiro, você precisa especificar um filtro textconv descrevendo como converter um certo tipo de binário em texto. Estamos usando um utilitário simples chamado pdftohtml (disponível via Homebrew) para converter meus PDFs em HTML legível por humanos. Você pode usar a configuração de um único repositório editando o arquivo .git/config ou por inteiro por meio da edição de ~ /.gitconfig

Então, tudo o que você precisa fazer é associar um ou mais padrões de arquivo ao filtro pdfconv. Você pode fazer essa configuração criando um arquivo .gitattributes na raiz do repositório.

Uma vez configurado, o git diff primeiro vai executar o arquivo binário através do script do conversor configurado e vai comparar o resultado do conversor. A mesma técnica pode ser aplicada para obter comparações úteis de todos os tipos de arquivos binários, por exemplo: zips, jars e outros arquivos: usar o unzip -l (ou similar) em vez do pdf2html vai mostrar os caminhos que foram adicionados ou removidos entre as imagens de commits: o exiv2 pode ser usado para mostrar alterações de metadados, como documentos de dimensões de imagem: existem ferramentas de conversão para transformar .odf, .doc e outros formatos de documento em texto sem formatação. Em último caso, as strings em geral funcionam para arquivos binários onde não existe um conversor formal.

Este exemplo tem como escopo o ./path/to/file quando solicitado, ele vai comparar as alterações específicas no diretório ativo, com o índice, mostrando as alterações que ainda não foram testadas. Por padrão, o git diff vai realizar a comparação com o HEAD. Omitindo HEAD no exemplo acima, o git diff ./path/to/file tem o mesmo efeito.

Quando o git diff é solicitado com a opção --cached, a comparação vai utilizar as alterações em etapas com o repositório local. A opção --cached é sinônimo de --staged.

Solicitar o git diff sem um caminho de arquivo vai comparar as alterações em todo o repositório. Os exemplos específicos acima, do arquivo, podem ser solicitados sem o argumento ./path/to/file e têm os mesmos resultados de saída em todos os arquivos no repositório local.

Por padrão, o git diff vai mostrar todas as alterações que não passaram por commit desde o último commit.

O git diff pode passar de refs do Git para fazer commit da comparação. Alguns exemplos de refs são HEAD, marcadores e nomes de ramificações. Cada commit no Git tem um ID de commit que você pode obter quando executa o GIT LOG. Você também pode passar esse ID de commit para o git diff.

Este exemplo apresenta o operador de ponto. Os dois pontos neste exemplo indicam que a entrada de comparação é a extremidade das duas ramificações. O mesmo efeito ocorre se os pontos forem omitidos e for usado um espaço entre as ramificações. Além disso, há um operador de três pontos:

O operador de três pontos inicia a comparação alterando o primeiro parâmetro de entrada branch1. Ela altera o branch1 em um ref do commit ancestral comum compartilhado entre as duas entradas de comparação, o ancestral compartilhado do branch1 e a other-feature-branch. O último parâmetro de entrada do parâmetro permanece inalterado como a extremidade do other-feature-branch.