#!/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())