refactor: typed Enums for format/mode fields

- SubtitleMode, OutputFormat, SaveMode, SubtitleFormat, InputFormat
- Properties: dot_ext, is_lossless, is_book, is_subtitle
- from_str/from_path class methods with normalization
- Updated domain and application layers to use Enums
- 17 new tests for enum validation and properties

tests/test_enums.py

@@ -0,0 +1,99 @@
+"""Tests for domain enums — validation, properties, from_str methods."""
+
+import pytest
+from pathlib import Path
+
+from abogen.domain.enums import (
+    InputFormat,
+    OutputFormat,
+    SaveMode,
+    SubtitleFormat,
+    SubtitleMode,
+)
+
+
+class TestSubtitleMode:
+    def test_from_str_case_insensitive(self):
+        assert SubtitleMode.from_str("disabled") == SubtitleMode.DISABLED
+        assert SubtitleMode.from_str("SENTENCE") == SubtitleMode.SENTENCE
+        assert SubtitleMode.from_str("line") == SubtitleMode.LINE
+
+    def test_from_str_strips_whitespace(self):
+        assert SubtitleMode.from_str("  Disabled  ") == SubtitleMode.DISABLED
+
+    def test_from_str_invalid(self):
+        with pytest.raises(ValueError, match="Invalid SubtitleMode"):
+            SubtitleMode.from_str("invalid")
+
+    def test_comparison_with_str(self):
+        assert SubtitleMode.DISABLED == "Disabled"
+        assert SubtitleMode.SENTENCE != "Disabled"
+
+
+class TestOutputFormat:
+    def test_dot_ext(self):
+        assert OutputFormat.WAV.dot_ext == ".wav"
+        assert OutputFormat.M4B.dot_ext == ".m4b"
+
+    def test_is_lossless(self):
+        assert OutputFormat.WAV.is_lossless is True
+        assert OutputFormat.FLAC.is_lossless is True
+        assert OutputFormat.MP3.is_lossless is False
+        assert OutputFormat.M4B.is_lossless is False
+
+    def test_from_str_strips_dot(self):
+        assert OutputFormat.from_str(".wav") == OutputFormat.WAV
+        assert OutputFormat.from_str(".MP3") == OutputFormat.MP3
+
+    def test_from_str_case_insensitive(self):
+        assert OutputFormat.from_str("WAV") == OutputFormat.WAV
+        assert OutputFormat.from_str("opus") == OutputFormat.OPUS
+
+    def test_from_str_invalid(self):
+        with pytest.raises(ValueError, match="Invalid OutputFormat"):
+            OutputFormat.from_str("avi")
+
+
+class TestSaveMode:
+    def test_values(self):
+        assert SaveMode.SAVE_NEXT_TO_INPUT == "save_next_to_input"
+        assert SaveMode.CUSTOM_FOLDER == "custom_folder"
+
+
+class TestSubtitleFormat:
+    def test_dot_ext(self):
+        assert SubtitleFormat.SRT.dot_ext == ".srt"
+        assert SubtitleFormat.ASS.dot_ext == ".ass"
+
+    def test_from_str_strips_dot(self):
+        assert SubtitleFormat.from_str(".srt") == SubtitleFormat.SRT
+        assert SubtitleFormat.from_str(".ASS") == SubtitleFormat.ASS
+
+
+class TestInputFormat:
+    def test_is_book(self):
+        assert InputFormat.EPUB.is_book is True
+        assert InputFormat.PDF.is_book is True
+        assert InputFormat.TXT.is_book is True
+        assert InputFormat.MD.is_book is True
+        assert InputFormat.SRT.is_book is False
+
+    def test_is_subtitle(self):
+        assert InputFormat.SRT.is_subtitle is True
+        assert InputFormat.ASS.is_subtitle is True
+        assert InputFormat.VTT.is_subtitle is True
+        assert InputFormat.EPUB.is_subtitle is False
+
+    def test_from_path(self):
+        assert InputFormat.from_path(Path("book.epub")) == InputFormat.EPUB
+        assert InputFormat.from_path(Path("sub.srt")) == InputFormat.SRT
+        assert InputFormat.from_path(Path("notes.MD")) == InputFormat.MD
+        assert InputFormat.from_path(Path("doc.markdown")) == InputFormat.MD
+
+    def test_from_path_invalid(self):
+        with pytest.raises(ValueError, match="Unsupported input format"):
+            InputFormat.from_path(Path("video.mp4"))
+
+    def test_dot_ext(self):
+        assert InputFormat.EPUB.dot_ext == ".epub"
+        assert InputFormat.SRT.dot_ext == ".srt"