0Pricing
Zig Academy · Aula

Executando e filtrando testes

Use zig test e restrinja a execução.

Executando e filtrando testes é uma aula grátis de Zig Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Zig Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Zig Academy inclui 4 aulas no total.

Um comando para testar

Para executar os testes de um arquivo, você chama o compilador no modo de teste. O comando zig test compila e executa todos os blocos de teste que encontra.

zig test src/main.zig

Aponte para um arquivo

Você fornece ao zig test o arquivo-fonte raiz. Ele inclui os testes desse arquivo e de qualquer arquivo alcançado por @import.

Lendo o resumo

Após uma execução, o Zig informa quantos testes passaram. Uma linha como "All 7 tests passed" significa que todo bloco test terminou sem erro.

Quando um teste falha

Em caso de falha, o Zig exibe o nome do teste, a asserção que falhou e um rastreamento da pilha. O name escolhido é o que facilita a leitura.

Filtre por nome

Execute apenas os testes que interessam usando --test-filter. Somente os testes cujo nome contém o texto informado serão executados.

zig test src/main.zig --test-filter parse

Por que filtrar ajuda

Enquanto corrige uma funcionalidade, você executa novamente apenas os testes dela, recebendo feedback rapidamente. A opção --test-filter procura uma substring no nome do teste.

Ignore um teste de propósito

Retorne o erro especial error.SkipZigTest de um teste para marcá-lo como ignorado em vez de reprovado, algo útil para casos que ainda não estão prontos.

if (slow) return error.SkipZigTest;

Os testes ignorados são contabilizados separadamente

O resumo contabiliza os testes ignorados separadamente dos aprovados e reprovados, para que um skip nunca esconda um problema real no seu conjunto de testes.

Teste a partir da compilação

Em um projeto real, normalmente você executa os testes pelo sistema de compilação. Uma etapa zig build test configurada os compila e executa.

zig build test

Os testes não precisam de main

Um arquivo que contenha apenas blocos test e nenhuma função main ainda funciona com zig test. O executor de testes fornece o ponto de entrada para você.

Faça dos testes um hábito

Como executar os testes exige um único comando, você pode fazê-lo após cada alteração. O feedback rápido é o que mantém uma base de código Zig confiável.

Verificação rápida

Você quer executar apenas os testes cujos nomes mencionam a palavra parse. Qual comando faz isso?

Recapitulação

Você executou testes com zig test, leu o resumo, filtrou por nome, ignorou testes com error.SkipZigTest e conheceu zig build test. ✅

Perguntas Frequentes

A aula “Executando e filtrando testes” é grátis?

Sim — o texto completo de “Executando e filtrando testes” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Zig Academy, atualize para CoddyKit PRO. O curso de Zig Academy inclui 4 aulas no total.

O que vou aprender em “Executando e filtrando testes”?

Use zig test e restrinja a execução. Você pratica Zig Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Zig Academy?

Nenhuma experiência prévia é necessária. Zig Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Executando e filtrando testes”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Zig Academy?

Sim. Cada aula de Zig Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Escrevendo blocos test
  2. Asserções com std.testing
  3. O alocador de testes detecta vazamentos
  4. Executando e filtrando testes
← Voltar para Zig Academy