difere
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
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
Linhas 171–175 · abrir contexto
mostra_diff() {
if ! difere "$1" "$2"; then
return
fi
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
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
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
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.
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.