@k2works/claude-code-booster 2.7.1 → 3.1.0

package/lib/assets/docs/article/getting-start-tdd/go/01-todo-list-and-first-test.md

@@ -0,0 +1,213 @@
+# 第 1 章: TODO リストと最初のテスト
+
+## 1.1 はじめに
+
+プログラムを作成するにあたって、まず何をすればよいでしょうか？私たちは、仕様を確認して **TODO リスト** を作るところから始めます。
+
+> TODO リスト
+>
+> 何をテストすべきだろうか——着手する前に、必要になりそうなテストをリストに書き出しておこう。
+>
+> — テスト駆動開発
+
+## 1.2 仕様の確認
+
+今回取り組む FizzBuzz 問題の仕様は以下の通りです。
+
+```
+1 から 100 までの数をプリントするプログラムを書け。
+ただし 3 の倍数のときは数の代わりに「Fizz」と、5 の倍数のときは「Buzz」とプリントし、
+3 と 5 両方の倍数の場合には「FizzBuzz」とプリントすること。
+```
+
+この仕様をそのままプログラムに落とし込むには少しサイズが大きいですね。最初の作業は仕様を **TODO リスト** に分解する作業から着手しましょう。
+
+## 1.3 TODO リストの作成
+
+仕様を分解して TODO リストを作成します。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - [ ] 1 を渡したら文字列 "1" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+まず「1 を渡したら文字列 "1" を返す」という、最も小さなタスクから取り掛かります。
+
+## 1.4 テスティングフレームワークの導入
+
+### テストファースト
+
+最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
+
+> テストファースト
+>
+> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
+>
+> — テスト駆動開発
+
+今回 Go のテスティングフレームワークには標準の [testing](https://pkg.go.dev/testing) パッケージを利用します。Go では外部ライブラリを追加することなく、標準パッケージだけでテストを書くことができます。
+
+### 開発環境のセットアップ
+
+Go Modules でプロジェクトを初期化し、テスト環境をセットアップします。
+
+```bash
+# プロジェクトの初期化
+$ mkdir -p apps/go/fizzbuzz
+$ cd apps/go
+$ go mod init github.com/k2works/getting-started-tdd/apps/go
+```
+
+Go のテストは `_test.go` というサフィックスを持つファイルに書きます。テスト関数は `Test` で始まり、`*testing.T` を引数に取ります。
+
+### 環境確認テスト
+
+環境が正しく設定されていることを確認するため、学習用テストを書きます。
+
+```go
+// fizzbuzz/learning_test.go
+package fizzbuzz
+
+import (
+	"strconv"
+	"testing"
+)
+
+// 学習用テスト: strconv.Itoa の使い方確認。
+func TestLearning_strconvItoa_整数を文字列へ変換できる(t *testing.T) {
+	got := strconv.Itoa(42)
+	want := "42"
+	if got != want {
+		t.Fatalf("strconv.Itoa(42) = %q, want %q", got, want)
+	}
+}
+```
+
+テストを実行します。
+
+```bash
+$ go test ./...
+ok  	github.com/k2works/getting-started-tdd/apps/go/fizzbuzz	0.5s
+```
+
+テストが通りました。Go の `testing` パッケージが正常に動作することが確認できました。Ruby の Minitest や Python の pytest のようなアサーションメソッドはありませんが、`if` 文と `t.Fatalf` で同等のテストが書けます。
+
+## 1.5 仮実装
+
+テスト環境の準備ができたので、TODO リストの最初の作業に取り掛かりましょう。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - **1 を渡したら文字列 "1" を返す**
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+まずはアサーションを最初に書きましょう。
+
+> アサートファースト
+>
+> いつアサーションを書くべきだろうか——最初に書こう。
+>
+> — テスト駆動開発
+
+### Red: 最初のテスト
+
+FizzBuzz のテストを書きます。
+
+```go
+// fizzbuzz/fizzbuzz_test.go
+package fizzbuzz
+
+import "testing"
+
+func TestGenerate_1を渡したら文字列1を返す(t *testing.T) {
+	got := Generate(1)
+	want := "1"
+	if got != want {
+		t.Fatalf("Generate(1) = %q, want %q", got, want)
+	}
+}
+```
+
+テストを実行します。
+
+```bash
+$ go test ./...
+# github.com/k2works/getting-started-tdd/apps/go/fizzbuzz
+fizzbuzz/fizzbuzz_test.go:6:9: undefined: Generate
+FAIL
+```
+
+`Generate` 関数が定義されていないためコンパイルエラーになりました。Go は静的型付け言語なので、Ruby と異なり未定義の関数はコンパイル時に検出されます。
+
+### Green: 仮実装
+
+テストを通すために **仮実装** から始めます。
+
+> 仮実装を経て本実装へ
+>
+> 失敗するテストを書いてから、最初に行う実装はどのようなものだろうか——ベタ書きの値を返そう。
+>
+> — テスト駆動開発
+
+`Generate` 関数を定義して、文字列リテラルを返します。
+
+```go
+// fizzbuzz/fizzbuzz.go
+package fizzbuzz
+
+// Generate は FizzBuzz の文字列を返します。
+func Generate(number int) string {
+	return "1"
+}
+```
+
+テストを実行します。
+
+```bash
+$ go test ./...
+ok  	github.com/k2works/getting-started-tdd/apps/go/fizzbuzz	0.5s
+```
+
+テストが通りました。こんなベタ書きのプログラムでいいの？と思われるかもしれませんが、この細かいステップに今しばらくお付き合いください。
+
+Go では関数名が大文字で始まる `Generate` はパッケージ外からアクセス可能な公開関数です。小文字で始まる関数は非公開になります。これは Ruby の `public`/`private` や Java のアクセス修飾子に相当する、Go 独自のカプセル化の仕組みです。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - [x] 1 を渡したら文字列 "1" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+ここまでの作業をバージョン管理システムにコミットしておきましょう。
+
+```bash
+$ git add .
+$ git commit -m 'test: 数を文字列にして返す'
+```
+
+## 1.6 まとめ
+
+この章では以下のことを学びました。
+
+- **TODO リスト** で仕様をプログラミング対象に分解する方法
+- **テストファースト** で最初にテストを書く考え方
+- Go の標準 `testing` パッケージを使ったテスト実行環境のセットアップ
+- **仮実装** でベタ書きの値を返してテストを通す手法
+- **アサートファースト** でテストの終わりから書き始めるアプローチ
+- Go の大文字/小文字による公開/非公開の仕組み
+
+次章では、2 つ目のテストケースを追加して **三角測量** を行い、プログラムを一般化していきます。

package/lib/assets/docs/article/getting-start-tdd/go/02-fake-it-and-triangulation.md

@@ -0,0 +1,302 @@
+# 第 2 章: 仮実装と三角測量
+
+## 2.1 はじめに
+
+前章では、FizzBuzz の仕様を TODO リストに分解し、最初のテストを仮実装で通しました。この章では、**三角測量** によってプログラムを一般化し、さらに FizzBuzz のコアロジックを実装していきます。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - [x] 1 を渡したら文字列 "1" を返す
+  - [ ] 2 を渡したら文字列 "2" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.2 三角測量
+
+1 を渡したら文字列 "1" を返すようにできました。では、2 を渡したらどうなるでしょうか？
+
+### Red: 2 つ目のテストを書く
+
+```go
+func TestGenerate_2を渡したら文字列2を返す(t *testing.T) {
+	got := Generate(2)
+	want := "2"
+	if got != want {
+		t.Fatalf("Generate(2) = %q, want %q", got, want)
+	}
+}
+```
+
+テストを実行します。
+
+```bash
+$ go test ./...
+--- FAIL: TestGenerate_2を渡したら文字列2を返す (0.00s)
+    fizzbuzz_test.go:14: Generate(2) = "1", want "2"
+FAIL
+```
+
+テストが失敗しました。文字列 "1" しか返さないプログラムなのですから当然です。
+
+### Green: 一般化する
+
+数値を文字列に変換して返すように修正します。Go では `strconv.Itoa` 関数で整数を文字列に変換できます（学習用テストで確認済み）。
+
+```go
+// fizzbuzz/fizzbuzz.go
+package fizzbuzz
+
+import "strconv"
+
+// Generate は FizzBuzz の文字列を返します。
+func Generate(number int) string {
+	return strconv.Itoa(number)
+}
+```
+
+テストを実行します。
+
+```bash
+$ go test ./...
+ok  	github.com/k2works/getting-started-tdd/apps/go/fizzbuzz	0.5s
+```
+
+テストが通りました！2 つ目のテストによって `Generate` 関数の一般化を実現できました。このようなアプローチを **三角測量** と言います。
+
+> 三角測量
+>
+> テストから最も慎重に一般化を引き出すやり方はどのようなものだろうか——2 つ以上の例があるときだけ、一般化を行うようにしよう。
+>
+> — テスト駆動開発
+
+Ruby では `number.to_s`、Python では `str(number)` と書くところを、Go では `strconv.Itoa(number)` を使います。Go は暗黙の型変換を許さない言語設計のため、明示的な変換関数が必要です。
+
+### Refactor: テストヘルパーの抽出
+
+テストコードに重複が見られます。アサーションのパターンが同じなので、ヘルパー関数を抽出しましょう。
+
+```go
+func assertGenerate(t *testing.T, input int, want string) {
+	t.Helper()
+	got := Generate(input)
+	if got != want {
+		t.Fatalf("Generate(%d) = %q, want %q", input, got, want)
+	}
+}
+
+func TestGenerate_1を渡したら文字列1を返す(t *testing.T) {
+	assertGenerate(t, 1, "1")
+}
+
+func TestGenerate_2を渡したら文字列2を返す(t *testing.T) {
+	assertGenerate(t, 2, "2")
+}
+```
+
+`t.Helper()` を呼ぶことで、テスト失敗時のスタックトレースがヘルパー関数ではなく呼び出し元を指すようになります。これは Ruby の Minitest で `assert_equal` が自動的に行っていることを、Go では明示的に指定する必要があるということです。
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+  - [x] 1 を渡したら文字列 "1" を返す
+  - [x] 2 を渡したら文字列 "2" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.3 3 の倍数 — Fizz
+
+次は「3 の倍数のときは数の代わりに Fizz と返す」に取り掛かります。
+
+### Red: 3 の倍数のテスト
+
+```go
+func TestGenerate_3を渡したらFizzを返す(t *testing.T) {
+	assertGenerate(t, 3, "Fizz")
+}
+```
+
+```bash
+$ go test ./...
+--- FAIL: TestGenerate_3を渡したらFizzを返す (0.00s)
+    fizzbuzz_test.go:8: Generate(3) = "3", want "Fizz"
+FAIL
+```
+
+### Green: 明白な実装
+
+3 の倍数のときは "Fizz" を返すように実装します。Go では `%` 演算子で剰余を求め、`== 0` でゼロかどうかを判定します。
+
+```go
+// fizzbuzz/fizzbuzz.go
+package fizzbuzz
+
+import "strconv"
+
+// Generate は FizzBuzz の文字列を返します。
+func Generate(number int) string {
+	if number%3 == 0 {
+		return "Fizz"
+	}
+	return strconv.Itoa(number)
+}
+```
+
+```bash
+$ go test ./...
+ok  	github.com/k2works/getting-started-tdd/apps/go/fizzbuzz	0.5s
+```
+
+三角測量として 6 のテストも追加して確認します。
+
+```go
+func TestGenerate_6を渡したらFizzを返す(t *testing.T) {
+	assertGenerate(t, 6, "Fizz")
+}
+```
+
+```bash
+$ go test ./...
+ok  	github.com/k2works/getting-started-tdd/apps/go/fizzbuzz	0.5s
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.4 5 の倍数 — Buzz
+
+### Red: 5 の倍数のテスト
+
+```go
+func TestGenerate_5を渡したらBuzzを返す(t *testing.T) {
+	assertGenerate(t, 5, "Buzz")
+}
+```
+
+```bash
+$ go test ./...
+--- FAIL: TestGenerate_5を渡したらBuzzを返す (0.00s)
+    fizzbuzz_test.go:8: Generate(5) = "5", want "Buzz"
+FAIL
+```
+
+### Green: Buzz の実装
+
+```go
+func Generate(number int) string {
+	if number%3 == 0 {
+		return "Fizz"
+	}
+	if number%5 == 0 {
+		return "Buzz"
+	}
+	return strconv.Itoa(number)
+}
+```
+
+```bash
+$ go test ./...
+ok  	github.com/k2works/getting-started-tdd/apps/go/fizzbuzz	0.5s
+```
+
+三角測量として 10 のテストも追加します。
+
+```go
+func TestGenerate_10を渡したらBuzzを返す(t *testing.T) {
+	assertGenerate(t, 10, "Buzz")
+}
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.5 15 の倍数 — FizzBuzz
+
+### Red: 15 の倍数のテスト
+
+```go
+func TestGenerate_15を渡したらFizzBuzzを返す(t *testing.T) {
+	assertGenerate(t, 15, "FizzBuzz")
+}
+```
+
+```bash
+$ go test ./...
+--- FAIL: TestGenerate_15を渡したらFizzBuzzを返す (0.00s)
+    fizzbuzz_test.go:8: Generate(15) = "Fizz", want "FizzBuzz"
+FAIL
+```
+
+15 は 3 の倍数でもあるため、"Fizz" が返されてしまいました。3 と 5 の両方の倍数の判定を先に行う必要があります。
+
+### Green: FizzBuzz の実装
+
+Go の `switch` 文を使って、条件分岐を整理します。
+
+```go
+// fizzbuzz/fizzbuzz.go
+package fizzbuzz
+
+import "strconv"
+
+// Generate は FizzBuzz の文字列を返します。
+func Generate(number int) string {
+	switch {
+	case number%15 == 0:
+		return "FizzBuzz"
+	case number%3 == 0:
+		return "Fizz"
+	case number%5 == 0:
+		return "Buzz"
+	default:
+		return strconv.Itoa(number)
+	}
+}
+```
+
+```bash
+$ go test ./...
+ok  	github.com/k2works/getting-started-tdd/apps/go/fizzbuzz	0.5s
+```
+
+Go の `switch` 文は式なしで使うことができ、各 `case` に条件式を書けます。Ruby のガード節（`return ... if`）や Java の `if-else if-else` チェーンに相当しますが、Go ではフォールスルーしない（`break` が不要）ため、より安全に条件分岐を記述できます。
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.6 まとめ
+
+この章では以下のことを学びました。
+
+- **三角測量** で 2 つ以上の例を使ってプログラムを一般化する手法
+- Go の `strconv.Itoa` 関数による整数から文字列への変換
+- Go の `%` 演算子による剰余判定
+- Go の式なし `switch` 文による条件分岐
+- `t.Helper()` によるテストヘルパー関数の作成
+- Red-Green-Refactor サイクルを繰り返してコアロジックを段階的に構築する方法
+
+次章では、残りの TODO（リスト生成とプリント）を実装し、リファクタリングで「動作するきれいなコード」を目指します。