@k2works/claude-code-booster 2.7.1 → 3.1.0

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

@@ -0,0 +1,201 @@
+# 第 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 テスティングフレームワークの導入
+
+### テストファースト
+
+最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
+
+> テストファースト
+>
+> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
+>
+> — テスト駆動開発
+
+今回 Python のテスティングフレームワークには [pytest](https://docs.pytest.org/) を利用します。
+
+### 開発環境のセットアップ
+
+uv プロジェクトに pytest を追加して、テスト環境をセットアップします。
+
+```toml
+# pyproject.toml
+[project]
+name = "fizzbuzz"
+version = "0.1.0"
+description = "FizzBuzz TDD project for Python"
+requires-python = ">=3.11"
+
+[tool.pytest.ini_options]
+testpaths = ["test"]
+pythonpath = ["."]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+]
+```
+
+### 環境確認テスト
+
+環境が正しく設定されていることを確認するため、簡単なテストを書きます。
+
+```python
+# test/test_hello.py
+
+def test_greeting():
+    assert greeting() == "hello world"
+
+
+def greeting():
+    return "hello world"
+```
+
+テストを実行します。
+
+```bash
+$ uv run pytest -v
+```
+
+```
+test/test_hello.py::test_greeting PASSED
+
+1 passed
+```
+
+テストが成功すれば、開発環境のセットアップは完了です。
+
+## 1.5 最初のテストを書く
+
+### アサートファースト
+
+TODO リストの最初の項目「1 を渡したら文字列 "1" を返す」に取り掛かります。
+
+> アサートファースト
+>
+> いつアサーションを書くべきだろうか——最初に書こう。
+>
+> — テスト駆動開発
+
+テストコードを日本語で記述します。pytest では関数名にそのまま日本語を使えるため、ドキュメントとしての可読性が上がります。
+
+```python
+# test/test_fizzbuzz.py
+from lib.fizzbuzz import FizzBuzz
+
+
+class TestFizzBuzz:
+    def setup_method(self):
+        self.fizzbuzz = FizzBuzz()
+
+    def test_1を渡したら文字列1を返す(self):
+        assert self.fizzbuzz.generate(1) == "1"
+```
+
+### Red: テストを実行して失敗させる
+
+テストを実行します。
+
+```bash
+$ uv run pytest -v
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す FAILED
+
+E       ModuleNotFoundError: No module named 'lib.fizzbuzz'
+```
+
+`FizzBuzz` クラスが定義されていないというエラーが出ました。まだ作っていないのですから当然です。
+
+### Green: 仮実装でテストを通す
+
+最初のテストを通すために **仮実装** から始めましょう。
+
+> 仮実装を経て本実装へ
+>
+> 失敗するテストを書いてから、最初に行う実装はどのようなものだろうか——ベタ書きの値を返そう。
+>
+> — テスト駆動開発
+
+`FizzBuzz` クラスを定義して、文字列リテラルを返す `generate` メソッドを作成します。
+
+```python
+# lib/fizzbuzz.py
+class FizzBuzz:
+    def generate(self, number: int) -> str:
+        return "1"
+```
+
+テストを実行します。
+
+```bash
+$ uv run pytest -v
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す PASSED
+
+1 passed
+```
+
+テストが通りました！「え？こんなベタ書きのプログラムでいいの？」と思われるかもしれませんが、この細かいステップに今しばらくお付き合いください。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - [x] 1 を渡したら文字列 "1" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 1.6 まとめ
+
+この章では、TDD の最も基本的なステップを体験しました。
+
+1. **TODO リストの作成** — 仕様を小さなタスクに分解する
+2. **テストファースト** — テスト対象のコードを書く前にテストを書く
+3. **アサートファースト** — テストの終わりにパスすべきアサーションを最初に書く
+4. **仮実装** — 失敗するテストを通すために、ベタ書きの値を返す
+
+次の章では、三角測量によってプログラムを一般化していきます。

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

@@ -0,0 +1,247 @@
+# 第 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 つ目のテストを書く
+
+```python
+def test_2を渡したら文字列2を返す(self):
+    assert self.fizzbuzz.generate(2) == "2"
+```
+
+テストを実行します。
+
+```bash
+$ uv run pytest -v
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_2を渡したら文字列2を返す FAILED
+
+E       AssertionError: assert '1' == '2'
+```
+
+テストが失敗しました。文字列 "1" しか返さないプログラムなのですから当然です。
+
+### Green: 一般化する
+
+数値を文字列に変換して返すように修正します。
+
+```python
+# lib/fizzbuzz.py
+class FizzBuzz:
+    def generate(self, number: int) -> str:
+        return str(number)
+```
+
+テストを実行します。
+
+```bash
+$ uv run pytest -v
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_2を渡したら文字列2を返す PASSED
+
+2 passed
+```
+
+テストが通りました！2 つ目のテストによって `generate` メソッドの一般化を実現できました。このようなアプローチを **三角測量** と言います。
+
+> 三角測量
+>
+> テストから最も慎重に一般化を引き出すやり方はどのようなものだろうか——2 つ以上の例があるときだけ、一般化を行うようにしよう。
+>
+> — テスト駆動開発
+
+**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 の倍数のテスト
+
+```python
+def test_3を渡したら文字列Fizzを返す(self):
+    assert self.fizzbuzz.generate(3) == "Fizz"
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_3を渡したら文字列Fizzを返す FAILED
+
+E       AssertionError: assert '3' == 'Fizz'
+```
+
+### Green: 明白な実装
+
+3 の倍数の判定は明白なので、直接的に実装します。
+
+> 明白な実装
+>
+> シンプルな操作を実現するにはどうすればよいだろうか——そのまま実装しよう。
+>
+> — テスト駆動開発
+
+```python
+# lib/fizzbuzz.py
+class FizzBuzz:
+    def generate(self, number: int) -> str:
+        if number % 3 == 0:
+            return "Fizz"
+        return str(number)
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_2を渡したら文字列2を返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_3を渡したら文字列Fizzを返す PASSED
+
+3 passed
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.4 5 の倍数 — Buzz
+
+### Red
+
+```python
+def test_5を渡したら文字列Buzzを返す(self):
+    assert self.fizzbuzz.generate(5) == "Buzz"
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_5を渡したら文字列Buzzを返す FAILED
+
+E       AssertionError: assert '5' == 'Buzz'
+```
+
+### Green
+
+```python
+# lib/fizzbuzz.py
+class FizzBuzz:
+    def generate(self, number: int) -> str:
+        if number % 3 == 0:
+            return "Fizz"
+        if number % 5 == 0:
+            return "Buzz"
+        return str(number)
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_2を渡したら文字列2を返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_3を渡したら文字列Fizzを返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_5を渡したら文字列Buzzを返す PASSED
+
+4 passed
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.5 3 と 5 の倍数 — FizzBuzz
+
+### Red
+
+```python
+def test_15を渡したら文字列FizzBuzzを返す(self):
+    assert self.fizzbuzz.generate(15) == "FizzBuzz"
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_15を渡したら文字列FizzBuzzを返す FAILED
+
+E       AssertionError: assert 'Fizz' == 'FizzBuzz'
+```
+
+現在の実装では 3 の倍数の条件が先に評価されるため、15 を渡すと "Fizz" が返ってきています。
+
+### Green
+
+3 と 5 の両方の倍数を先に判定するように修正します。
+
+```python
+# lib/fizzbuzz.py
+class FizzBuzz:
+    def generate(self, number: int) -> str:
+        if number % 15 == 0:
+            return "FizzBuzz"
+        if number % 3 == 0:
+            return "Fizz"
+        if number % 5 == 0:
+            return "Buzz"
+        return str(number)
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1を渡したら文字列1を返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_2を渡したら文字列2を返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_3を渡したら文字列Fizzを返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_5を渡したら文字列Buzzを返す PASSED
+test/test_fizzbuzz.py::TestFizzBuzz::test_15を渡したら文字列FizzBuzzを返す PASSED
+
+5 passed
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.6 まとめ
+
+この章では、以下の TDD テクニックを実践しました。
+
+1. **三角測量** — 2 つ以上のテストケースから一般化を導き出す
+2. **明白な実装** — ロジックが明確な場合は直接的に実装する
+3. **Red-Green サイクル** — テスト失敗（Red）→ 最小限の実装（Green）を繰り返す
+
+FizzBuzz のコアロジック（generate メソッド）が完成しました。次の章では、残りの TODO（リスト生成とプリント）を完成させ、リファクタリングを行います。

package/lib/assets/docs/article/getting-start-tdd/python/03-obvious-implementation-and-refactoring.md

@@ -0,0 +1,199 @@
+# 第 3 章: 明白な実装とリファクタリング
+
+## 3.1 はじめに
+
+前章では、三角測量と明白な実装で FizzBuzz のコアロジックを完成させました。この章では、残りの TODO（リスト生成とプリント）を実装し、学習用テストを活用しながら「動作するきれいなコード」を目指してリファクタリングします。
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 3.2 1 から 100 までのリスト生成
+
+### Red: リスト生成のテスト
+
+1 から 100 までの FizzBuzz の結果をリストとして返すメソッドをテストします。
+
+```python
+def test_1から100までのFizzBuzzを生成する(self):
+    result = self.fizzbuzz.generate_list(100)
+
+    assert len(result) == 100
+    assert result[0] == "1"
+    assert result[1] == "2"
+    assert result[2] == "Fizz"
+    assert result[3] == "4"
+    assert result[4] == "Buzz"
+    assert result[5] == "Fizz"
+    assert result[14] == "FizzBuzz"
+    assert result[99] == "Buzz"
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1から100までのFizzBuzzを生成する FAILED
+
+E       AttributeError: 'FizzBuzz' object has no attribute 'generate_list'
+```
+
+### Green: 明白な実装
+
+Python のリスト内包表記を使って簡潔に実装します。
+
+```python
+# lib/fizzbuzz.py
+class FizzBuzz:
+    def generate(self, number: int) -> str:
+        if number % 15 == 0:
+            return "FizzBuzz"
+        if number % 3 == 0:
+            return "Fizz"
+        if number % 5 == 0:
+            return "Buzz"
+        return str(number)
+
+    def generate_list(self, count: int) -> list[str]:
+        return [self.generate(i) for i in range(1, count + 1)]
+```
+
+```
+test/test_fizzbuzz.py::TestFizzBuzz::test_1から100までのFizzBuzzを生成する PASSED
+
+6 passed
+```
+
+Python ではリスト内包表記（`[expr for x in iterable]`）を使うことで、Java の `for` ループ + `ArrayList` よりも簡潔にリストを生成できます。
+
+## 3.3 プリント機能
+
+### 学習用テスト
+
+プリント機能のテストには、標準出力のキャプチャが必要です。pytest では `capsys` フィクスチャを使って標準出力をキャプチャできます。学習用テストとして試してみましょう。
+
+> 学習用テスト
+>
+> 外部のソフトウェアのテストを書くべきだろうか——そのソフトウェアに対して新しいことを初めて行おうとした段階で書いてみよう。
+>
+> — テスト駆動開発
+
+```python
+def test_プリントする(self, capsys):
+    self.fizzbuzz.print_fizzbuzz(15)
+    captured = capsys.readouterr()
+    lines = captured.out.strip().split("\n")
+
+    assert len(lines) == 15
+    assert lines[0] == "1"
+    assert lines[2] == "Fizz"
+    assert lines[4] == "Buzz"
+    assert lines[14] == "FizzBuzz"
+```
+
+### 実装
+
+```python
+def print_fizzbuzz(self, count: int) -> None:
+    result = self.generate_list(count)
+    for item in result:
+        print(item)
+```
+
+### Main モジュールの作成
+
+実行用のエントリポイントを作成します。
+
+```python
+# main.py
+from lib.fizzbuzz import FizzBuzz
+
+if __name__ == "__main__":
+    fizzbuzz = FizzBuzz()
+    fizzbuzz.print_fizzbuzz(100)
+```
+
+```bash
+$ uv run python main.py | head -20
+1
+2
+Fizz
+4
+Buzz
+Fizz
+7
+8
+Fizz
+Buzz
+11
+Fizz
+13
+14
+FizzBuzz
+16
+17
+Fizz
+19
+Buzz
+```
+
+## 3.4 動作するきれいなコード
+
+ここまでの実装で、すべての TODO が完了しました。
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [x] 1 から 100 までの数
+- [x] プリントする
+
+TDD では「動作するきれいなコード（Clean code that works）」を目指します。これはソフトウェア開発の三種の神器と組み合わせて実現します。
+
+> ソフトウェア開発の三種の神器
+>
+> - バージョン管理
+> - テスティング
+> - 自動化
+>
+> — 和田卓人
+
+現在のコードは動作していますが、テスト駆動開発のプロセスを振り返ってみましょう。
+
+### TDD サイクルの振り返り
+
+1. **仮実装** — `return "1"` でテストを通す
+2. **三角測量** — 2 つ目のテストで `str(number)` に一般化
+3. **明白な実装** — 3 の倍数、5 の倍数、15 の倍数の判定を直接実装
+4. **追加実装** — リスト生成、プリント機能を追加
+
+各ステップでテストが先にあり、テストが通ることを確認してから次のステップに進みました。これが TDD の基本サイクルです。
+
+## 3.5 まとめ
+
+第 1 部（章 1〜3）を通じて、TDD の基本サイクルを体験しました。
+
+### 学んだ TDD テクニック
+
+| テクニック | 説明 | 使用場面 |
+|-----------|------|---------|
+| テストファースト | テスト対象のコードを書く前にテストを書く | 常に |
+| アサートファースト | アサーションを最初に書く | テスト作成時 |
+| 仮実装 | ベタ書きの値を返す | 最初の実装 |
+| 三角測量 | 2 つ以上の例から一般化を導く | 実装の方向性が不明確なとき |
+| 明白な実装 | ロジックが明確な場合は直接実装 | ロジックが自明なとき |
+| 学習用テスト | 外部ソフトウェアの使い方を学ぶためのテスト | 新しい API を使うとき |
+
+### Red-Green-Refactor
+
+```
+Red（テスト失敗）→ Green（テスト成功）→ Refactor（リファクタリング）
+```
+
+このサイクルを小さく素早く繰り返すことで、品質を維持しながら着実に機能を追加できます。
+
+次の第 2 部では、開発環境の整備（バージョン管理、パッケージ管理、CI/CD）について解説します。