Quick fixes & tests

redmine_reporter/formatters/base.py

@@ -1,5 +1,5 @@
 from abc import ABC, abstractmethod
-from typing import List
+from typing import Any, List
 from ..types import ReportRow
 
 
@@ -7,13 +7,19 @@ class Formatter(ABC):
     """
     Абстрактный базовый класс для всех форматтеров.
     Определяет общий интерфейс для форматирования отчета.
+
+    Контракт:
+      - format() возвращает строку для текстовых форматтеров (CSV, HTML, Markdown, console)
+        и объект OpenDocument для ODTFormatter.
+      - save() сохраняет результат в файл; консольные форматтеры бросают NotImplementedError.
     """
 
     @abstractmethod
-    def format(self, rows: List[ReportRow]) -> str:
+    def format(self, rows: List[ReportRow]) -> Any:
         """
         Форматирует список строк отчета в нужный формат.
-        Возвращает строковое представление отчета.
+        Для текстовых форматтеров возвращает str.
+        Для ODTFormatter возвращает объект OpenDocument.
         """
         pass
 
@@ -22,6 +28,6 @@ class Formatter(ABC):
         """
         Сохраняет отформатированный отчет в файл по указанному пути.
         Для форматтеров, которые не поддерживают сохранение (например, консольные),
-        можно вызывать `format` и записывать результат вручную.
+        бросает NotImplementedError.
         """
         pass