@k2works/claude-code-booster 3.5.0 → 3.6.1

package/lib/assets/docs/article/getting-start-tdd/python/08-design-patterns.md

@@ -1,172 +1,172 @@
-# 第 8 章: デザインパターンの適用
-
-## 8.1 はじめに
-
-前章では、カプセル化とポリモーフィズムで `if/elif` の連鎖を排除しました。この章では、さらに **デザインパターン** を適用して設計を洗練させます。
-
-適用するパターン:
-
-1. **Value Object** — 値をオブジェクトとして表現
-2. **First-Class Collection** — コレクションをドメインオブジェクト化
-3. **Command パターン** — 操作をオブジェクト化
-4. **Null Object パターン** — 例外の代わりにデフォルト動作を提供
-
-## 8.2 Value Object（値オブジェクト）
-
-FizzBuzz の結果を「数」と「変換後の文字列」のペアとして保持する値オブジェクトを作成します。
-
-```python
-class FizzBuzzValue:
-    def __init__(self, number: int, value: str) -> None:
-        self._number = number
-        self._value = value
-
-    @property
-    def number(self) -> int:
-        return self._number
-
-    @property
-    def value(self) -> str:
-        return self._value
-
-    def __eq__(self, other: object) -> bool:
-        if not isinstance(other, FizzBuzzValue):
-            return NotImplemented
-        return self._number == other._number and self._value == other._value
-
-    def __hash__(self) -> int:
-        return hash((self._number, self._value))
-
-    def __repr__(self) -> str:
-        return f"{self._number}:{self._value}"
-```
-
-### テスト
-
-```python
-class TestFizzBuzzValue:
-    def test_値を保持する(self):
-        value = FizzBuzzValue(1, "1")
-        assert value.number == 1
-        assert value.value == "1"
-
-    def test_同じ値は等しい(self):
-        assert FizzBuzzValue(1, "1") == FizzBuzzValue(1, "1")
-
-    def test_文字列表現(self):
-        assert repr(FizzBuzzValue(3, "Fizz")) == "3:Fizz"
-```
-
-### FizzBuzzType の更新
-
-`generate` の戻り値を `str` から `FizzBuzzValue` に変更します。
-
-```python
-class FizzBuzzType01(FizzBuzzType):
-    def generate(self, number: int) -> FizzBuzzValue:
-        if self._is_fizz_buzz(number):
-            return FizzBuzzValue(number, "FizzBuzz")
-        if self._is_fizz(number):
-            return FizzBuzzValue(number, "Fizz")
-        if self._is_buzz(number):
-            return FizzBuzzValue(number, "Buzz")
-        return FizzBuzzValue(number, str(number))
-```
-
-## 8.3 First-Class Collection
-
-FizzBuzz の結果リストを専用クラスで包みます。
-
-```python
-class FizzBuzzList:
-    def __init__(self, values: list[FizzBuzzValue] | None = None) -> None:
-        self._values: list[FizzBuzzValue] = list(values) if values else []
-
-    def add(self, value: FizzBuzzValue) -> None:
-        self._values.append(value)
-
-    def get(self, index: int) -> FizzBuzzValue:
-        return self._values[index]
-
-    def size(self) -> int:
-        return len(self._values)
-
-    def __eq__(self, other: object) -> bool:
-        if not isinstance(other, FizzBuzzList):
-            return NotImplemented
-        return self._values == other._values
-
-    def __hash__(self) -> int:
-        return hash(tuple(self._values))
-
-    def __repr__(self) -> str:
-        return "[" + ", ".join(repr(v) for v in self._values) + "]"
-```
-
-## 8.4 Command パターン
-
-操作をオブジェクトとしてカプセル化します。
-
-```python
-from abc import ABC, abstractmethod
-
-class FizzBuzzCommand(ABC):
-    @abstractmethod
-    def execute(self) -> FizzBuzzValue | FizzBuzzList:
-        pass
-
-class FizzBuzzValueCommand(FizzBuzzCommand):
-    def __init__(self, type_: FizzBuzzType, number: int) -> None:
-        self._type = type_
-        self._number = number
-
-    def execute(self) -> FizzBuzzValue:
-        return self._type.generate(self._number)
-
-class FizzBuzzListCommand(FizzBuzzCommand):
-    MAX_NUMBER: int = 100
-
-    def __init__(self, type_: FizzBuzzType) -> None:
-        self._type = type_
-
-    def execute(self) -> FizzBuzzList:
-        result = FizzBuzzList()
-        for i in range(1, self.MAX_NUMBER + 1):
-            result.add(self._type.generate(i))
-        return result
-```
-
-## 8.5 Null Object パターン
-
-未定義のタイプに対して例外ではなくデフォルト動作を返します。
-
-```python
-class FizzBuzzTypeNotDefined(FizzBuzzType):
-    def generate(self, number: int) -> FizzBuzzValue:
-        return FizzBuzzValue(number, "")
-```
-
-ファクトリメソッドを更新します。
-
-```python
-@staticmethod
-def create(type_: int) -> "FizzBuzzType":
-    types = {
-        1: FizzBuzzType01,
-        2: FizzBuzzType02,
-        3: FizzBuzzType03,
-    }
-    return types.get(type_, FizzBuzzTypeNotDefined)()
-```
-
-## 8.6 まとめ
-
-| パターン | クラス | 効果 |
-|----------|--------|------|
-| Value Object | `FizzBuzzValue` | 値の意味を明示し、等価性を保証 |
-| First-Class Collection | `FizzBuzzList` | コレクション操作を一元化 |
-| Command | `FizzBuzzValueCommand` / `FizzBuzzListCommand` | 操作と実行を分離 |
-| Null Object | `FizzBuzzTypeNotDefined` | 例外の代わりにデフォルト動作 |
-| Factory Method | `FizzBuzzType.create()` | 生成ロジックの一元化 |
-
-次の章では、SOLID 原則を確認しながらモジュール設計を行います。
+# 第 8 章: デザインパターンの適用
+
+## 8.1 はじめに
+
+前章では、カプセル化とポリモーフィズムで `if/elif` の連鎖を排除しました。この章では、さらに **デザインパターン** を適用して設計を洗練させます。
+
+適用するパターン:
+
+1. **Value Object** — 値をオブジェクトとして表現
+2. **First-Class Collection** — コレクションをドメインオブジェクト化
+3. **Command パターン** — 操作をオブジェクト化
+4. **Null Object パターン** — 例外の代わりにデフォルト動作を提供
+
+## 8.2 Value Object（値オブジェクト）
+
+FizzBuzz の結果を「数」と「変換後の文字列」のペアとして保持する値オブジェクトを作成します。
+
+```python
+class FizzBuzzValue:
+    def __init__(self, number: int, value: str) -> None:
+        self._number = number
+        self._value = value
+
+    @property
+    def number(self) -> int:
+        return self._number
+
+    @property
+    def value(self) -> str:
+        return self._value
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, FizzBuzzValue):
+            return NotImplemented
+        return self._number == other._number and self._value == other._value
+
+    def __hash__(self) -> int:
+        return hash((self._number, self._value))
+
+    def __repr__(self) -> str:
+        return f"{self._number}:{self._value}"
+```
+
+### テスト
+
+```python
+class TestFizzBuzzValue:
+    def test_値を保持する(self):
+        value = FizzBuzzValue(1, "1")
+        assert value.number == 1
+        assert value.value == "1"
+
+    def test_同じ値は等しい(self):
+        assert FizzBuzzValue(1, "1") == FizzBuzzValue(1, "1")
+
+    def test_文字列表現(self):
+        assert repr(FizzBuzzValue(3, "Fizz")) == "3:Fizz"
+```
+
+### FizzBuzzType の更新
+
+`generate` の戻り値を `str` から `FizzBuzzValue` に変更します。
+
+```python
+class FizzBuzzType01(FizzBuzzType):
+    def generate(self, number: int) -> FizzBuzzValue:
+        if self._is_fizz_buzz(number):
+            return FizzBuzzValue(number, "FizzBuzz")
+        if self._is_fizz(number):
+            return FizzBuzzValue(number, "Fizz")
+        if self._is_buzz(number):
+            return FizzBuzzValue(number, "Buzz")
+        return FizzBuzzValue(number, str(number))
+```
+
+## 8.3 First-Class Collection
+
+FizzBuzz の結果リストを専用クラスで包みます。
+
+```python
+class FizzBuzzList:
+    def __init__(self, values: list[FizzBuzzValue] | None = None) -> None:
+        self._values: list[FizzBuzzValue] = list(values) if values else []
+
+    def add(self, value: FizzBuzzValue) -> None:
+        self._values.append(value)
+
+    def get(self, index: int) -> FizzBuzzValue:
+        return self._values[index]
+
+    def size(self) -> int:
+        return len(self._values)
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, FizzBuzzList):
+            return NotImplemented
+        return self._values == other._values
+
+    def __hash__(self) -> int:
+        return hash(tuple(self._values))
+
+    def __repr__(self) -> str:
+        return "[" + ", ".join(repr(v) for v in self._values) + "]"
+```
+
+## 8.4 Command パターン
+
+操作をオブジェクトとしてカプセル化します。
+
+```python
+from abc import ABC, abstractmethod
+
+class FizzBuzzCommand(ABC):
+    @abstractmethod
+    def execute(self) -> FizzBuzzValue | FizzBuzzList:
+        pass
+
+class FizzBuzzValueCommand(FizzBuzzCommand):
+    def __init__(self, type_: FizzBuzzType, number: int) -> None:
+        self._type = type_
+        self._number = number
+
+    def execute(self) -> FizzBuzzValue:
+        return self._type.generate(self._number)
+
+class FizzBuzzListCommand(FizzBuzzCommand):
+    MAX_NUMBER: int = 100
+
+    def __init__(self, type_: FizzBuzzType) -> None:
+        self._type = type_
+
+    def execute(self) -> FizzBuzzList:
+        result = FizzBuzzList()
+        for i in range(1, self.MAX_NUMBER + 1):
+            result.add(self._type.generate(i))
+        return result
+```
+
+## 8.5 Null Object パターン
+
+未定義のタイプに対して例外ではなくデフォルト動作を返します。
+
+```python
+class FizzBuzzTypeNotDefined(FizzBuzzType):
+    def generate(self, number: int) -> FizzBuzzValue:
+        return FizzBuzzValue(number, "")
+```
+
+ファクトリメソッドを更新します。
+
+```python
+@staticmethod
+def create(type_: int) -> "FizzBuzzType":
+    types = {
+        1: FizzBuzzType01,
+        2: FizzBuzzType02,
+        3: FizzBuzzType03,
+    }
+    return types.get(type_, FizzBuzzTypeNotDefined)()
+```
+
+## 8.6 まとめ
+
+| パターン | クラス | 効果 |
+|----------|--------|------|
+| Value Object | `FizzBuzzValue` | 値の意味を明示し、等価性を保証 |
+| First-Class Collection | `FizzBuzzList` | コレクション操作を一元化 |
+| Command | `FizzBuzzValueCommand` / `FizzBuzzListCommand` | 操作と実行を分離 |
+| Null Object | `FizzBuzzTypeNotDefined` | 例外の代わりにデフォルト動作 |
+| Factory Method | `FizzBuzzType.create()` | 生成ロジックの一元化 |
+
+次の章では、SOLID 原則を確認しながらモジュール設計を行います。

