Мониторинг и отчёты

HTML-отчет из CSV

Строит HTML-таблицу с данными и сводкой по числовым колонкам.

Python Windows macOS Linux Средний
Скачать html_report.py
Описание

Что делает скрипт

Скрипт читает CSV, определяет числовые колонки и считает минимум, максимум и среднее. Данные выводятся в таблицу с экранированием HTML, отчет записывается атомарно. Подходит для ежедневной публикации метрик без веб-сервера.

Перед запуском
  • Перезаписывает выходной HTML-файл.
Запуск

Быстрый старт

python html_report.py --input metrics.csv --output report.html

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python html_report.py --input metrics.csv --output report.html --title 'Daily metrics'
  • python html_report.py --input metrics.csv --output report.html --max-rows 200
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

html_report.py

#!/usr/bin/env python3
"""Строит HTML-отчет из CSV."""
from __future__ import annotations

import argparse
import csv
import html
import os
import sys
import tempfile
from datetime import datetime, timezone
from pathlib import Path


def numeric_summary(rows: list[dict], field: str) -> dict | None:
    values = []
    for row in rows:
        try:
            values.append(float(row[field]))
        except (KeyError, TypeError, ValueError):
            continue
    if not values:
        return None
    return {
        "count": len(values),
        "min": min(values),
        "max": max(values),
        "avg": sum(values) / len(values),
    }


def build_table(rows: list[dict], fields: list[str]) -> str:
    head = "".join(f"<th>{html.escape(field)}</th>" for field in fields)
    body = []
    for row in rows:
        cells = "".join(f"<td>{html.escape(str(row.get(field, '')))}</td>" for field in fields)
        body.append(f"<tr>{cells}</tr>")
    return f"<table><thead><tr>{head}</tr></thead><tbody>{''.join(body)}</tbody></table>"


def main() -> int:
    parser = argparse.ArgumentParser(description="HTML-отчет из CSV")
    parser.add_argument("--input", required=True, type=Path)
    parser.add_argument("--output", required=True, type=Path)
    parser.add_argument("--title", default="Monitoring report")
    parser.add_argument("--max-rows", type=int, default=500)
    args = parser.parse_args()

    try:
        handle = args.input.open("r", encoding="utf-8", newline="")
    except OSError as error:
        print(f"ОШИБКА: {error}", file=sys.stderr)
        return 2

    with handle:
        reader = csv.DictReader(handle)
        fields = reader.fieldnames or []
        rows = list(reader)

    if not fields:
        print("В CSV нет заголовка", file=sys.stderr)
        return 2

    summaries = []
    for field in fields:
        summary = numeric_summary(rows, field)
        if summary:
            summaries.append((field, summary))

    summary_table = ""
    if summaries:
        head = "<tr><th>Поле</th><th>Точек</th><th>Минимум</th><th>Максимум</th><th>Среднее</th></tr>"
        body = "".join(
            f"<tr><td>{html.escape(field)}</td><td>{value['count']}</td>"
            f"<td>{value['min']:.3f}</td><td>{value['max']:.3f}</td><td>{value['avg']:.3f}</td></tr>"
            for field, value in summaries
        )
        summary_table = f"<h2>Сводка</h2><table><thead>{head}</thead><tbody>{body}</tbody></table>"

    visible = rows[: max(args.max_rows, 0)]
    data_table = build_table(visible, fields)
    generated = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M:%S UTC")
    title = html.escape(args.title)
    document = f"""<!doctype html>
<html lang="ru">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{title}</title>
<style>
body {{ font-family: system-ui, sans-serif; margin: 2rem; color: #1f2937; }}
table {{ border-collapse: collapse; margin: 1rem 0; width: 100%; }}
th, td {{ border: 1px solid #d1d5db; padding: 0.45rem 0.6rem; text-align: left; }}
th {{ background: #f3f4f6; }}
h1 {{ margin-bottom: 0.25rem; }}
.muted {{ color: #6b7280; }}
</style>
</head>
<body>
<h1>{title}</h1>
<p class="muted">Сформировано: {generated}. Строк: {len(rows)}.</p>
{summary_table}
<h2>Данные</h2>
{data_table}
</body>
</html>
"""

    target = args.output.expanduser()
    if not target.parent.is_dir():
        print(f"Каталог не найден: {target.parent}", file=sys.stderr)
        return 2

    descriptor, temporary = tempfile.mkstemp(dir=target.parent, prefix=".report-", suffix=".html")
    try:
        with os.fdopen(descriptor, "w", encoding="utf-8") as output:
            output.write(document)
        os.replace(temporary, target)
    except OSError as error:
        print(f"ОШИБКА: {error}", file=sys.stderr)
        return 2

    print(f"Отчет записан: {target}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get monitoring-html-report
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Мониторинг и отчёты

Сбор метрик, проверка доступности, отчёты и уведомления.

Теги