Kaip testuoti Go kodą?

Question

Accepted Answer

Go turi **įtaisytą testavimą** per `testing` paketą ir `go test` komandą — nereikalinga jokia išorinė sistema. Testai gyvena `_test.go` failuose, o Go stipriai pabrėžia **lentelės pagrindu grindžiamus testus**, etalonus ir gerą įrankiaviką kaip pirmaeilės funkcijas.

## Pagrindinis testas

```go
// math.go
func Add(a, b int) int { return a + b }

// math_test.go — same package, _test.go suffix
import "testing"

func TestAdd(t *testing.T) {     // Test prefix + *testing.T parameter
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("Add(2,3) = %d; want 5", result)   // report failure (continues)
        // t.Fatalf stops the test immediately
    }
}
// run with: go test  (or `go test -v` for verbose, `go test ./...` for all packages)
```

Testavimo funkcija prasideda `Test`, priima `*testing.T` ir praneša apie gedimus per `t.Errorf`/`t.Fatalf`. Nėra jokių assertion raktažodžių — jūs tikriname sąlygas paprastu `if` ir pranešate apie gedimus (Go palaiko šį eksplicitų stilių).

## Lentelės pagrindu grindžiami testai — idiomatinis Go modelis

```go
func TestAdd(t *testing.T) {
    tests := []struct {           // a table of test CASES
        name     string
        a, b     int
        expected int
    }{
        {"positives", 2, 3, 5},
        {"with zero", 0, 5, 5},
        {"negatives", -1, -1, -2},
    }
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {     // a SUBTEST per case (named, isolated)
            if got := Add(tt.a, tt.b); got != tt.expected {
                t.Errorf("Add(%d,%d) = %d; want %d", tt.a, tt.b, got, tt.expected)
            }
        })
    }
}
```

**Lentelės pagrindu grindžiami testai** yra dominuojanti Go idioma — apibrėžkite atvejų dalį, peržiūrėkite jas su `t.Run` potestiais. Tai daro atvejų pridėjimą trivialų ir suteikia aiškią, individualią sėkmės/nesėkmės ataskaitą kiekvienam atvejui.

## Etalonai — įtaisyta veiklos testavimas

```go
func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {     // the framework chooses b.N for statistical accuracy
        Add(2, 3)
    }
}
// go test -bench=. → reports ns/op (and -benchmem for allocations)
```

## Padengimas ir kiti įrankiai

```bash
go test -cover                    # coverage percentage
go test -coverprofile=c.out       # then: go tool cover -html=c.out (visual report)
go test -race                     # the RACE DETECTOR — finds data races (crucial for concurrency)
go test -run TestAdd              # run specific tests
```

**`-race` žyma** yra ypač svarbi — ji aptinka duomenų lenktynes lygiagretaus kodo, svarbus įrankis atsižvelgiant į Go lygiagretumą.

## Testavimo pagalbininkai ir sąranka

```go
func TestMain(m *testing.M) {     // package-level setup/teardown
    setup()
    code := m.Run()
    teardown()
    os.Exit(code)
}
// t.Helper() marks a function as a test helper (better failure line reporting)
// httptest package for testing HTTP handlers; interfaces for mocking dependencies
```

## Kodėl tai svarbu

Testavimas yra pirmaeilė, įtaisyta Go dalis — `testing` paketas ir `go test` nereikalauja jokios išorinės sistemos, atspindėdamas Go akcentą testavimui kaip pagrindinei praktikai.

Suprasti šiuos susitarimus yra būtina kasdienė žinija: `_test.go` failas ir `TestXxx(t *testing.T)` struktūra, eksplicitus (be assert) gedimų pranešimo stilius ir ypač **lentelės pagrindu grindžiami testai** modelis, kuris dominuoja idiomatiniame Go kode (kompaktiškai aprėpiant daug atvejų su aiškia kiekvieno atvejo ataskaitą per potestius).
Tolygiai svarbu yra Go įtaisyti **etalonai** (veikla kaip testuojama sąlyga) ir galinga **įrankiaviką** — padengimo analizė ir ypač **`-race` detektorius**, kuris randa duomenų lenktynes lygiagretaus kodo (gyvybiškai svarbu atsižvelgiant į Go lygiagretumą sunkų naudojimą).

Žinoti, kaip parašyti veiksmingus, idiomatinus Go testus, naudoti `race` detektorių ir panaudoti `httptest`/sąsajas tikriems komponentams testuoti, yra profesionalo Go kūrimo požymis ir dažna tema, atspindinti kodo kokybės žinojimą.