teamai-test/.teamai/skills/common/golang-naming/references/testing.md

Test Naming

Test Functions

Test functions follow Test + the name of what is being tested. Use underscores for subcases.

func TestParseToken(t *testing.T) { ... }
func TestServer_Handle(t *testing.T) { ... }           // method test
func TestParseToken_InvalidInput(t *testing.T) { ... }  // subcase

Table-Driven Tests

Table-driven test case names SHOULD be fully lowercase, descriptive phrases — including acronyms. Use input for inputs and expected for expected outputs to make the data flow clear:

tests := []struct {
    name         string
    input        string
    expectedCode int
    expectedErr  bool
}{
    {name: "empty input", input: "", expectedCode: 400, expectedErr: true},
    {name: "valid token", input: "abc123", expectedCode: 200},
    {name: "expired token", input: "exp", expectedCode: 401, expectedErr: true},
    {name: "invalid id", input: "???", expectedCode: 400, expectedErr: true},  // "id" not "ID"
}

// Bad — mixed case in test names
{name: "valid ID", ...}      // should be "valid id"
{name: "Empty Input", ...}   // should be "empty input"

Test Helpers

Test helper functions that panic on failure conventionally use the must prefix: mustLoadFixture(), mustParseURL().