Go Academy · Aula

Cobertura de testes e testify

go test -cover e a biblioteca de asserções testify

Cobertura de testes e testify é uma aula grátis de Go 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 Go Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Go Academy inclui 4 aulas no total.

go test -cover

Adicione -cover a qualquer comando go test para exibir a porcentagem de cobertura de cada pacote.

go test -cover ./...
// ok  myapp 68.4% of statements

Perfil de cobertura

Gere um arquivo de perfil de cobertura e visualize-o como HTML para ver quais linhas estão cobertas:

go test -coverprofile=c.out ./...
go tool cover -html=c.out -o coverage.html

Limites de cobertura na CI

Imponha uma cobertura mínima com um comando de shell de uma linha:

pct=$(go test -cover ./... | awk '/coverage/ {gsub(/%/,""); print $NF}')
[ "${pct%.*}" -ge 80 ] || { echo "Coverage $pct% below 80%"; exit 1; }

100% de cobertura não é o objetivo

A cobertura mede quais linhas são executadas, não se as asserções são significativas. Busque uma cobertura alta nos caminhos críticos; aceite uma cobertura menor nos ramos de erro inalcançáveis.

testify/assert

github.com/stretchr/testify/assert fornece asserções legíveis que informam automaticamente os valores esperado e real:

assert.Equal(t, 42, result)
assert.NoError(t, err)
assert.Contains(t, list, "item")
assert.True(t, isValid)

testify/require

require é idêntico a assert, mas chama t.FailNow() em caso de falha, interrompendo imediatamente o teste (como t.Fatal).

require.NoError(t, err) // stop if err != nil
// Subsequent code only runs if err is nil

testify/suite

testify/suite agrupa testes relacionados em uma estrutura com configuração e limpeza compartilhadas, de modo semelhante aos conjuntos de testes xUnit:

type UserSuite struct { suite.Suite; db *DB }
func (s *UserSuite) SetupTest() { s.db = openTestDB() }
func (s *UserSuite) TestCreate() { /* ... */ }
func TestUserSuite(t *testing.T) { suite.Run(t, new(UserSuite)) }

assert.ElementsMatch

Compare fatias sem considerar a ordem:

assert.ElementsMatch(t, []int{3,1,2}, []int{1,2,3})

assert.JSONEq

Compare strings JSON independentemente da ordem das chaves:

assert.JSONEq(t, `{"a":1,"b":2}`, `{"b":2,"a":1}`)

Asserções personalizadas

Envolva testify em seus próprios auxiliares de asserção para acrescentar contexto do domínio às mensagens de falha:

func assertUserValid(t testing.TB, u *User) {
    t.Helper()
    assert.NotEmpty(t, u.Name)
    assert.Positive(t, u.ID)
}

Combinando cobertura com testify

O testify não afeta os relatórios de cobertura — a cobertura só considera se as linhas são executadas, independentemente da biblioteca de asserções utilizada.

Verificação rápida

Qual é a diferença entre testify/assert e testify/require?

Recapitulação: cobertura e testify

Pontos principais:

go test -cover; -coverprofile para gerar um relatório HTML
assert: continua após uma falha; require: interrompe após uma falha
testify/suite para testes agrupados com configuração compartilhada
Uma cobertura alta é boa; asserções significativas são melhores

Perguntas Frequentes

A aula “Cobertura de testes e testify” é grátis?

Sim — o texto completo de “Cobertura de testes e testify” é 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 Go Academy, atualize para CoddyKit PRO. O curso de Go Academy inclui 4 aulas no total.

O que vou aprender em “Cobertura de testes e testify”?

go test -cover e a biblioteca de asserções testify Você pratica Go 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 Go Academy?

Nenhuma experiência prévia é necessária. Go 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 “Cobertura de testes e testify”?

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 Go Academy?

Sim. Cada aula de Go 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

← Voltar para Go Academy