Goユニットテスト: 構造とベストプラクティス

package calculator

import "testing"
// 非公開関数や変数にアクセス可能

package calculator_test

import (
    "testing"
    "myproject/calculator"
)
// みたびに公開された関数のみにアクセス可能（パブリックAPI向けに推奨）

package calculator

import "testing"

// テスト関数は"Test"で始まる
func TestAdd(t *testing.T) {
    result := Add(2, 3)
    expected := 5
    
    if result != expected {
        t.Errorf("Add(2, 3) = %d; want %d", result, expected)
    }
}

func TestCalculate(t *testing.T) {
    tests := []struct {
        name     string
        a, b     int
        op       string
        expected int
        wantErr  bool
    }{
        {"加算", 2, 3, "+", 5, false},
        {"減算", 5, 3, "-", 2, false},
        {"乗算", 4, 3, "*", 12, false},
        {"除算", 10, 2, "/", 5, false},
        {"ゼロによる除算", 10, 0, "/", 0, true},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            result, err := Calculate(tt.a, tt.b, tt.op)
            
            if (err != nil) != tt.wantErr {
                t.Errorf("Calculate() error = %v, wantErr %v", err, tt.wantErr)
                return
            }
            
            if result != tt.expected {
                t.Errorf("Calculate(%d, %d, %q) = %d; want %d", 
                    tt.a, tt.b, tt.op, result, tt.expected)
            }
        })
    }
}

# 現在のディレクトリのテストを実行
go test

# 詳細な出力を表示
go test -v

# すべてのサブディレクトリのテストを実行
go test ./...

# 特定のテストを実行
go test -run TestAdd

# パターンに一致するテストを実行
go test -run TestCalculate/addition

# 並列実行（デフォルトはGOMAXPROCS）
go test -parallel 4

# タイムアウト付きでテストを実行
go test -timeout 30s

# カバレッジ付きでテストを実行
go test -cover

# カバレッジプロファイルを生成
go test -coverprofile=coverage.out

# ブラウザでカバレッジを表示
go tool cover -html=coverage.out

# 関数ごとのカバレッジを表示
go tool cover -func=coverage.out

# カバレッジモードを設定（set, count, atomic）
go test -covermode=count -coverprofile=coverage.out

func assertEqual(t *testing.T, got, want int) {
    t.Helper() // この行は呼び出し元として報告
    if got != want {
        t.Errorf("got %d, want %d", got, want)
    }
}

func TestMath(t *testing.T) {
    result := Add(2, 3)
    assertEqual(t, result, 5) // エラーラインはここを指す
}

func TestMain(m *testing.M) {
    // セットアップコード
    setup()
    
    // テストを実行
    code := m.Run()
    
    // テアダウンコード
    teardown()
    
    os.Exit(code)
}

func setupTestCase(t *testing.T) func(t *testing.T) {
    t.Log("テストケースのセットアップ")
    return func(t *testing.T) {
        t.Log("テストケースのテアダウン")
    }
}

func TestSomething(t *testing.T) {
    teardown := setupTestCase(t)
    defer teardown(t)
    
    // テストコード
}

// 本番コード
type Database interface {
    GetUser(id int) (*User, error)
}

type UserService struct {
    db Database
}

func (s *UserService) GetUserName(id int) (string, error) {
    user, err := s.db.GetUser(id)
    if err != nil {
        return "", err
    }
    return user.Name, nil
}

// テストコード
type MockDatabase struct {
    users map[int]*User
}

func (m *MockDatabase) GetUser(id int) (*User, error) {
    if user, ok := m.users[id]; ok {
        return user, nil
    }
    return nil, errors.New("user not found")
}

func TestGetUserName(t *testing.T) {
    mockDB := &MockDatabase{
        users: map[int]*User{
            1: {ID: 1, Name: "Alice"},
        },
    }
    
    service := &UserService{db: mockDB}
    name, err := service.GetUserName(1)
    
    if err != nil {
        t.Fatalf("予期しないエラー: %v", err)
    }
    if name != "Alice" {
        t.Errorf("got %s, want Alice", name)
    }
}

import (
    "github.com/stretchr/testify/assert"
    "github.com/stretchr/testify/mock"
)

func TestWithTestify(t *testing.T) {
    result := Add(2, 3)
    assert.Equal(t, 5, result, "they should be equal")
    assert.NotNil(t, result)
}

// モックの例
type MockDB struct {
    mock.Mock
}

func (m *MockDB) GetUser(id int) (*User, error) {
    args := m.Called(id)
    return args.Get(0).(*User), args.Error(1)
}

func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Add(2, 3)
    }
}

// ベンチマークを実行
// go test -bench=. -benchmem

package user

import (
    "errors"
    "testing"
)

type User struct {
    ID    int
    Name  string
    Email string
}

func ValidateUser(u *User) error {
    if u.Name == "" {
        return errors.New("名前は空にできません")
    }
    if u.Email == "" {
        return errors.New("メールアドレスは空にできません")
    }
    return nil
}

// テストファイル: user_test.go
func TestValidateUser(t *testing.T) {
    tests := []struct {
        name    string
        user    *User
        wantErr bool
        errMsg  string
    }{
        {
            name:    "有効なユーザー",
            user:    &User{ID: 1, Name: "Alice", Email: "alice@example.com"},
            wantErr: false,
        },
        {
            name:    "名前が空",
            user:    &User{ID: 1, Name: "", Email: "alice@example.com"},
            wantErr: true,
            errMsg:  "名前は空にできません",
        },
        {
            name:    "メールアドレスが空",
            user:    &User{ID: 1, Name: "Alice", Email: ""},
            wantErr: true,
            errMsg:  "メールアドレスは空にできません",
        },
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            err := ValidateUser(tt.user)
            
            if (err != nil) != tt.wantErr {
                t.Errorf("ValidateUser() error = %v, wantErr %v", err, tt.want错误)
                return
            }
            
            if err != nil && err.Error() != tt.errMsg {
                t.Errorf("ValidateUser() error message = %v, want %v", err.Error(), tt.errMsg)
            }
        })
    }
}