Pular para o conteúdo principal

difere

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: tests/lib.sh:134.

Compara dois arquivos normalizando CR e distinguindo igualdade, diferença e erro de diff.

Tipo: função Shell · Visibilidade: pública · Arquivo: tests/lib.sh.

Assinatura e expansão​

difere()

Como funciona​

Cria arquivos temporários normalizados com tr e interpreta o status de diff: igual retorna 1, diferente retorna 0, erro retorna 2.

Comentário do fonte​

Windows CRT writes stdout in text mode (LF becomes CRLF). Compare console lines, not the platform's newline spelling; keep the golden files LF-only. Use real temporary files: MSYS2 process-substitution paths are not portable.

Implementação​

difere() {
local esperado="$T_TMP/esperado.norm" obtido="$T_TMP/obtido.norm"
tr -d '\r' < "$1" > "$esperado" || return 1
tr -d '\r' < "$2" > "$obtido" || return 1
diff -q "$esperado" "$obtido" > /dev/null 2>&1
case "$?" in
0) return 1 ;;
1) return 0 ;;
*) echo "difere: diff falhou ao comparar '$1' e '$2'" >&2; return 2 ;;
esac
}

Como este símbolo aparece nos testes​

6 ocorrência(s) em 2 arquivo(s) de teste. Os links apontam para linhas exatas; os trechos mostram o contexto local. Uma menção não prova que todos os ramos foi executado.

tests/lib.sh​

Contexto: caso_execucao, mostra_diff, resultado_confere. Linhas: 153, 163, 173, 214, 236. Tipo de evidência: código; via difere.

Linhas 151–155 · abrir contexto

[ -f "$dir/esperado_rc.txt" ] && rc_esperado="$(cat "$dir/esperado_rc.txt")"
if [ "$rc" = "$rc_esperado" ] && ! difere "$dir/esperado.txt" "$saida"; then
if [ ! -f "$dir/esperado_stderr.txt" ] \
|| grep -qF -- "$(cat "$dir/esperado_stderr.txt")" "$erros"; then

Ver no GitHub

Linhas 161–165 · abrir contexto
[ -f "$dir/alternativo_rc.txt" ] && alt_rc="$(cat "$dir/alternativo_rc.txt")"
[ "$rc" = "$alt_rc" ] || return 1
difere "$dir/alternativo.txt" "$saida" && return 1
if [ -f "$dir/alternativo_stderr.txt" ]; then
grep -qF -- "$(cat "$dir/alternativo_stderr.txt")" "$erros" || return 1

Ver no GitHub

Linhas 171–175 · abrir contexto

mostra_diff() {
if ! difere "$1" "$2"; then
return
fi

Ver no GitHub

Linhas 212–216 · abrir contexto
if [ "$rc" != "$esperado_rc" ]; then
:
elif difere "$dir/esperado.txt" "$T_TMP/out0"; then
mostra_diff "$dir/esperado.txt" "$T_TMP/out0"
elif [ -f "$dir/esperado_stderr.txt" ]; then

Ver no GitHub

Linhas 234–238 · abrir contexto
if [ "$rc" != "$esperado_rc" ]; then
:
elif difere "$dir/esperado.txt" "$T_TMP/out1"; then
mostra_diff "$dir/esperado.txt" "$T_TMP/out1"
elif [ -f "$dir/esperado_stderr.txt" ]; then

Ver no GitHub

tests/run.sh​

Contexto: run.sh. Linhas: 287. Tipo de evidência: código; via difere.

Linhas 285–289 · abrir contexto
[ $? -eq 70 ] && t_ok "basicgolc arquivo inexistente falha" || t_falhou "basicgolc arquivo inexistente falha"
fi

# ===============================================================
# 02..08 — casos de execução por diretório

Ver no GitHub

Compiladores, padrão C e sistema operacional​

Nenhum ramo condicional externo foi detectado para este símbolo. A implementação é compartilhada no fonte; isso não certifica compiladores ou sistemas não executados.

  • Usa arquivos temporários reais em vez de process substitution para funcionar no MSYS2.
  • Runner Bash: requer Bash e utilitários Unix; no Windows o projeto usa Git Bash/MSYS2. Não é um script CMD/PowerShell.
Não confunda implementação com certificação

A matriz histórica distingue executado, compilado, avaliado e não testado. Consulte a matriz, os compiladores e os logs atuais dos workflows antes de chamar um alvo de suportado.

Perguntas frequentes​

Perguntas reunidas a partir da definição, do contrato editorial e dos testes de difere. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que difere faz?​

Compara dois arquivos normalizando CR e distinguindo igualdade, diferença e erro de diff.

Qual é a assinatura e o tipo de retorno de difere?​

Assinatura extraída de tests/lib.sh; visibilidade pública.

difere()

Como difere aparece em código real deste repositório?​

Uso extraído de tests/lib.sh:151, com as linhas vizinhas preservadas:


[ -f "$dir/esperado_rc.txt" ] && rc_esperado="$(cat "$dir/esperado_rc.txt")"
if [ "$rc" = "$rc_esperado" ] && ! difere "$dir/esperado.txt" "$saida"; then
if [ ! -f "$dir/esperado_stderr.txt" ] \
|| grep -qF -- "$(cat "$dir/esperado_stderr.txt")" "$erros"; then

Onde difere é exercitado nos testes?​

Há 6 ocorrência(s) em 2 arquivo(s): tests/lib.sh, tests/run.sh. Os links da seção de evidência apontam para a linha exata; uma menção não prova que todos os ramos foram executados.

difere depende de compilador, padrão C ou sistema operacional?​

difere é uma função de runner Bash: requer Bash e utilitários Unix; no Windows o projeto usa Git Bash/MSYS2, não CMD/PowerShell.

Ressalvas registradas: Usa arquivos temporários reais em vez de process substitution para funcionar no MSYS2.

O que acontece em caso de falha ou uso inválido?​

Não há ressalva editorial específica para este nome. O comportamento em falha é o do corpo/expansão mostrado acima; não invente validação que o fonte não faz.