Учёт расходов
Дописывает расходы в CSV и строит отчёты по категориям и месяцам.
Что делает скрипт
Каждая запись содержит дату, категорию, сумму, валюту и комментарий. Скрипт проверяет числа через Decimal и не меняет старые строки, только добавляет новые. Отчёт показывает суммы по категориям и общий итог за выбранный месяц.
Быстрый старт
python expenses.py add --amount 12.50 --category food --note "Обед"
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python expenses.py add --amount 12.50 --category food --note "Обед"python expenses.py list --month 2026-11python expenses.py report --month 2026-11
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
expenses.py
#!/usr/bin/env python3
"""Учёт расходов в CSV с отчётом по категориям."""
from __future__ import annotations
import argparse
import csv
from collections import defaultdict
from datetime import date
from decimal import Decimal, InvalidOperation, ROUND_HALF_UP
from pathlib import Path
DEFAULT_DATA = Path.home() / ".productivity" / "expenses.csv"
FIELDS = ["date", "category", "amount", "currency", "note"]
def parse_amount(value: str) -> Decimal:
try:
amount = Decimal(value)
except InvalidOperation:
raise SystemExit(f"Неверная сумма: {value}")
if amount <= 0:
raise SystemExit("Сумма должна быть положительной")
return amount.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
def command_add(args: argparse.Namespace) -> int:
try:
day = date.fromisoformat(args.date) if args.date else date.today()
except ValueError:
raise SystemExit("Дата указывается в формате YYYY-MM-DD")
category = args.category.strip().lower()
if not category:
raise SystemExit("Категория не может быть пустой")
amount = parse_amount(args.amount)
args.data.parent.mkdir(parents=True, exist_ok=True)
is_new = not args.data.exists()
with args.data.open("a", encoding="utf-8", newline="") as handle:
writer = csv.DictWriter(handle, fieldnames=FIELDS)
if is_new:
writer.writeheader()
writer.writerow({
"date": day.isoformat(),
"category": category,
"amount": f"{amount:.2f}",
"currency": args.currency.upper(),
"note": args.note.strip(),
})
print(f"Записано: {day.isoformat()} {amount} {args.currency.upper()} {category}")
return 0
def read_rows(path: Path, month: str) -> list[dict]:
if not path.exists():
return []
rows = []
with path.open(encoding="utf-8", newline="") as handle:
for row in csv.DictReader(handle):
if month and not str(row.get("date", "")).startswith(month):
continue
rows.append(row)
return rows
def command_list(args: argparse.Namespace) -> int:
rows = read_rows(args.data, args.month)
if not rows:
print("Записей нет.")
return 0
for row in rows:
note = f" {row['note']}" if row.get("note") else ""
print(f"{row['date']} {row['category']:14} {row['amount']:>10} {row['currency']}{note}")
return 0
def command_report(args: argparse.Namespace) -> int:
rows = read_rows(args.data, args.month)
if not rows:
print("Записей нет.")
return 0
totals: dict[str, Decimal] = defaultdict(Decimal)
currencies = set()
for row in rows:
try:
amount = Decimal(row["amount"])
except (InvalidOperation, KeyError):
continue
totals[row.get("category", "?")] += amount
currencies.add(row.get("currency", ""))
if len(currencies) > 1:
print("Внимание: в отчёте несколько валют, суммы не приводятся друг к другу.")
print(f"Период: {args.month or 'всё время'}")
for category in sorted(totals):
print(f"{category:20} {totals[category]:>12.2f}")
total = sum(totals.values(), Decimal("0"))
print(f"{'Итого':20} {total:>12.2f}")
print(f"Записей: {len(rows)}")
return 0
def build_parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(description="Учёт расходов")
parser.add_argument("--data", type=Path, default=DEFAULT_DATA)
sub = parser.add_subparsers(dest="command", required=True)
add_parser = sub.add_parser("add", help="Добавить расход")
add_parser.add_argument("--amount", required=True)
add_parser.add_argument("--category", required=True)
add_parser.add_argument("--note", default="")
add_parser.add_argument("--date", default="")
add_parser.add_argument("--currency", default="USD")
add_parser.set_defaults(func=command_add)
list_parser = sub.add_parser("list", help="Показать расходы")
list_parser.add_argument("--month", default="")
list_parser.set_defaults(func=command_list)
report_parser = sub.add_parser("report", help="Отчёт по категориям")
report_parser.add_argument("--month", default="")
report_parser.set_defaults(func=command_report)
return parser
def main() -> int:
args = build_parser().parse_args()
if getattr(args, "month", "") and len(args.month) != 7:
raise SystemExit("Месяц указывается в формате YYYY-MM")
return args.func(args)
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.