O alocador de testes detecta vazamentos

Um programa pode passar por todas as verificações de valores e ainda assim vazar memória por esquecer de liberá-la. O Zig oferece uma ferramenta de testes para detectar exatamente isso.

Dentro de um teste, você obtém um alocador especial em std.testing.allocator. Use-o sempre que seu código precisar alocar memória no heap.

O testing.allocator registra cada bloco que entrega. Quando o teste termina, ele verifica se cada bloco foi devolvido.

Se mesmo uma alocação não for liberada, o testing.allocator informa um vazamento e o teste falha, indicando a chamada free ausente.

Peça memória ao alocador como faria no código real. Aqui, alloc reserva um buffer de dez bytes que você deverá liberar depois.

Associe cada alocação a um defer que a libera. A limpeza é agendada imediatamente, portanto será executada mesmo que o teste falhe no meio do caminho.

Remova esse defer e o teste falhará com um relatório de vazamento. É assim que o allocator transforma um erro silencioso em uma falha evidente e corrigível.

O mesmo allocator verificado detecta a liberação do mesmo bloco duas vezes ou a liberação de uma memória que ele nunca entregou, situações que costumam causar falhas graves.

Funções que alocam recebem um parâmetro de alocador. Em um teste, passe testing.allocator a elas para que a memória também seja acompanhada.

O teste precisa liberar tudo o que sua função alocou. Adicione um defer logo após a chamada para usar free ou deinit nos dados retornados.

Como os vazamentos fazem a compilação falhar, cada teste aprovado comprova que sua memória foi devidamente liberada. Essa confiança é exclusiva de testing.allocator.

Você usou std.testing.allocator para detectar vazamentos e liberações duplicadas sem custo. Associe cada alloc a um defer free e seus testes permanecerão limpos. ✅