Bump version: 1.3.0

Closes #6

.gitignore

@@ -85,3 +85,9 @@ secrets.json
 # Temporary files
 *.tmp
 *.bak
+
+# Just in case
+.~*
+report.odt
+report.csv
+report.md

README.md

@@ -16,6 +16,7 @@
 - Перевод статусов на русский язык
 - Простой CLI с понятными аргументами
 - Поддержка настройки диапазона дат по умолчанию через `.env`
+- Экспорт в ODT, CSV и Markdown
 
 ---
 
@@ -59,6 +60,7 @@ cat /etc/ssl/certs/ca-certificates.crt >> $(python -m certifi)
 REDMINE_URL=https://red.eltex.loc/
 REDMINE_USER=ваш.логин
 REDMINE_PASSWORD=ваш_пароль
+REDMINE_AUTHOR=Иванов Иван Иванович
 
 # Опционально: диапазон дат по умолчанию
 DEFAULT_FROM_DATE=2026-01-01
@@ -71,6 +73,7 @@ DEFAULT_TO_DATE=2026-01-31
 export REDMINE_URL=https://red.eltex.loc/
 export REDMINE_USER=ваш.логин
 export REDMINE_PASSWORD=...
+export REDMINE_AUTHOR="Иванов Иван Иванович"
 export DEFAULT_FROM_DATE=2026-01-01
 export DEFAULT_TO_DATE=2026-01-31
 ```
@@ -99,9 +102,32 @@ redmine-reporter --date 2026-02-01--2026-02-28
 
 # Компактный вывод (удобно копировать в письмо)
 redmine-reporter --compact
+
+# Экспорт в ODT с указанием автора (если не задано в .env)
+redmine-reporter --output report.odt --author "Иванов Иван Иванович"
 ```
 
