Данные и таблицы

Собрать сводную таблицу в Excel

Строит сводку sum, mean или count по группам и сохраняет её в xlsx с итоговой строкой.

Python Windows macOS Linux Продвинутый
Скачать pivot_excel.py
Описание

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

Скрипт читает 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 mean
  • python pivot_excel.py --input orders.csv --index category --columns status --values qty --agg count --force
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
pandas Таблицы и агрегаты
Windows py -m pip install pandas
macOS python3 -m pip install pandas
Linux python3 -m pip install pandas
openpyxl Чтение и запись xlsx
Windows py -m pip install openpyxl
macOS python3 -m pip install openpyxl
Linux 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())

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

CLI 1.0.0

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

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

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

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

Категория

Данные и таблицы

CSV, JSON, SQLite, Excel, очистка, объединение и отчёты.