ペルソナ: あなたはテストを実行可能な仕様として扱うGoエンジニアです。カバレッジ目標を達成するのではなく、動作を制約し、失敗メッセージが自己説明的になるようにテストを書きます。

モード:

• 書き込みモード — 新しいテストやモックをコードベースに追加する
• レビューモード — testifyの誤用について既存のテストコードを監査する

stretchr/testify

testifyはGoのtestingパッケージを、読みやすいアサーション、モック、スイートで補完します。testingを置き換えるものではありません — 常に*testing.Tをエントリーポイントとして使用してください。

このスキルは網羅的ではありません。詳細情報については、ライブラリドキュメントとコード例を参照してください。Context7は発見可能性プラットフォームとしてサポートできます。

assert vs require

どちらも同じアサーションを提供します。違いは失敗時の動作です:

• assert: 失敗を記録して続行 — すべての失敗を一度に確認できる
• require: t.FailNow()を呼び出す — 続行するとパニックまたは誤解を招く前提条件に使用

可読性のためにassert.New(t) / require.New(t)を使用してください。isとmustと名前を付けます:

func TestParseConfig(t *testing.T) {
    is := assert.New(t)
    must := require.New(t)

    cfg, err := ParseConfig("testdata/valid.yaml")
    must.NoError(err)    // stop if parsing fails — cfg would be nil
    must.NotNil(cfg)

    is.Equal("production", cfg.Environment)
    is.Equal(8080, cfg.Port)
    is.True(cfg.TLS.Enabled)
}

ルール: requireは前提条件(セットアップ、エラーチェック)に、assertは検証に使用します。決してランダムに混在させないでください。

コアアサーション

is := assert.New(t)

// Equality
is.Equal(expected, actual)              // DeepEqual + exact type
is.NotEqual(unexpected, actual)
is.EqualValues(expected, actual)        // converts to common type first
is.EqualExportedValues(expected, actual)

// Nil / Bool / Emptiness
is.Nil(obj)                  is.NotNil(obj)
is.True(cond)                is.False(cond)
is.Empty(collection)         is.NotEmpty(collection)
is.Len(collection, n)

// Contains (strings, slices, map keys)
is.Contains("hello world", "world")
is.Contains([]int{1, 2, 3}, 2)
is.Contains(map[string]int{"a": 1}, "a")

// Comparison
is.Greater(actual, threshold)     is.Less(actual, ceiling)
is.Positive(val)                  is.Negative(val)
is.Zero(val)

// Errors
is.Error(err)                     is.NoError(err)
is.ErrorIs(err, ErrNotFound)      // walks error chain
is.ErrorAs(err, &target)
is.ErrorContains(err, "not found")

// Type
is.IsType(&User{}, obj)
is.Implements((*io.Reader)(nil), obj)

引数の順序: 常に(expected, actual) — 入れ替えると混乱させるdiff出力が生成されます。

高度なアサーション

is.ElementsMatch([]string{"b", "a", "c"}, result)             // unordered comparison
is.InDelta(3.14, computedPi, 0.01)                            // float tolerance
is.JSONEq(`{"name":"alice"}`, `{"name": "alice"}`)             // ignores whitespace/key order
is.WithinDuration(expected, actual, 5*time.Second)
is.Regexp(`^user-[a-f0-9]+$`, userID)

// Async polling
is.Eventually(func() bool {
    status, _ := client.GetJobStatus(jobID)
    return status == "completed"
}, 5*time.Second, 100*time.Millisecond)

// Async polling with rich assertions
is.EventuallyWithT(func(c *assert.CollectT) {
    resp, err := client.GetOrder(orderID)
    assert.NoError(c, err)
    assert.Equal(c, "shipped", resp.Status)
}, 10*time.Second, 500*time.Millisecond)

testify/mock

テスト対象のユニットを分離するためにインターフェースをモック化します。mock.Mockを埋め込み、m.Called()でメソッドを実装し、常にAssertExpectations(t)で検証します。

主要なマッチャー: mock.Anything, mock.AnythingOfType("T"), mock.MatchedBy(func). 呼び出し修飾子: .Once(), .Times(n), .Maybe(), .Run(func).

モック定義、引数マッチャー、呼び出し修飾子、戻り値シーケンス、検証については、Mockリファレンスを参照してください。

testify/suite

スイートは関連するテストを共有セットアップ/ティアダウンでグループ化します。

ライフサイクル

SetupSuite()    → once before all tests
  SetupTest()   → before each test
    TestXxx()
  TearDownTest() → after each test
TearDownSuite() → once after all tests

例

type TokenServiceSuite struct {
    suite.Suite
    store   *MockTokenStore
    service *TokenService
}

func (s *TokenServiceSuite) SetupTest() {
    s.store = new(MockTokenStore)
    s.service = NewTokenService(s.store)
}

func (s *TokenServiceSuite) TestGenerate_ReturnsValidToken() {
    s.store.On("Save", mock.Anything, mock.Anything).Return(nil)
    token, err := s.service.Generate("user-42")
    s.NoError(err)
    s.NotEmpty(token)
    s.store.AssertExpectations(s.T())
}

// Required launcher
func TestTokenServiceSuite(t *testing.T) {
    suite.Run(t, new(TokenServiceSuite))
}

s.Equal()などのスイートメソッドはassertのように動作します。require向けには: s.Require().NotNil(obj).

よくある間違い

• AssertExpectations(t)を忘れる — モック期待値は検証なしで暗黙的に成功する
• is.Equal(ErrNotFound, err) — ラップされたエラーで失敗します。チェーンを走査するためにis.ErrorIsを使用してください
• 引数の順序を入れ替える — testifyは(expected, actual)と想定します。入れ替えるとdiffが逆になります
• ガードでassertを使用する — テスト失敗後も続行されてnil参照でパニックします。requireを使用してください
• suite.Run()が欠落 — ランチャー関数なしでは、ゼロテストが暗黙的に実行されます
• ポインタを比較する — is.Equal(ptr1, ptr2)はアドレスを比較します。デリファレンスするかEqualExportedValuesを使用してください

リンター

testifylintを使用して、引数順序の誤り、assert/require誤用などを検出します。samber/cc-skills-golang@golang-lintスキルを参照してください。

相互参照

• → samber/cc-skills-golang@golang-testingスキルで一般的なテストパターン、テーブル駆動テスト、CIについて確認してください
• → samber/cc-skills-golang@golang-lintスキルで testifylint設定について確認してください