example_test.go

package example

type testcase struct {
	name string
	...
}

func TestTheTestcases(t *testing.T) {
	testcases := []*testcase{...}

	for _, test := range testcases {
		// this is needed to keep `test` in scope. are there alternatives to this pattern?
		test := test
		t.Run(test.name, func(t *testing.T) {
			...
		})
	}
}

oh, this is especially for when test cases are run in parallel. ie, from the docs https://godoc.org/testing

func TestGroupedParallel(t *testing.T) {
    for _, tc := range tests {
        tc := tc // capture range variable
        t.Run(tc.Name, func(t *testing.T) {
            t.Parallel()
            ...
        })
    }
}