testing

Testing — паттерны тестирования

Паттерны тестирования для vmkteam Go-сервисов.

Принципы

• Фреймворк — как в соседних *_test.go пакета: стили в одном пакете не смешивай. В новых пакетах и проектах — t.Run + testify/assert + testify/require, table-driven для множественных кейсов. Существующие goconvey-тесты не переписывай ради переписывания
• Без моков — тестируем реальный транспорт, реальную базу
• TestDB префикс — тесты с БД именуются TestDB*
• test-short пропускает DB-тесты через regex Test[^D][^B]
• Покрытие — happy path и ошибочные пути: пустой ввод, слишком длинный, граничные значения, отсутствующая запись, повторный вызов. Непокрытый ошибочный путь — дыра
• Create проверяет поля базы — не только id и эхо входа, но и то, что заполняет база: createdAt, значения по умолчанию, вычисляемые колонки (сгенерированный Add их не возвращает, см. /mfd)
• Инварианты — если в задаче есть числовой или глобальный инвариант («≤ N», «суммарно», «во всех ветках»), первым пиши тест на худший случай (максимум полей, длины, количества) и убедись, что он падает на старом коде

Makefile targets

# Все тесты (включая DB)
test:
	@PGDATABASE=$(TEST_PGDATABASE) go test -count=1 $(GOFLAGS) -coverprofile=coverage.txt -covermode count $(PKG)

# Быстрые тесты (без DB) — пропускает TestDB*
test-short:
	@go test $(GOFLAGS) -v -test.short -test.run="Test[^D][^B]" -coverprofile=coverage.txt -covermode count $(PKG)

# Пересоздать тестовую БД
db-test:
	@dropdb --if-exists $(TEST_PGDATABASE)
	@createdb -E UTF-8 $(TEST_PGDATABASE)
	@psql -f docs/schema.sql $(TEST_PGDATABASE)

Канонический стиль (t.Run + testify)

import (
    "testing"

    "github.com/stretchr/testify/assert"
    "github.com/stretchr/testify/require"
)

func TestDBUserService(t *testing.T) {
    ctx := t.Context()
    srv := NewUserService(testDB)

    t.Run("CRUD", func(t *testing.T) {
        in := User{
            Login:    fmt.Sprintf("ivan_%d", time.Now().Unix()),
            Password: "pwd",
            StatusID: db.StatusEnabled,
        }

        out, err := srv.Add(ctx, in)
        require.NoError(t, err)
        require.NotNil(t, out)
        assert.Greater(t, out.ID, 0)

        got, err := srv.GetByID(ctx, out.ID)
        require.NoError(t, err)
        assert.Equal(t, in.Login, got.Login)

        got.Login = "updated"
        ok, err := srv.Update(ctx, *got)
        require.NoError(t, err)
        assert.True(t, ok)

        ok, err = srv.Delete(ctx, out.ID)
        require.NoError(t, err)
        assert.True(t, ok)
    })

    t.Run("empty login is rejected", func(t *testing.T) {
        _, err := srv.Add(ctx, User{Login: "", Password: "pwd", StatusID: db.StatusEnabled})
        require.Error(t, err)
    })
}