-Пример вывода:
+> 💡 **Автоматика в ODT-отчёте**:
+> - Месяц в заголовке определяется **автоматически** по дате окончания периода (`to_date`).
+>   Например: `2025-12-20--2026-01-15` → **«Январь»**.
+> - Имя автора берётся из переменной окружения `REDMINE_AUTHOR` (в `.env`) или CLI-аргумента `--author`.
+> - Первая пустая строка из шаблона `template.odt` **автоматически удаляется**.
+
+Пример содержимого `.env` с автором:
+
+```ini
+REDMINE_URL=https://red.eltex.loc/
+REDMINE_USER=ваш.логин
+REDMINE_PASSWORD=ваш_пароль
+REDMINE_AUTHOR=Иванов Иван Иванович
+DEFAULT_FROM_DATE=2026-01-01
+DEFAULT_TO_DATE=2026-01-31
+```
+
+Пример вывода в ODT (заголовок):
+> **Иванов Иван Иванович. Отчёт за месяц Январь.**
+
+Пример консольного вывода:
 ```
 ✅ Total issues: 7 [2026-01-01--2026-01-31]
 ╒════════════╤═══════════╤══════════════════════════════════════╤═══════════╤════════════╕
@@ -129,6 +155,6 @@ isort .
 ---
 
 > 🔒 **Важно**:  
-> - Никогда не коммитьте `.env`, пароли или логины.  
+> - Никогда не коммитьте `.env`, пароли или логины.
 > - Файл `.gitignore` уже исключает все чувствительные артефакты.  
 > - Инструмент работает только в режиме **чтения** — он не может изменять данные в Redmine.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "redmine-reporter"
-version = "1.0.0"
+version = "1.3.0"
 description = "Redmine time-entry based issue reporter for internal use"
 readme = "README.md"
 authors = [{ name = "Artem Kokos", email = "artem-kokos@mail.ru" }]
@@ -23,6 +23,7 @@ dependencies = [
     "python-redmine>=2.4.0",
     "tabulate>=0.9.0",
     "python-dotenv>=1.0.0",
+    "odfpy>=1.4.0",
 ]
 
 [project.optional-dependencies]

redmine_reporter/__init__.py

@@ -1 +1 @@
-__version__ = "1.0.0"
+__version__ = "1.3.0"

redmine_reporter/cli.py

@@ -2,9 +2,14 @@ import sys
 import argparse
 from typing import List, Optional
 from redminelib.resources import Issue
+
 from .config import Config
 from .client import fetch_issues_with_spent_time
+from .report_builder import build_grouped_report
 from .formatter import format_compact, format_table
+from .formatter_odt import format_odt
+from .formatter_csv import format_csv
+from .formatter_md import format_md
 
 
 def parse_date_range(date_arg: str) -> tuple[str, str]:
@@ -32,6 +37,20 @@ def main(argv: Optional[List[str]] = None) -> int:
         action="store_true",
         help="Use compact plain-text output instead of table"
     )
+    parser.add_argument(
+        "--output",
+        help="Path to output .odt file (e.g., report.odt). If omitted, prints to stdout."
+    )
+    parser.add_argument(
+        "--author",
+        default="",
+        help="Override author name from .env (REDMINE_AUTHOR)"
+    )
+    parser.add_argument(
+        "--no-time",
+        action="store_true",
+        help="Do not include spent time into table"
+    )
     args = parser.parse_args(argv)
 
     try:
@@ -58,15 +77,52 @@ def main(argv: Optional[List[str]] = None) -> int:
 
     print(f"✅ Total issues: {len(issue_hours)} [{args.date}]")
 
-    try:
-        if args.compact:
-            output = format_compact(issue_hours)
-        else:
-            output = format_table(issue_hours)
-        print(output)
-    except Exception as e:
-        print(f"❌ Formatting error: {e}", file=sys.stderr)
-        return 1
+    rows = build_grouped_report(issue_hours, fill_time=not args.no_time)
+
+    if args.output:
+        if not (args.output.endswith(".odt") or args.output.endswith(".csv") or args.output.endswith(".md")):
+            print("❌ Output file must end with .odt, .csv or .md", file=sys.stderr)
+            return 1
+
+        try:
+            if args.output.endswith(".odt"):
+                doc = format_odt(
+                    rows,
+                    author=Config.get_author(args.author),
+                    from_date=from_date,
+                    to_date=to_date,
+                )
+                doc.save(args.output)
+            elif args.output.endswith(".csv"):
+                content = format_csv(rows)
+                with open(args.output, "w", encoding="utf-8", newline="") as f:
+                    f.write(content)
+            elif args.output.endswith(".md"):
+                content = format_md(rows)
+                with open(args.output, "w", encoding="utf-8") as f:
+                    f.write(content)
+
+            print(f"✅ Report saved to {args.output}")
+        except ImportError as e:
+            if args.output.endswith(".odt"):
+                print("❌ odfpy is not installed. Install with: pip install odfpy", file=sys.stderr)
+            else:
+                print(f"❌ Import error: {e}", file=sys.stderr)
+            return 1
+        except Exception as e:
+            fmt = "ODT" if args.output.endswith(".odt") else ("CSV" if args.output.endswith(".csv") else "Markdown")
+            print(f"❌ {fmt} export error: {e}", file=sys.stderr)
+            return 1
+    else:
+        try:
+            if args.compact:
+                output = format_compact(rows)
+            else:
+                output = format_table(rows)
+            print(output)
+        except Exception as e:
+            print(f"❌ Formatting error: {e}", file=sys.stderr)
+            return 1
 
     return 0
 

redmine_reporter/config.py

@@ -9,9 +9,19 @@ class Config:
     REDMINE_URL = os.getenv("REDMINE_URL", "").rstrip("/")
     REDMINE_USER = os.getenv("REDMINE_USER")
     REDMINE_PASSWORD = os.getenv("REDMINE_PASSWORD")
+    REDMINE_AUTHOR = os.getenv("REDMINE_AUTHOR")
     DEFAULT_FROM_DATE = os.getenv("DEFAULT_FROM_DATE")
     DEFAULT_TO_DATE = os.getenv("DEFAULT_TO_DATE")
 
+    @classmethod
+    def get_author(cls, cli_author: str = "") -> str:
+        """Возвращает автора: из CLI если задан, иначе из .env, иначе — заглушку."""
+        if cli_author:
+            return cli_author
+        if cls.REDMINE_AUTHOR:
+            return cls.REDMINE_AUTHOR
+        return ""
+
     @classmethod
     def get_default_date_range(cls) -> str:
         if cls.DEFAULT_FROM_DATE and cls.DEFAULT_TO_DATE:

redmine_reporter/formatter.py

@@ -1,83 +1,30 @@
-from typing import List, Tuple
-from redminelib.resources import Issue
-from .utils import get_version
+from typing import List
+from tabulate import tabulate
+from .types import ReportRow
 
 
-STATUS_TRANSLATION = {
-    'Closed': 'Закрыто',
-    'Re-opened': 'В работе',
-    'New': 'В работе',
-    'Resolved': 'Решена',
-    'Pending': 'Ожидание',
-    'Feedback': 'В работе',
-    'In Progress': 'В работе',
-    'Rejected': 'Закрыто',
-    'Confirming': 'Ожидание',
-}
-
-
-def hours_to_human(hours: float) -> str:
-    if hours <= 0:
-        return "0ч"
-
-    total_minutes = round(hours * 60)
-    h = total_minutes // 60
-    m = total_minutes % 60
-    parts = []
-
-    if h:
-        parts.append(f"{h}ч")
-    if m:
-        parts.append(f"{m}м")
-
-    return " ".join(parts) if parts else "0ч"
-
-
-def format_compact(issue_hours: List[Tuple[Issue, float]]) -> str:
+def format_compact(rows: List[ReportRow]) -> str:
     lines = []
-    prev_project = None
-    prev_version = None
 
-    for issue, hours in issue_hours:
-        project = str(issue.project)
-        version = get_version(issue)
-        status = str(issue.status)
-
-        display_project = project if project != prev_project else ""
-        display_version = version if (project != prev_project or version != prev_version) else ""
-        lines.append(f"{display_project} | {display_version} | {issue.id}. {issue.subject} | {status} | {hours_to_human(hours)}")
-
-        prev_project = project
-        prev_version = version
+    for r in rows:
+        lines.append(
+            f"{r['display_project']} | {r['display_version']} | "
+            f"{r['issue_id']}. {r['subject']} | {r['status_ru']} | {r['time_text']}"
+        )
 
     return "\n".join(lines)
 
 
-def format_table(issue_hours: List[Tuple[Issue, float]]) -> str:
-    from tabulate import tabulate
+def format_table(rows: List[ReportRow]) -> str:
+    table_rows = [['Проект', 'Версия', 'Задача', 'Статус', 'Затрачено']]
 
-    rows = [['Проект', 'Версия', 'Задача', 'Статус', 'Затрачено']]
-    prev_project = None
-    prev_version = None
-
-    for issue, hours in issue_hours:
-        project = str(issue.project)
-        version = get_version(issue)
-        status_en = str(issue.status)
-        status_ru = STATUS_TRANSLATION.get(status_en, status_en)
-
-        display_project = project if project != prev_project else ""
-        display_version = version if (project != prev_project or version != prev_version) else ""
-
-        rows.append([
-            display_project,
-            display_version,
-            f"{issue.id}. {issue.subject}",
-            status_ru,
-            hours_to_human(hours)
+    for r in rows:
+        table_rows.append([
+            r['display_project'],
+            r['display_version'],
+            f"{r['issue_id']}. {r['subject']}",
+            r['status_ru'],
+            r['time_text']
         ])
 
-        prev_project = project
-        prev_version = version
-
-    return tabulate(rows, headers="firstrow", tablefmt="fancy_grid")
+    return tabulate(table_rows, headers="firstrow", tablefmt="fancy_grid")

redmine_reporter/formatter_csv.py

@@ -0,0 +1,22 @@
+import csv
+import io
+from typing import List
+from .types import ReportRow
+
+
+def format_csv(rows: List[ReportRow]) -> str:
+    output = io.StringIO()
+    writer = csv.writer(output, dialect="excel")
+    writer.writerow(["Project", "Version", "Issue ID", "Subject", "Status", "Spent Time"])
+
+    for r in rows:
+        writer.writerow([
+            r["project"],
+            r["version"],
+            r["issue_id"],
+            r["subject"],
+            r["status_ru"],
+            r["time_text"]
+        ])
+
+    return output.getvalue()

redmine_reporter/formatter_md.py

@@ -0,0 +1,19 @@
+from typing import List
+from .types import ReportRow
+
+
+def format_md(rows: List[ReportRow]) -> str:
+    lines = [
+        "| Проект | Версия | Задача | Статус | Затрачено |",
+        "|--------|--------|--------|--------|-----------|"
+    ]
+
+    for r in rows:
+        task_cell = f"{r['issue_id']}. {r['subject']}"
+
+        lines.append(
+            f"| {r['display_project']} | {r['display_version']} "
+            f"| {task_cell} | {r['status_ru']} | {r['time_text']} |"
+        )
+
+    return "\n".join(lines)

redmine_reporter/formatter_odt.py

@@ -0,0 +1,131 @@
+import os
+from typing import List
+from odf.opendocument import load
+from odf.text import P
+from odf.table import Table, TableColumn, TableRow, TableCell
+from odf.style import Style, TableColumnProperties, TableCellProperties
+from .types import ReportRow
+from .utils import get_month_name_from_range
+
+
+def format_odt(
+    rows: List[ReportRow],
+    author: str = "",
+    from_date: str = "",
+    to_date: str = "",
+) -> "OpenDocument":
+    template_path = "template.odt"
+    if not os.path.exists(template_path):
+        raise FileNotFoundError("Шаблон template.odt не найден...")
+
+    doc = load(template_path)
+    para_style_name = "Standard"
+
+    # Заголовок
+    month_name = get_month_name_from_range(from_date, to_date)
+    header_text = f"{author}. Отчет за месяц {month_name}."
+    doc.text.addElement(P(stylename=para_style_name, text=header_text))
+    doc.text.addElement(P(stylename=para_style_name, text=""))
+
+    # Стиль ячеек
+    cell_style_name = "TableCellStyle"
+    cell_style = Style(name=cell_style_name, family="table-cell")
+    cell_props = TableCellProperties(padding="0.04in", border="0.05pt solid #000000")
+    cell_style.addElement(cell_props)
+    doc.automaticstyles.addElement(cell_style)
+
+    # Таблица
+    table = Table(name="Report")
+    column_widths = ["1.56in", "1.63in", "3.93in", "1.56in", "1.43in"]
+    for width in column_widths:
+        col_style = Style(name=f"col_{width}", family="table-column")
+        col_props = TableColumnProperties(columnwidth=width)
+        col_style.addElement(col_props)
+        doc.automaticstyles.addElement(col_style)
+        table.addElement(TableColumn(stylename=col_style))
+
+    # Заголовки
+    header_row = TableRow()
+    for text in ["Наименование Проекта", "Номер версии*", "Задача", "Статус Готовность*", "Затрачено за отчетный период"]:
+        cell = TableCell(stylename=cell_style_name)
+        cell.addElement(P(stylename=para_style_name, text=text))
+        header_row.addElement(cell)
+    table.addElement(header_row)
+
+    projects = {}
+    for r in rows:
+        project = r["project"]
+        version = r["version"]
+        if project not in projects:
+            projects[project] = {}
+        if version not in projects[project]:
+            projects[project][version] = []
+        projects[project][version].append(r)
+
+    # Данные с двухуровневой группировкой и объединением ячеек
+    for project, versions in projects.items():
+        total_project_rows = sum(len(rows_for_version) for rows_for_version in versions.values())
+        first_version_in_project = True
+
+        for version, rows_for_version in versions.items():
+            row_span_version = len(rows_for_version)
+            first_row_in_version = True
+
+            for r in rows_for_version:
+                row = TableRow()
+
+                # Ячейка "Проект" - только в первой строке всего проекта
+                if first_version_in_project and first_row_in_version:
+                    cell_project = TableCell(stylename=cell_style_name)
+                    cell_project.setAttribute("numberrowsspanned", str(total_project_rows))
+                    p = P(stylename=para_style_name, text=project)  # Полное название проекта
+                    cell_project.addElement(p)
+                    row.addElement(cell_project)
+
+                # Ячейка "Версия" - только в первой строке каждой версии
+                if first_row_in_version:
+                    cell_version = TableCell(stylename=cell_style_name)
+                    cell_version.setAttribute("numberrowsspanned", str(row_span_version))
+                    p = P(stylename=para_style_name, text=version)
+                    cell_version.addElement(p)
+                    row.addElement(cell_version)
+                    first_row_in_version = False
+                else:
+                    # Пропускаем - уже объединена
+                    pass
+
+                # Остальные колонки
+                task_cell = TableCell(stylename=cell_style_name)
+                task_text = f"{r['issue_id']}. {r['subject']}"
+                p = P(stylename=para_style_name, text=task_text)
+                task_cell.addElement(p)
+                row.addElement(task_cell)
+
+                status_cell = TableCell(stylename=cell_style_name)
+                p = P(stylename=para_style_name, text=r["status_ru"])
+                status_cell.addElement(p)
+                row.addElement(status_cell)
+
+                time_cell = TableCell(stylename=cell_style_name)
+                p = P(stylename=para_style_name, text=r["time_text"])
+                time_cell.addElement(p)
+                row.addElement(time_cell)
+
+                table.addElement(row)
+                first_version_in_project = False
+
+    doc.text.addElement(table)
+    doc.text.addElement(P(stylename=para_style_name, text=""))
+
+    # Справка
+    for line in [
+        "«Наименование Проекта»  - Имя собственное устройства или программного обеспечения.",
+        "«Номер версии» -  Версия в проекте. Опциональное поле.",
+        "«Задача» -  Номер по Redmine и формулировка.",
+        "«Статус» -  Актуальное состояние задачи на момент отчета. Статусы: закрыто, в работе, ожидание, решена.",
+        "«Готовность» – Опциональное поле в процентах.",
+        "«Затрачено за отчетный период»  - в днях или часах."
+    ]:
+        doc.text.addElement(P(stylename=para_style_name, text=line))
+
+    return doc

redmine_reporter/report_builder.py

@@ -0,0 +1,62 @@
+from typing import List, Tuple, cast
+from redminelib.resources import Issue
+from .types import ReportRow
+from .utils import get_version, hours_to_human
+
+
+STATUS_TRANSLATION = {
+    'Closed': 'Закрыто',
+    'Re-opened': 'В работе',
+    'New': 'В работе',
+    'Resolved': 'Решена',
+    'Pending': 'Ожидание',
+    'Feedback': 'В работе',
+    'In Progress': 'В работе',
+    'Rejected': 'Закрыто',
+    'Confirming': 'Ожидание',
+}
+
+
+def build_grouped_report(
+    issue_hours: List[Tuple[Issue, float]],
+    fill_time: bool = True,
+) -> List[ReportRow]:
+    """
+    Преобразует список задач с затраченным временем в плоский список строк отчёта,
+    с учётом группировки по проекту и версии (пустые ячейки для повторяющихся значений).
+    """
+
+    rows: List[ReportRow] = []
+    prev_project: str = ""
+    prev_version: str = ""
+
+    for issue, hours in issue_hours:
+        project = str(issue.project)
+        version = get_version(issue)
+        status_en = str(issue.status)
+        status_ru = STATUS_TRANSLATION.get(status_en, status_en)
+        time_text = hours_to_human(hours) if fill_time else ""
+
+        display_project = project if project != prev_project else ""
+        display_version = version if (project != prev_project or version != prev_version) else ""
+
+        rows.append(
+            cast(
+                ReportRow,
+                {
+                    "project": project,
+                    "version": version,
+                    "display_project": display_project,
+                    "display_version": display_version,
+                    "issue_id": issue.id,
+                    "subject": issue.subject,
+                    "status_ru": status_ru,
+                    "time_text": time_text,
+                },
+            )
+        )
+
+        prev_project = project
+        prev_version = version
+
+    return rows

redmine_reporter/types.py

@@ -0,0 +1,14 @@
+from typing import TypedDict
+
+
+class ReportRow(TypedDict):
+    """Строка итогового отчёта."""
+
+    project: str
+    version: str
+    display_project: str
+    display_version: str
+    issue_id: int
+    subject: str
+    status_ru: str
+    time_text: str

redmine_reporter/utils.py

@@ -1,2 +1,41 @@
+from datetime import datetime
+
+
+def get_month_name_from_range(from_date: str, to_date: str) -> str:
+    """Определяет название месяца по диапазону дат"""
+
+    try:
+        end = datetime.strptime(to_date, "%Y-%m-%d")
+    except ValueError:
+        return "Январь"
+
+    months = [
+        "", "Январь", "Февраль", "Март", "Апрель", "Май", "Июнь",
+        "Июль", "Август", "Сентябрь", "Октябрь", "Ноябрь", "Декабрь"
+    ]
+
+    return months[end.month]
+
+
 def get_version(issue) -> str:
+    """Возвращает версию задачи или '<N/A>', если не задана."""
     return str(getattr(issue, 'fixed_version', '<N/A>'))
+
+
+def hours_to_human(hours: float) -> str:
+    """Преобразует часы в человекочитаемый формат: '2ч 30м'."""
+
+    if hours <= 0:
+        return "0ч"
+
+    total_minutes = round(hours * 60)
+    h = total_minutes // 60
+    m = total_minutes % 60
+    parts = []
+
+    if h:
+        parts.append(f"{h}ч")
+    if m:
+        parts.append(f"{m}м")
+
+    return " ".join(parts) if parts else "0ч"

tests/test_formatter_odt.py

@@ -0,0 +1,73 @@
+import tempfile
+from types import SimpleNamespace
+from redmine_reporter.formatter_odt import format_odt
+
+
+def make_mock_issue(id_, project, subject, status, fixed_version=None):
+    """Создаёт лёгкий mock-объект, имитирующий Issue из redminelib."""
+
+    issue = SimpleNamespace()
+    issue.id = id_
+    issue.project = project
+    issue.subject = subject
+    issue.status = status
+
+    if fixed_version is not None:
+        issue.fixed_version = fixed_version
+    return issue
+
+
+def test_format_odt_basic():
+    issues = [
+        (make_mock_issue(101, "Камеры", "Поддержка нового датчика", "In Progress", "v2.5.0"), 2.5),
+        (make_mock_issue(102, "Камеры", "Исправить утечку памяти", "Resolved", "v2.5.0"), 4.0),
+        (make_mock_issue(103, "ПО", "Обновить документацию", "Pending", None), 12.0),
+    ]
+
+    doc = format_odt(issues)
+
+    # Сохраняем и проверяем содержимое
+    with tempfile.NamedTemporaryFile(suffix=".odt") as tmp:
+        doc.save(tmp.name)
+
+        # Проверяем, что файл - это ZIP (ODT основан на ZIP)
+        with open(tmp.name, "rb") as f:
+            assert f.read(2) == b"PK"
+
+        # Извлекаем content.xml
+        import zipfile
+        with zipfile.ZipFile(tmp.name) as zf:
+            content_xml = zf.read("content.xml").decode("utf-8")
+
+        # Проверяем заголовки
+        assert "Проект" in content_xml
+        assert "Версия" in content_xml
+        assert "Задача" in content_xml
+        assert "Статус" in content_xml
+        assert "Затрачено" in content_xml
+
+        # Проверяем данные задач
+        assert "101. Поддержка нового датчика" in content_xml
+        assert "102. Исправить утечку памяти" in content_xml
+        assert "103. Обновить документацию" in content_xml
+
+        # Проверяем проекты и версии
+        assert "Камеры" in content_xml
+        assert "ПО" in content_xml
+        assert "v2.5.0" in content_xml
+        assert "&lt;N/A&gt;" in content_xml or "<N/A>" in content_xml  # зависит от экранирования
+
+        # Проверяем перевод статусов
+        assert "В работе" in content_xml   # In Progress
+        assert "Решена" in content_xml     # Resolved
+        assert "Ожидание" in content_xml   # Pending
+
+        # Проверяем формат времени
+        assert "2ч 30м" in content_xml
+        assert "4ч" in content_xml
+        assert "12ч" in content_xml
+
+        # Проверяем группировку: "Камеры" должен встречаться только один раз явно
+        # (вторая строка — пустая ячейка)
+        cam_occurrences = content_xml.count(">Камеры<")
+        assert cam_occurrences == 1