Собрать сводную таблицу в Excel
Строит сводку sum, mean или count по группам и сохраняет её в xlsx с итоговой строкой.
Что делает скрипт
Скрипт читает CSV через pandas, приводит колонку значений к числу и строит pivot_table с итогами. Результат выгружается на отдельный лист Excel с закреплённой шапкой и подобранной шириной колонок. Исходный CSV не изменяется, сводка пишется в новый файл.
- Нечисловые значения колонки --values становятся пустыми и не участвуют в сумме.
Быстрый старт
python pivot_excel.py --input sales.csv --index city --columns month --values amount --output pivot.xlsx
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python pivot_excel.py --input sales.csv --index city --values amount --agg meanpython pivot_excel.py --input orders.csv --index category --columns status --values qty --agg count --force
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install pandas
python3 -m pip install pandas
python3 -m pip install pandas
py -m pip install openpyxl
python3 -m pip install openpyxl
python3 -m pip install openpyxl
pivot_excel.py
#!/usr/bin/env python3
"""Сводная таблица из CSV в xlsx."""
from __future__ import annotations
import argparse
from pathlib import Path
import pandas as pd
from openpyxl.styles import Font
from openpyxl.utils import get_column_letter
def split_columns(value: str) -> list[str]:
return [item.strip() for item in value.split(",") if item.strip()]
def main() -> int:
parser = argparse.ArgumentParser(description="Сводная таблица в Excel")
parser.add_argument("--input", type=Path, required=True, help="Исходный CSV")
parser.add_argument("--output", type=Path, default=Path("pivot.xlsx"), help="Результат")
parser.add_argument("--index", required=True, help="Колонки строк через запятую")
parser.add_argument("--columns", default="", help="Колонки столбцов через запятую")
parser.add_argument("--values", required=True, help="Колонки значений через запятую")
parser.add_argument("--agg", choices=["sum", "mean", "count", "min", "max"], default="sum", help="Агрегат")
parser.add_argument("--force", action="store_true", help="Перезаписать выходной файл")
args = parser.parse_args()
source = args.input.expanduser().resolve()
target = args.output.expanduser().resolve()
if not source.is_file():
parser.error(f"Файл не найден: {source}")
if source == target:
parser.error("Выходной файл не должен совпадать с исходным")
if target.exists() and not args.force:
parser.error(f"Файл уже существует: {target}. Добавьте --force")
if target.suffix.lower() != ".xlsx":
parser.error("Выходной файл должен иметь расширение .xlsx")
index = split_columns(args.index)
columns = split_columns(args.columns)
values = split_columns(args.values)
if not index or not values:
parser.error("Нужны непустые --index и --values")
frame = pd.read_csv(source, dtype=str, keep_default_na=False, encoding="utf-8-sig")
missing = [name for name in index + columns + values if name not in frame.columns]
if missing:
parser.error("Нет колонок: " + ", ".join(sorted(set(missing))))
for column in values:
frame[column] = pd.to_numeric(frame[column], errors="coerce")
if frame[values].notna().sum().sum() == 0:
parser.error("В колонках значений нет чисел")
table = pd.pivot_table(
frame,
index=index,
columns=columns or None,
values=values,
aggfunc=args.agg,
margins=True,
margins_name="Итого",
fill_value=0,
dropna=False,
)
target.parent.mkdir(parents=True, exist_ok=True)
with pd.ExcelWriter(target, engine="openpyxl") as writer:
table.to_excel(writer, sheet_name="Сводная")
worksheet = writer.sheets["Сводная"]
worksheet.freeze_panes = "A2"
for row in worksheet.iter_rows(min_row=1, max_row=1):
for cell in row:
cell.font = Font(bold=True)
for index, column_cells in enumerate(worksheet.columns, start=1):
width = 10
for cell in column_cells:
value = getattr(cell, "value", None)
if value is not None:
width = max(width, min(40, len(str(value)) + 2))
worksheet.column_dimensions[get_column_letter(index)].width = width
print(f"Строк сводки: {len(table)}")
print(f"Агрегат: {args.agg}")
print(f"Результат: {target}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.