|
|
| (5 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) |
| Linha 1: |
Linha 1: |
| − | == Como Comparar Arquivos de Texto Usando diff ==
| |
| | | | |
| − | Se você precisa comparar dois arquivos de texto em Unix, é provável que você use o comando diff. Vamos usar um cenário simples parar comparar dois arquivos de texto e verificar se há alguma diferença entre eles.
| |
| − |
| |
| − | Suponha que você tem dois arquivos no diretório /tmp:
| |
| − |
| |
| − | <code>
| |
| − | /tmp/1.txt:
| |
| − |
| |
| − | aaa
| |
| − | bbb
| |
| − | ccc
| |
| − | ddd
| |
| − | eee
| |
| − | fff
| |
| − | ggg
| |
| − | </code>
| |
| − |
| |
| − | <code>
| |
| − | e /tmp/2.txt:
| |
| − |
| |
| − | bbb
| |
| − | c c
| |
| − | ddd
| |
| − | eee
| |
| − | fff
| |
| − | ggg
| |
| − | hhh
| |
| − | </code>
| |
| − |
| |
| − |
| |
| − | São arquivos criados com pouco conteúdo e simples – é o jeito mais fácil para explicar como a comparação funciona. Se não houver diferenças entre os arquivos, você não verá nenhuma saída, mas se dois arquivos são de fato diferentes, todas as divergências serão mostradas com a saída padrão do diff:
| |
| − |
| |
| − | <code>
| |
| − | $ diff /tmp/1.txt /tmp/2.txt
| |
| − | 1d0
| |
| − | < aaa
| |
| − | 3c2
| |
| − | < ccc
| |
| − | ---
| |
| − | > c c
| |
| − | 7a7
| |
| − | > hhh
| |
| − | </code>
| |
| − |
| |
| − | Linhas como “1d0” e “3c2” são as coordenadas e os tipos das diferenças entre os dois arquivos comparados, enquanto linhas como “< aaa” e “> hhh” são as diferenças entre os arquivos.
| |
| − |
| |
| − | As coordenadas incluem dois números e uma letra entre eles. As letras dizem que tipo de mudança foi descoberta:
| |
| − |
| |
| − | <code>
| |
| − | d uma linha foi removida (deleted)
| |
| − | c uma linha foi alterada (changed)
| |
| − | a uma linha foi adicionada (appended)
| |
| − | </code>
| |
| − |
| |
| − | O número à esquerda da letra diz qual linha do arquivo original (o primeiro), e o número à direita diz qual linha do segundo arquivo arquivo foi usada na comparação.
| |
| − |
| |
| − | Então, olhando para os dois arquivos e a saída do diff acima, você pode ver o que aconteceu:
| |
| − |
| |
| − | <code>
| |
| − | 1d0
| |
| − | < aaa
| |
| − | </code>
| |
| − |
| |
| − | Isso significa que a linha 1 foi removida. < aaa sugere que a linha aaa existe apenas no arquivo original.
| |
| − |
| |
| − | <code>
| |
| − | 3c2
| |
| − | < ccc
| |
| − | ---
| |
| − | > c c
| |
| − | </code>
| |
| − |
| |
| − | E isso significa que a linha número 3 foi alterada. Você pode confirmar verificando que no primeiro arquivo a linha era “ccc” e no segundo a linha agora é “c c”.
| |
| − |
| |
| − | <code>
| |
| − | 7a7
| |
| − | > hhh
| |
| − | </code>
| |
| − |
| |
| − | Finalmente, isso confirma que uma nova linha foi adicionada no segundo arquivo, “hhh” na na linha 7.
| |
| − |
| |
| − |
| |
| − | === Unified ===
| |
| − |
| |
| − | Entre as várias opções que o diff aceita, uma opção que pode facilitar a visualização das diferenças é a opção -u (unified) que irá mostrar na saída os dois arquivos unidos no mesmo contexto.
| |
| − |
| |
| − | <code>
| |
| − | $ diff -u /tmp/1.txt /tmp/2.txt
| |
| − | - - - /tmp/1.txt 2011-06-07 11:24:29.223000060 -0400
| |
| − | +++ /tmp/2.txt 2011-06-07 11:24:45.830000062 -0400
| |
| − | @@ -1,7 +1,7 @@
| |
| − | -aaa
| |
| − | bbb
| |
| − | -ccc
| |
| − | +c c
| |
| − | ddd
| |
| − | eee
| |
| − | fff
| |
| − | ggg
| |
| − | +hhh
| |
| − | </code>
| |
| − |
| |
| − | A saída mostra os dois arquivos juntos, com a comparação do primeiro arquivo
| |
| − | com o segundo.
| |
| − |
| |
| − |
| |
| − | === Colordiff ===
| |
| − |
| |
| − | Colordiff é um script em Perl que produz a mesma saída do diff, mas com destaques coloridos para facilitar a visualização das mudanças. Veja como é a saída para o nosso exemplo:
| |
| − |
| |
| − |
| |
| − | <p style="text-align: justify;"></p>
| |
| − | <p style="text-align: justify;">$ colordiff -u /tmp/1.txt /tmp/2.txt</p>
| |
| − | <p style="text-align: justify;"><span style="color: #ff0000;">- - - /tmp/1.txt 2011-06-07 18:28:53.459153111 -0400</span></p>
| |
| − | <p style="text-align: justify;"><span style="color: #3366ff;">+++ /tmp/2.txt 2011-06-07 18:29:02.606153114 -0400</span></p>
| |
| − | <p style="text-align: justify;">@@ -1,7 +1,7 @@</p>
| |
| − | <p style="text-align: justify;"><span style="color: #ff0000;">-aaa</span></p>
| |
| − | <p style="text-align: justify;">bbb</p>
| |
| − | <p style="text-align: justify;"><span style="color: #ff0000;">-ccc</span></p>
| |
| − | <p style="text-align: justify;"><span style="color: #3366ff;">+c c</span></p>
| |
| − | <p style="text-align: justify;">ddd</p>
| |
| − | <p style="text-align: justify;">eee</p>
| |
| − | <p style="text-align: justify;">fff</p>
| |
| − | <p style="text-align: justify;"><span style="color: #ff0000;">-ggg</span></p>
| |
| − | <p style="text-align: justify;"><span style="color: #3366ff;">+ggg</span></p>
| |
| − | <p style="text-align: justify;"><span style="color: #3366ff;">+hhh</span></p>
| |
| − |
| |
| − |
| |
| − | A ferramenta diff provavelmente já estará na sua distribuição linux assim que você instalar o sistema operacional. Mas o colordiff geralmente não é distribuído junto. Você pode instalar o pacote pelo repositório do seu sistema ou efetuando o download de colordiff.sourceforge.net.
| |
| − |
| |
| − | Para instalar o colordiff em um sistema baseado em Debian:
| |
| − | <code>
| |
| − | # apt-get install colordiff
| |
| − | </code>
| |
| − |
| |
| − | Outras distribuições que empacotam o colordiff incluem: Gentoo Linux, Fedora, MacOS X/Darwin, Lunar Linux, FreeBSD e ArchLinux.
| |
| − |
| |
| − |
| |
| − | == Como Criar Patches com Diff e Patch ==
| |
| − |
| |
| − | '''Situação 1:''' você está tentando compilar um pacote com o código-fonte e então descobre que alguém já consertou para que ele compile no seu sistema.
| |
| − | Eles disponibilizaram o trabalho como um “patch”, mas você não tem certeza do que fazer com isso. A resposta é aplicar o patch no código-fonte original com uma ferramenta por linha de comando chamada patch.
| |
| − |
| |
| − | '''Situação 2:''' você fez o download do código-fonte de um pacote open-source e após algumas pequenas mudanças, você compila ele para seu sistema. Você quer compartilhar o seu trabalho para outros programadores, ou para os
| |
| − | autores do pacote, sem redistribuir o código-fonte inteiro. Esta é uma situação que você precisa criar um patch, e a ferramenta que geralmente é usada é a diff.
| |
| − |
| |
| − |
| |
| − | === Criando patches com diff ===
| |
| − |
| |
| − | Usar diff é simples quando você está trabalhando com poucos arquivos ou diretórios inteiros. Para criar um patch de um único arquivo, use diff com a
| |
| − | opção unified:
| |
| − | <code>
| |
| − | diff -u original.c novo.c > original.patch
| |
| − | </code>
| |
| − |
| |
| − | Para criar um patch do código-fonte inteiro, faça uma cópia da árvore do diretório:
| |
| − | <code>
| |
| − | cp -R original novo
| |
| − | </code>
| |
| − |
| |
| − | Faça todas as suas mudanças no diretório novo/. Então crie um patch do código-fonte inteiro:
| |
| − | <code>
| |
| − | diff -rupN original/ novo/ > original.patch
| |
| − | </code>
| |
| − |
| |
| − | Descrição das opções usadas:
| |
| − | '''r''' Comparar arquivos recursivamente, nos diretórios e sub-diretórios.
| |
| − | '''u''' Unificar arquivos comparados na mesma saída.
| |
| − | '''p''' Mostra em qual função da linguagem C cada alteração está.
| |
| − | '''N''' Trata arquivos inexistentes como arquivos vazios.
| |
| − |
| |
| − |
| |
| − | === Aplicando patches com patch ===
| |
| − |
| |
| − | Para aplicar um patch em um único arquivo, vá até o diretório em que o arquivo está e chame patch:
| |
| − | <code>
| |
| − | patch < foo.patch
| |
| − | </code>
| |
| − |
| |
| − | Estas instruções assumem que o patch está no formato unificado (opção -u do diff), que identifica o arquivo em que o patch deve ser aplicado. Se você não usou o formato unificado, pode dizer em qual arquivo deseja aplicar o patch:
| |
| − | <code>
| |
| − | patch foo.txt < bar.patch
| |
| − | </code>
| |
| − |
| |
| − | Aplicar patches para diretórios inteiros é parecido, mas você precisa ter cuidado ao definir o nível da opção strip. A opção -p ou --strip diz quantos diretórios devem ser retirados de cada caminho de arquivo. Isso é útil para
| |
| − | aplicar um patch em computadores diferentes do qual o patch foi criado.
| |
| − |
| |
| − | Veja o trecho do manual do patch sobre a opção -p:
| |
| − | <code>
| |
| − | Por exemplo, supondo que o caminho para um arquivo no patch é
| |
| − | * /u/howard/src/blurfl/blurfl.c
| |
| − | usando -p0 o caminho não será modificado, com -p1 usaria o caminho
| |
| − | * u/howard/src/blurfl/blurfl.c
| |
| − | sem o primeiro slash, e -p4
| |
| − | * blurfl/blurfl.c
| |
| − | </code>
| |
| − |
| |
| − | Exemplo da opção patch para um diretório inteiro, aonde o primeiro caminho slash é removido:
| |
| − | <code>
| |
| − | patch -p1 < baz.patch
| |
| − | </code>
| |
| − |
| |
| − | Outro exemplo, se o patch que você baixou tem o um arquivo com o seguinte caminho:
| |
| − | <code>
| |
| − | /users/stephen/package/src/net/http.c
| |
| − | </code>
| |
| − |
| |
| − | E você está trabalhando em um diretório que contém net/http.c, use
| |
| − | <code>
| |
| − | patch -p5 < baz.patch
| |
| − | </code>
| |
| − |
| |
| − | Se você aplicou um patch, mas quer remover ele, use a opção de reverter (-r ou --reverse):
| |
| − | <code>
| |
| − | patch -p5 -R < baz.patch
| |
| − | </code>
| |
| − |
| |
| − | Isso é o básico para o uso de diff e patch. Para mais informações consulte os manuais:
| |
| − | <code>
| |
| − | man diff
| |
| − | man patch
| |
| − | </code>
| |
| − |
| |
| − | == Referencias ==
| |
| − | * [http://www.unixtutorial.org/2008/02/compare-text-files-using-diff/ How to Compare Text Files Using diff]
| |
| − | * [http://jungels.net/articles/diff-patch-ten-minutes.html The Ten Minute Guide to diff and patch]
| |
