HTML-отчет из CSV
Строит HTML-таблицу с данными и сводкой по числовым колонкам.
Что делает скрипт
Скрипт читает 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
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.