t *testing.T は どこからやってくるの？

The Go gopher was designed by Renée French.

https://gotalk.connpass.com/event/388084/

Transcript

1. t *testing.T は どこからやってくるの？ おーたかこーたろー / @otakakot 2026.04.22 Go Connect #12 The Go gopher was designed by Renée French.
2. ある日... #goconnect
3. データベースを使ったテストを 実装していたときの話 #goconnect
4. #goconnect
5. context canceled が発生して クリーンアップ処理に失敗 #goconnect
6. pgx パッケージを確認 #goconnect
7. t.Context() がキャンセルされている #goconnect
8. Bad! Good! #goconnect
9. t.Cleanup() では t.Context() は キャンセル済み！ #goconnect
10. ところで... #goconnect
11. この t *testing.Tはどこからくるのか #goconnect
12. そもそも Go は main パッケージの main 関数が実行されるんでしょ #goconnect
13. #goconnect
14. なぜこのコードは動く ... ??? #goconnect
15. TextXxx は黒魔術...??? #goconnect
16. go test が動く仕組み #goconnect
17. おさらい #goconnect
18. #goconnect How to Write Go Code #Testing go test コマンドと testing パッケージ _test.go で終わるファイル func TestXXX(t *testing.T) 関数 https://go.dev/doc/code#Testing
19. #goconnect https://go.dev/doc/code#Testing
20. 結論 #goconnect
21. #goconnect go test は ... テスト関数を呼び出す Go コード （main関数）を自動生成し コンパイルして実行している！
22. 全体像 go test コマンド実行 ファイルの分類・関数の収集 _testmain.go の生成 ビルド 実行 #goconnect
23. 注釈 ステップ数はおーたかによる解釈 #goconnect
24. サンプルコード #goconnect
25. go version Go 1.26.2 #goconnect
26. パッケージ構成 #goconnect
27. #goconnect
28. #goconnect
29. #goconnect
30. 注釈 Go 本体のコードを引用しますが スライドの都合で省略しています 詳しくはURLを添付しているので そちらをご参照ください #goconnect
31. go test コマンド実行 #goconnect
32. 概要 go コマンドが test サブコマンドを呼び テスト処理を実行する #goconnect
33. 軽く解説 #goconnect
34. #goconnect ざっくりの流れ... go コマンド → test サブコマンド https://github.com/golang/go/blob/go1.26.2/src/cmd/go/main.go
35. #goconnect ざっくりの流れ... func runTest(...) に到達 https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/test/test.go
36. rutTest() 関数は パッケージごとに build → run → print を行うオーケストレーション #goconnect
37. build 処理にて テスト対象ファイル・関数を収集する Import(...) 関数に到達 #goconnect
38. #goconnect ファイルの分類・関数の収集
39. 概要 ファイル名とパッケージ宣言で分類 テスト名をもとにテスト関数を収集 #goconnect
40. ファイルとパッケージの分類 ファイル名が _test.go で終わるか パッケージ宣言が _test で終わるか #goconnect
41. グルーピング ファイル名 パッケージ宣言 GoFiles ex) calc.go ex) package calc TestGoFiles ex) calc_test.go ex) package calc XTestGoFiles ex) calc_x_test.go ex) package calc_test #goconnect
42. グルーピング ファイル名 パッケージ宣言 GoFiles ex) calc.go ex) package calc TestGoFiles ex) calc_test.go ex) package calc XTestGoFiles ex) calc_x_test.go ex) package calc_test pxtest ptest #goconnect
43. 各パッケージからテスト関数を AST により収集 #goconnect
44. #goconnect ptest, pxtest を for ループ https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L584-L593
45. #goconnect テスト関数を管理する構造体 https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L626-L638
46. #goconnect ファイル内の関数をループ https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L702-L773
47. #goconnect 命名規則チェック 関数の型チェック https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L702-L773
48. #goconnect https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L584-L593
49. #goconnect 型チェック ジェネリクス禁止 https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L775-L788
50. #goconnect 戻り値・引数チェック ポインタチェック 型名チェック https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L557-L579
51. 以下のテスト関数を収集 ptest.TestAdd(t *testing.T) ptest.TestSub(t *testing.T) pxtest.TestAdd(t *testing.T) #goconnect
52. _testmain.go の生成 #goconnect
53. 概要 テスト関数を実行する main () 関数を生成する #goconnect
54. Go Template を使ったコード生成 testFuncs 構造体を受け取る testmainTmpl #goconnect
55. #goconnect https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L790-L862
56. #goconnect https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L790-L862
57. #goconnect https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L790-L862
58. #goconnect Go Template によるコード生成 https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/load/test.go#L617-L624
59. 生成されるテスト実行コード #goconnect
60. _testmain.go の確認方法 go test -work WORK=xxxx #goconnect
61. #goconnect https://github.com/golang/go/blob/go1.26.2/src/testing/testing.go#L2319-L2329
62. #goconnect https://github.com/golang/go/blob/go1.26.2/src/testing/testing.go#L2340-L2487
63. #goconnect https://github.com/golang/go/blob/go1.26.2/src/testing/testing.go#L2551-L2598
64. t *testing.T は自動生成するコードで テストを動かす MainStart(..).Run() 関数 からやってくる！ #goconnect
65. #goconnect https://github.com/golang/go/blob/go1.26.2/src/testing/testing.go#L1876-L2042
66. ビルド #goconnect
67. 概要 リスト化したパッケージをもとに 実行可能バイナリを生成する #goconnect
68. 省略！ go build と同じ仕組みを利用 バイナリの命名が異なる （.test が付与） #goconnect
69. 実行 #goconnect
70. 概要 生成したテストバイナリを 子プロセスとして実行 #goconnect
71. #goconnect https://github.com/golang/go/blob/go1.26.2/src/cmd/go/internal/test/test.go#L1435-L1774
72. テスト実行完了！ #goconnect
73. まとめ #goconnect
74. #goconnect go test は黒魔術ではなく go template と AST を愚直に使った コード自動生成による main 関数の実行
75. 2020.04 2021.04 2022.11 Kotaro Otaka おーたかこーたろー / @otakakot Web Engineer 新卒入社 Hello Golang! Web Engineer ＠株式会社ビットキー Gopher６年生 #goconnect
76. おわり またどこかで お会いしましょう！