MIL-005: Step 4 - Save progress

Review record RC-027 (Go, autonomous mode, not independent). Task: MIL-005#1 Task: MIL-005#2 Task: MIL-005#3 Task: MIL-005#4 Task: MIL-005#5
2026-10-14 22:29:58 +08:00
parent da4e9382cf
commit 8dbaaa3059
22 changed files with 1367 additions and 669 deletions
@@ -1,35 +1,35 @@
-"""CSV implementation of the vocabulary port.
-
-@file csv_vocabulary_repository.py
-@brief The CsvVocabularyRepository adapter.
-"""
-
-from pathlib import Path
-
-from flash_card.domain.entities.vocabulary import Vocabulary
-from flash_card.domain.errors.vocabulary_errors import VocabularyFormatError
-from flash_card.infrastructure.persistence.csv_word_list import read_word_list
-
-
-class CsvVocabularyRepository:
-    """Loads the delivered word list from a CSV file."""
-
-    def __init__(self, path: Path) -> None:
-        """Create the repository.
-
-        @param path The word list file.
-        """
-        ## @brief The word list file.
-        self._path = path
-
-    def load(self) -> Vocabulary:
-        """Load the word list.
-
-        @return The vocabulary.
-        @throws VocabularyNotFoundError When the file does not exist.
-        @throws VocabularyFormatError When the file is malformed or has no card.
-        """
-        pair, cards = read_word_list(self._path)
-        if not cards:
-            raise VocabularyFormatError(f"{self._path}: word list has no card")
-        return Vocabulary(pair, cards)
+"""CSV implementation of the vocabulary port.
+
+@file csv_vocabulary_repository.py
+@brief The CsvVocabularyRepository adapter.
+"""
+
+from pathlib import Path
+
+from flash_card.domain.entities.vocabulary import Vocabulary
+from flash_card.domain.errors.vocabulary_errors import VocabularyFormatError
+from flash_card.infrastructure.persistence.csv_word_list import read_word_list
+
+
+class CsvVocabularyRepository:
+    """Loads the delivered word list from a CSV file."""
+
+    def __init__(self, path: Path) -> None:
+        """Create the repository.
+
+        @param path The word list file.
+        """
+        ## @brief The word list file.
+        self._path = path
+
+    def load(self) -> Vocabulary:
+        """Load the word list.
+
+        @return The vocabulary.
+        @throws VocabularyNotFoundError When the file does not exist.
+        @throws VocabularyFormatError When the file is malformed or has no card.
+        """
+        pair, cards = read_word_list(self._path)
+        if not cards:
+            raise VocabularyFormatError(f"{self._path}: word list has no card")
+        return Vocabulary(pair, cards)