Ferramentas de texto

Comparar dois blocos de texto é algo que as pessoas fazem o tempo todo e quase sempre em um momento ruim: uma configuração que funciona em um host e em outro não, um corpo de resposta que mudou entre deploys, uma cláusula de contrato que alguém editou sem controle de alterações, uma linha de log que é quase, mas não exatamente, a de ontem.

A tentação é olhar com os próprios olhos. Isso funciona para três linhas e falha silenciosamente para trinta, porque a atenção humana é extremamente boa em ver o que espera ver. Um diff não é uma conveniência nessa situação; é a diferença entre encontrar a mudança e se convencer de que ela não existe.

O que torna uma ferramenta de diff boa é a granularidade. A comparação por linha é o padrão certo e é o que o controle de versão mostra, mas ela engana de verdade em duas classes de entrada: arquivos minificados ou de linha única, em que o documento inteiro é uma linha e o diff degenere em “esta linha mudou”; e linhas longas de prosa, em que uma edição de uma palavra pinta um parágrafo inteiro como reescrito. Os modos de palavra e de caractere existem precisamente para esses casos, e poder alternar entre os três sem recolar o texto é a maior parte do valor.

A outra metade é que a saída precisa ser portátil. Um diff que você só consegue olhar vale menos do que um que você pode entregar para outra pessoa, então a exportação de patch unificado produz um patch padrão com cabeçalhos de hunk apropriados — o formato que o patch(1) aceita e o formato que uma ferramenta de code review renderiza corretamente quando você cola em um comentário.

Texto costuma ser a coisa mais sensível deste site. Um payload de JSON é geralmente dado de máquina; um diff de texto frequentemente é um rascunho de contrato, um memorando interno, uma linha do tempo de incidente ou um e-mail de cliente. É por isso que a comparação acontece no seu navegador e não em um servidor: não como um recurso, mas porque enviar esse material a um host desconhecido para responder a uma pergunta que você poderia responder localmente é um mau negócio a qualquer preço.

Se as duas coisas que você está comparando são JSON e não prosa, use o comparador de JSON em vez disso. Ele compara a estrutura analisada, e não o texto, então reformatar e reordenar chaves — o que um diff de texto reporta como centenas de mudanças — corretamente aparece como nenhuma mudança.