Go в примерах: Тестирование (Testing)

Unit тестирование является важной частью написания правильных программ Go. Пакет тестирования testing предоставляет инструменты, необходимые для написания unit тестов, а команда go test запускает тесты.

Для наглядности этот код находится в main пакете, но это может быть любой пакет. Тестовый код обычно находится в том же пакете, что и код, который он тестирует.

package main
import (
    "fmt"
    "testing"
)

Мы будем тестировать эту простую реализацию целочисленного минимума. Обычно код, который мы тестируем, находится в исходном файле с именем что-то вроде intutils.go, а тестовый файл для него будет называться intutils_test.go.

func IntMin(a, b int) int {
    if a < b {
        return a
    } else {
        return b
    }
}

Тест создается путем написания функции с именем, начинающимся с Test.

func TestIntMinBasic(t *testing.T) {
    ans := IntMin(2, -2)
    if ans != -2 {

t.Error* сообщит об ошибках теста, но продолжит выполнение теста. t.Fail* сообщит об ошибках теста и немедленно остановит тест.

        t.Errorf("IntMin(2, -2) = %d; want -2", ans)
    }
}

Написание тестов может быть повторяющимся, поэтому идиоматично использовать table-driven style, где тестовые входы и ожидаемые выходы перечислены в таблице, а один цикл проходит по ним и выполняет тестовую логику.

func TestIntMinTableDriven(t *testing.T) {
    var tests = []struct {
        a, b int
        want int
    }{
        {0, 1, 0},
        {1, 0, 0},
        {2, -2, -2},
        {0, -1, -1},
        {-1, 0, -1},
    }

t.Run позволяет запускать «подтесты», по одному для каждой записи таблицы. Они показываются отдельно при выполнении go test -v.

    for _, tt := range tests {
        testname := fmt.Sprintf("%d,%d", tt.a, tt.b)
        t.Run(testname, func(t *testing.T) {
            ans := IntMin(tt.a, tt.b)
            if ans != tt.want {
                t.Errorf("got %d, want %d", ans, tt.want)
            }
        })
    }
}

Run all tests in the current project in verbose mode.

$ go test -v
== RUN   TestIntMinBasic
--- PASS: TestIntMinBasic (0.00s)
=== RUN   TestIntMinTableDriven
=== RUN   TestIntMinTableDriven/0,1
=== RUN   TestIntMinTableDriven/1,0
=== RUN   TestIntMinTableDriven/2,-2
=== RUN   TestIntMinTableDriven/0,-1
=== RUN   TestIntMinTableDriven/-1,0
--- PASS: TestIntMinTableDriven (0.00s)
    --- PASS: TestIntMinTableDriven/0,1 (0.00s)
    --- PASS: TestIntMinTableDriven/1,0 (0.00s)
    --- PASS: TestIntMinTableDriven/2,-2 (0.00s)
    --- PASS: TestIntMinTableDriven/0,-1 (0.00s)
    --- PASS: TestIntMinTableDriven/-1,0 (0.00s)
PASS
ok      examples/testing    0.023s

Следующий пример: Аргументы командной строки (Command-Line Arguments).