Asserções com std.testing

Os auxiliares de asserção do Zig ficam em std.testing. Importe-o com um nome curto para que cada verificação fique clara dentro dos seus blocos de teste.

O auxiliar mais simples é expect. Ele recebe um booleano e faz o teste falhar quando essa condição é falsa.

Todo auxiliar de teste retorna um erro quando falha, então você sempre o prefixa com try. É isso que faz o teste parar e informar o problema.

Para comparar dois valores, use expectEqual. Ele verifica a igualdade e, em caso de falha, exibe tanto o valor esperado quanto o valor real.

Com expectEqual, o primeiro argumento é o valor esperado e o segundo é o que seu código produziu. A ordem define a mensagem de falha.

Duas fatias são iguais quando seus elementos correspondem, não quando seus ponteiros são iguais. Use expectEqualSlices e informe o tipo dos elementos.

Para texto, expectEqualStrings compara duas fatias de bytes e exibe uma diferença legível quando elas divergem, o que é perfeito para verificar saídas.

Às vezes, uma chamada deve falhar. Envolva-a em expectError para verificar que ela retorna um erro específico, e não um valor.

Valores de ponto flutuante raramente coincidem exatamente. Use expectApproxEqAbs com uma pequena tolerância para que diferenças mínimas de arredondamento não façam seu teste falhar.

Quando uma asserção falha, o Zig exibe os valores esperado e real diretamente no relatório. Essa diferença geralmente aponta diretamente para o erro.

Combine o auxiliar com os dados: expectEqual para escalares, auxiliares de fatias e strings para sequências e expectError para o caminho de falha.

Você precisa verificar que dois valores de texto são exatamente iguais em um teste. Qual auxiliar é mais adequado?

Você aprendeu sobre o conjunto de ferramentas std.testing: expect, expectEqual, verificações de fatias e strings, além de expectError. Cada um precisa de try antes. ✅