Diff e patch: mudanças entre as edições

De Wikiunicentro
Lpadilha (discussão | contribs)
Lpadilha (discussão | contribs)
Limpou toda a página
 
(4 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>
== Referências ==
* [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]
----
[[Ensino Extracurricular de Programação de Computadores | CLIQUE AQUI]] para voltar.

Edição atual tal como às 03h52min de 13 de maio de 2015