package/lib/assets/docs/article/getting-start-tdd/python/09-solid-principles-and-module-design.md

@@ -1,130 +1,130 @@
-# 第 9 章: SOLID 原則とモジュール設計
-
-## 9.1 はじめに
-
-前章までに、FizzBuzz をオブジェクト指向設計で洗練させてきました。この章では、**SOLID 原則** の観点で設計を検証し、**モジュール分割** を行ってパッケージ構造を整理します。
-
-## 9.2 SOLID 原則の確認
-
-### 単一責任の原則（SRP）
-
-| クラス | 責務 | 変更理由 |
-|--------|------|---------|
-| `FizzBuzzType01/02/03` | タイプ別の変換ルール | ルール変更時 |
-| `FizzBuzzValue` | 値の保持と等価性 | 値表現の変更時 |
-| `FizzBuzzList` | コレクション操作 | コレクション仕様変更時 |
-| `FizzBuzzValueCommand` | 単一値の実行 | 実行方法の変更時 |
-| `FizzBuzzListCommand` | リスト生成の実行 | 実行方法の変更時 |
-
-各クラスが 1 つの責務のみを持っていることが確認できます。
-
-### 開放閉鎖の原則（OCP）
-
-新しいタイプ（たとえばタイプ 4）を追加する場合:
-
-1. `FizzBuzzType04` クラスを新規作成
-2. `FizzBuzzType.create()` に 1 行追加
-
-既存のクラスを修正する必要はありません。
-
-### 依存性逆転の原則（DIP）
-
-```
-FizzBuzzValueCommand → FizzBuzzType (抽象) ← FizzBuzzType01/02/03
-FizzBuzzListCommand  → FizzBuzzType (抽象) ← FizzBuzzType01/02/03
-```
-
-上位モジュール（Command）は抽象（FizzBuzzType）に依存し、具象クラスには直接依存しません。
-
-## 9.3 パッケージ設計
-
-責務に基づいてモジュールを分割します。
-
-### ディレクトリ構成
-
-```
-apps/python/
-├── lib/
-│   ├── __init__.py
-│   ├── domain/
-│   │   ├── __init__.py
-│   │   ├── model/
-│   │   │   ├── __init__.py
-│   │   │   ├── fizz_buzz_value.py
-│   │   │   └── fizz_buzz_list.py
-│   │   └── type/
-│   │       ├── __init__.py
-│   │       ├── fizz_buzz_type.py
-│   │       ├── fizz_buzz_type_01.py
-│   │       ├── fizz_buzz_type_02.py
-│   │       ├── fizz_buzz_type_03.py
-│   │       └── fizz_buzz_type_not_defined.py
-│   └── application/
-│       ├── __init__.py
-│       ├── fizz_buzz_command.py
-│       ├── fizz_buzz_value_command.py
-│       └── fizz_buzz_list_command.py
-├── test/
-│   ├── __init__.py
-│   ├── domain/
-│   │   ├── __init__.py
-│   │   ├── model/
-│   │   │   ├── __init__.py
-│   │   │   ├── test_fizz_buzz_value.py
-│   │   │   └── test_fizz_buzz_list.py
-│   │   └── type/
-│   │       ├── __init__.py
-│   │       └── test_fizz_buzz_type.py
-│   └── application/
-│       ├── __init__.py
-│       └── test_fizz_buzz_command.py
-└── main.py
-```
-
-### パッケージ依存関係
-
-```
-application → domain.type → domain.model
-```
-
-- `domain` は `application` に依存しない（単方向依存）
-- ビジネスロジック（domain）がアプリケーション層から独立
-
-## 9.4 エントリポイントの更新
-
-```python
-# main.py
-from lib.application.fizz_buzz_list_command import FizzBuzzListCommand
-from lib.domain.type.fizz_buzz_type import FizzBuzzType
-
-if __name__ == "__main__":
-    type_ = FizzBuzzType.create(1)
-    command = FizzBuzzListCommand(type_)
-    result = command.execute()
-    for i in range(result.size()):
-        print(result.get(i))
-```
-
-## 9.5 まとめ
-
-### 第 3 部の振り返り
-
-| 章 | テーマ | 適用した技法 |
-|----|--------|------------|
-| 7 | カプセル化とポリモーフィズム | `@property`、`abc.ABC`、`@abstractmethod`、Factory Method |
-| 8 | デザインパターン | Value Object、First-Class Collection、Command、Null Object |
-| 9 | SOLID 原則とモジュール設計 | SRP、OCP、DIP、パッケージ分割 |
-
-### リファクタリングの進化
-
-```
-第 1 部: 手続き的な FizzBuzz（1 クラス）
-    ↓
-第 3 部 章 7: ポリモーフィズム（FizzBuzzType 階層）
-    ↓
-第 3 部 章 8: デザインパターン（Value Object、Command）
-    ↓
-第 3 部 章 9: モジュール設計（domain/application 分離）
-```
-
-次の第 4 部では、関数型プログラミング（高階関数、デコレータ、ジェネレータ）を FizzBuzz に適用します。
+# 第 9 章: SOLID 原則とモジュール設計
+
+## 9.1 はじめに
+
+前章までに、FizzBuzz をオブジェクト指向設計で洗練させてきました。この章では、**SOLID 原則** の観点で設計を検証し、**モジュール分割** を行ってパッケージ構造を整理します。
+
+## 9.2 SOLID 原則の確認
+
+### 単一責任の原則（SRP）
+
+| クラス | 責務 | 変更理由 |
+|--------|------|---------|
+| `FizzBuzzType01/02/03` | タイプ別の変換ルール | ルール変更時 |
+| `FizzBuzzValue` | 値の保持と等価性 | 値表現の変更時 |
+| `FizzBuzzList` | コレクション操作 | コレクション仕様変更時 |
+| `FizzBuzzValueCommand` | 単一値の実行 | 実行方法の変更時 |
+| `FizzBuzzListCommand` | リスト生成の実行 | 実行方法の変更時 |
+
+各クラスが 1 つの責務のみを持っていることが確認できます。
+
+### 開放閉鎖の原則（OCP）
+
+新しいタイプ（たとえばタイプ 4）を追加する場合:
+
+1. `FizzBuzzType04` クラスを新規作成
+2. `FizzBuzzType.create()` に 1 行追加
+
+既存のクラスを修正する必要はありません。
+
+### 依存性逆転の原則（DIP）
+
+```
+FizzBuzzValueCommand → FizzBuzzType (抽象) ← FizzBuzzType01/02/03
+FizzBuzzListCommand  → FizzBuzzType (抽象) ← FizzBuzzType01/02/03
+```
+
+上位モジュール（Command）は抽象（FizzBuzzType）に依存し、具象クラスには直接依存しません。
+
+## 9.3 パッケージ設計
+
+責務に基づいてモジュールを分割します。
+
+### ディレクトリ構成
+
+```
+apps/python/
+├── lib/
+│   ├── __init__.py
+│   ├── domain/
+│   │   ├── __init__.py
+│   │   ├── model/
+│   │   │   ├── __init__.py
+│   │   │   ├── fizz_buzz_value.py
+│   │   │   └── fizz_buzz_list.py
+│   │   └── type/
+│   │       ├── __init__.py
+│   │       ├── fizz_buzz_type.py
+│   │       ├── fizz_buzz_type_01.py
+│   │       ├── fizz_buzz_type_02.py
+│   │       ├── fizz_buzz_type_03.py
+│   │       └── fizz_buzz_type_not_defined.py
+│   └── application/
+│       ├── __init__.py
+│       ├── fizz_buzz_command.py
+│       ├── fizz_buzz_value_command.py
+│       └── fizz_buzz_list_command.py
+├── test/
+│   ├── __init__.py
+│   ├── domain/
+│   │   ├── __init__.py
+│   │   ├── model/
+│   │   │   ├── __init__.py
+│   │   │   ├── test_fizz_buzz_value.py
+│   │   │   └── test_fizz_buzz_list.py
+│   │   └── type/
+│   │       ├── __init__.py
+│   │       └── test_fizz_buzz_type.py
+│   └── application/
+│       ├── __init__.py
+│       └── test_fizz_buzz_command.py
+└── main.py
+```
+
+### パッケージ依存関係
+
+```
+application → domain.type → domain.model
+```
+
+- `domain` は `application` に依存しない（単方向依存）
+- ビジネスロジック（domain）がアプリケーション層から独立
+
+## 9.4 エントリポイントの更新
+
+```python
+# main.py
+from lib.application.fizz_buzz_list_command import FizzBuzzListCommand
+from lib.domain.type.fizz_buzz_type import FizzBuzzType
+
+if __name__ == "__main__":
+    type_ = FizzBuzzType.create(1)
+    command = FizzBuzzListCommand(type_)
+    result = command.execute()
+    for i in range(result.size()):
+        print(result.get(i))
+```
+
+## 9.5 まとめ
+
+### 第 3 部の振り返り
+
+| 章 | テーマ | 適用した技法 |
+|----|--------|------------|
+| 7 | カプセル化とポリモーフィズム | `@property`、`abc.ABC`、`@abstractmethod`、Factory Method |
+| 8 | デザインパターン | Value Object、First-Class Collection、Command、Null Object |
+| 9 | SOLID 原則とモジュール設計 | SRP、OCP、DIP、パッケージ分割 |
+
+### リファクタリングの進化
+
+```
+第 1 部: 手続き的な FizzBuzz（1 クラス）
+    ↓
+第 3 部 章 7: ポリモーフィズム（FizzBuzzType 階層）
+    ↓
+第 3 部 章 8: デザインパターン（Value Object、Command）
+    ↓
+第 3 部 章 9: モジュール設計（domain/application 分離）
+```
+
+次の第 4 部では、関数型プログラミング（高階関数、デコレータ、ジェネレータ）を FizzBuzz に適用します。