KDOC 332: Contextのテストを読むと理解しやすい

この文書のステータス

  • 作成
    • 2025-02-17 貴島
  • レビュー
    • 2025-02-17 貴島

概要

Contextは使い方を理解するのが難しい。Go本体のソースコードにあるテストが、使い方を端的に示していてわかりやすかった。例えを使って長々と説明するよりも、ミニマルなコード例を示すほうが、わかりやすいことがある。 

https://github.com/kd-collective/go/blob/19e923182e590ae6568c2c714f20f32512aeb3e3/src/context/context_test.go#L200-L205

ctx, _ := WithCancel(Background())
checkChildren("after creation", ctx, 0)
_, cancel := WithCancel(ctx)
checkChildren("with WithCancel child ", ctx, 1)
cancel()
checkChildren("after canceling WithCancel child", ctx, 0)

関連

抽象。

  • 例え話で長く説明するより、最小のコード例のほうが使い方を端的に示す

関連。

  • 類似: KDOC 204: 知らない分野の学びかたを考える。文章の説明よりもコードそのものが理解の手がかりになるとみる点で共通する
  • 補足: 使い方の理解というより、Contextが必要になるケースをイメージできていなかった感がある
  • 具体例: わかりやすいという部分の具体的解説