Go テスト

このスキルは、Go 固有のイディオムで一般的なテスト原則を拡張する包括的な Go テストパターンを提供します。

テストフレームワーク

標準の go test を使用し、テーブル駆動テスト を主要なパターンとして採用します。

テーブル駆動テスト

Go 標準のテストパターン:

func TestValidateEmail(t *testing.T) {
    tests := []struct {
        name    string
        email   string
        wantErr bool
    }{
        {
            name:    "valid email",
            email:   "user@example.com",
            wantErr: false,
        },
        {
            name:    "missing @",
            email:   "userexample.com",
            wantErr: true,
        },
        {
            name:    "empty string",
            email:   "",
            wantErr: true,
        },
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            err := ValidateEmail(tt.email)
            if (err != nil) != tt.wantErr {
                t.Errorf("ValidateEmail(%q) error = %v, wantErr %v",
                    tt.email, err, tt.wantErr)
            }
        })
    }
}

メリット:

• 新しいテストケースを簡単に追加可能
• テストケースの説明が明確
• t.Parallel() による並列テスト実行
• t.Run() による独立したサブテスト

テストヘルパー

ヘルパー関数に t.Helper() を指定:

func assertNoError(t *testing.T, err error) {
    t.Helper()
    if err != nil {
        t.Fatalf("unexpected error: %v", err)
    }
}

func assertEqual(t *testing.T, got, want interface{}) {
    t.Helper()
    if !reflect.DeepEqual(got, want) {
        t.Errorf("got %v, want %v", got, want)
    }
}

メリット:

• テスト失敗時に正確な行番号を表示
• 再利用可能なテストユーティリティ
• テストコードが清潔になる

テストフィクスチャ

リソースのクリーンアップに t.Cleanup() を使用:

func testDB(t *testing.T) *sql.DB {
    t.Helper()

    db, err := sql.Open("sqlite3", ":memory:")
    if err != nil {
        t.Fatalf("failed to open test db: %v", err)
    }

    // テスト完了後にクリーンアップが実行される
    t.Cleanup(func() {
        if err := db.Close(); err != nil {
            t.Errorf("failed to close db: %v", err)
        }
    })

    return db
}

func TestUserRepository(t *testing.T) {
    db := testDB(t)
    repo := NewUserRepository(db)
    // ... テストロジック
}

レース検出

データレースを検出するために、常に -race フラグでテストを実行:

go test -race ./...

CI/CD:

- name: Test with race detector
  run: go test -race -timeout 5m ./...

理由:

• 同時実行アクセスのバグを検出
• 本番環境でのレース条件を防止
• テストでのパフォーマンスオーバーヘッドは最小限

カバレッジ分析

基本的なカバレッジ

go test -cover ./...

詳細なカバレッジレポート

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

カバレッジ閾値

# カバレッジが80%未満の場合は失敗
go test -cover ./... | grep -E 'coverage: [0-7][0-9]\.[0-9]%' && exit 1

ベンチマーク

func BenchmarkValidateEmail(b *testing.B) {
    email := "user@example.com"

    b.ResetTimer()
    for i := 0; i < b.N; i++ {
        ValidateEmail(email)
    }
}

ベンチマーク実行:

go test -bench=. -benchmem

ベンチマーク比較:

go test -bench=. -benchmem > old.txt
# 変更を実施
go test -bench=. -benchmem > new.txt
benchstat old.txt new.txt

モッキング

インターフェースベースのモッキング

type UserRepository interface {
    GetUser(id string) (*User, error)
}

type mockUserRepository struct {
    users map[string]*User
    err   error
}

func (m *mockUserRepository) GetUser(id string) (*User, error) {
    if m.err != nil {
        return nil, m.err
    }
    return m.users[id], nil
}

func TestUserService(t *testing.T) {
    mock := &mockUserRepository{
        users: map[string]*User{
            "1": {ID: "1", Name: "Alice"},
        },
    }

    service := NewUserService(mock)
    // ... テストロジック
}

統合テスト

ビルドタグ

//go:build integration
// +build integration

package user_test

func TestUserRepository_Integration(t *testing.T) {
    // ... 統合テスト
}

統合テスト実行:

go test -tags=integration ./...

テストコンテナ

func TestWithPostgres(t *testing.T) {
    if testing.Short() {
        t.Skip("skipping integration test")
    }

    // テストコンテナのセットアップ
    ctx := context.Background()
    container, err := testcontainers.GenericContainer(ctx, ...)
    assertNoError(t, err)

    t.Cleanup(func() {
        container.Terminate(ctx)
    })

    // ... テストロジック
}

テスト構成

ファイル構成

package/
├── user.go
├── user_test.go          # ユニットテスト
├── user_integration_test.go  # 統合テスト
└── testdata/             # テストフィクスチャ
    └── users.json

パッケージ命名

// ブラックボックステスト (外部的観点)
package user_test

// ホワイトボックステスト (内部アクセス)
package user

一般的なパターン

HTTP ハンドラのテスト

func TestUserHandler(t *testing.T) {
    req := httptest.NewRequest("GET", "/users/1", nil)
    rec := httptest.NewRecorder()

    handler := NewUserHandler(mockRepo)
    handler.ServeHTTP(rec, req)

    assertEqual(t, rec.Code, http.StatusOK)
}

Context を使用したテスト

func TestWithTimeout(t *testing.T) {
    ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond)
    defer cancel()

    err := SlowOperation(ctx)
    if !errors.Is(err, context.DeadlineExceeded) {
        t.Errorf("expected timeout error, got %v", err)
    }
}

ベストプラクティス

1. t.Parallel() を使用 - 独立したテストのために
2. testing.Short() を使用 - 遅いテストをスキップするために
3. t.TempDir() を使用 - テンポラリディレクトリのために
4. t.Setenv() を使用 - 環境変数のために
5. テストファイルで init() を避ける
6. テストをシンプルに保つ - 1 つのテストに 1 つの動作
7. 意味のあるテスト名を使用 - テスト対象を説明する

このスキルを使用する場面

• 新しい Go テストの作成
• テストカバレッジの改善
• テストインフラの設定
• 不安定なテストのデバッグ
• テストパフォーマンスの最適化
• 統合テストの実装