初心者向け No.064

お小遣い帳

収入・支出を入力して残高を管理するシンプルな家計アプリ。カテゴリ別集計とCSVエクスポート機能付き。

🎯 難易度: ★★☆ 📦 ライブラリ: tkinter（標準ライブラリ） ⏱️ 制作時間: 30〜90分

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

収入・支出を入力して残高を管理するシンプルな家計アプリ。カテゴリ別集計とCSVエクスポート機能付き。

このアプリはorganizersカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★★☆ です。

このアプリは「整理ツール」カテゴリです。整理・分類系のツールはデータ構造とユーザー操作を結びつける書き方を学ぶ好機です。設計次第で書きやすさが大きく変わります。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

動かしながら読むことが理解の最短経路です。まずはコードをコピーして実行し、想定どおりに動くことを確認したうえで解説と照らし合わせてください。

カスタマイズでは「機能追加」「UI 改善」「エラー耐性」の三方向で考えると視野が広がります。練習問題にもそれぞれの方向の具体例を用意しています。

お小遣い帳実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「追加」ボタン（add_record()）・「選択行を削除」ボタン（delete_selected()）・「CSV保存」ボタン（save_csv()）・「CSV読込」ボタン（load_csv()）・「全消去」ボタン（clear_all()）で操作
ttk.Treeview による表形式の一覧表示
CSV ファイルへの書き出し
filedialog.askopenfilename() によるファイル選択ダイアログ
filedialog.asksaveasfilename() によるファイル選択ダイアログ
messagebox.askyesno()・messagebox.showerror()・messagebox.showinfo() によるダイアログ通知
ウィンドウはタイトル「お小遣い帳」・サイズ 760x552 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

Python 3.10 以上
OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

4. 完全なソースコード

💡

コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

✅ 追加インストール不要（標準ライブラリのみ使用）

app064.py

import csv
import datetime as _dt
import tkinter as tk
from tkinter import ttk, messagebox, filedialog


class App064:
    """お小遣い帳"""

    CATEGORIES = ["食費", "交通費", "娯楽", "学用品", "おこづかい", "お祝い", "その他"]

    def __init__(self, root):
        self.root = root
        self.root.title("お小遣い帳")
        self.root.geometry("760x552")
        self.root.minsize(760, 552)
        self.root.configure(bg="#f8f9fc")
        # 取引データ: list of dict(date, type, category, amount, memo)
        self.records = []
        self._build_ui()
        self._refresh_view()

    def _build_ui(self):
        """UIを構築する"""
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(
            title_frame, text="お小遣い帳",
            font=("Noto Sans JP", 16, "bold"),
            bg="#3776ab", fg="white"
        ).pack()

        main = tk.Frame(self.root, bg="#f8f9fc", padx=16, pady=12)
        main.pack(fill=tk.BOTH, expand=True)

        # 入力フォーム
        form = ttk.LabelFrame(main, text="取引を入力", padding=10)
        form.pack(fill=tk.X, pady=(0, 8))

        ttk.Label(form, text="日付(YYYY-MM-DD):").grid(row=0, column=0, sticky="w")
        self.date_var = tk.StringVar(value=_dt.date.today().isoformat())
        ttk.Entry(form, textvariable=self.date_var, width=12).grid(row=0, column=1, padx=4)

        ttk.Label(form, text="種別:").grid(row=0, column=2, sticky="w")
        self.type_var = tk.StringVar(value="支出")
        ttk.Combobox(form, textvariable=self.type_var,
                     values=["収入", "支出"], width=6, state="readonly"
                     ).grid(row=0, column=3, padx=4)

        ttk.Label(form, text="カテゴリ:").grid(row=0, column=4, sticky="w")
        self.cat_var = tk.StringVar(value=self.CATEGORIES[0])
        ttk.Combobox(form, textvariable=self.cat_var,
                     values=self.CATEGORIES, width=10
                     ).grid(row=0, column=5, padx=4)

        ttk.Label(form, text="金額:").grid(row=1, column=0, sticky="w", pady=(6, 0))
        self.amount_var = tk.StringVar()
        ttk.Entry(form, textvariable=self.amount_var, width=12
                  ).grid(row=1, column=1, padx=4, pady=(6, 0))

        ttk.Label(form, text="メモ:").grid(row=1, column=2, sticky="w", pady=(6, 0))
        self.memo_var = tk.StringVar()
        ttk.Entry(form, textvariable=self.memo_var, width=30
                  ).grid(row=1, column=3, columnspan=3, padx=4, pady=(6, 0), sticky="ew")

        # 操作ボタン
        btns = tk.Frame(main, bg="#f8f9fc")
        btns.pack(fill=tk.X, pady=4)
        ttk.Button(btns, text="追加", command=self.add_record).pack(side=tk.LEFT, padx=2)
        ttk.Button(btns, text="選択行を削除", command=self.delete_selected).pack(side=tk.LEFT, padx=2)
        ttk.Button(btns, text="CSV保存", command=self.save_csv).pack(side=tk.LEFT, padx=2)
        ttk.Button(btns, text="CSV読込", command=self.load_csv).pack(side=tk.LEFT, padx=2)
        ttk.Button(btns, text="全消去", command=self.clear_all).pack(side=tk.LEFT, padx=2)

        # 取引一覧
        list_frame = ttk.LabelFrame(main, text="取引履歴", padding=4)
        list_frame.pack(fill=tk.BOTH, expand=True, pady=(4, 4))
        cols = ("date", "type", "category", "amount", "memo")
        self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=10)
        for c, w, t in [("date", 90, "日付"), ("type", 60, "種別"),
                         ("category", 90, "カテゴリ"), ("amount", 90, "金額"),
                         ("memo", 240, "メモ")]:
            self.tree.heading(c, text=t)
            self.tree.column(c, width=w, anchor="center")
        self.tree.pack(fill=tk.BOTH, expand=True, side=tk.LEFT)
        sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)

        # サマリー表示
        summary = ttk.LabelFrame(main, text="集計", padding=8)
        summary.pack(fill=tk.X)
        self.summary_var = tk.StringVar()
        tk.Label(summary, textvariable=self.summary_var, bg="#f8f9fc",
                 font=("Noto Sans JP", 10), justify=tk.LEFT
                 ).pack(anchor="w")

    def add_record(self):
        """取引を追加する"""
        date = self.date_var.get().strip()
        ttype = self.type_var.get().strip()
        category = self.cat_var.get().strip() or "その他"
        amount_s = self.amount_var.get().strip()
        memo = self.memo_var.get().strip()
        try:
            _dt.date.fromisoformat(date)
        except ValueError:
            messagebox.showerror("エラー", "日付は YYYY-MM-DD 形式で入力してください")
            return
        try:
            amount = int(amount_s)
            if amount <= 0:
                raise ValueError
        except ValueError:
            messagebox.showerror("エラー", "金額は正の整数で入力してください")
            return
        if ttype not in ("収入", "支出"):
            messagebox.showerror("エラー", "種別は 収入/支出 を選択してください")
            return
        self.records.append({
            "date": date, "type": ttype, "category": category,
            "amount": amount, "memo": memo,
        })
        self.amount_var.set("")
        self.memo_var.set("")
        self._refresh_view()

    def delete_selected(self):
        """選択された行を削除する"""
        sel = self.tree.selection()
        if not sel:
            messagebox.showinfo("情報", "削除する行を選択してください")
            return
        for item in sel:
            idx = int(self.tree.item(item, "tags")[0])
            self.records[idx] = None
        self.records = [r for r in self.records if r is not None]
        self._refresh_view()

    def clear_all(self):
        """全データを消去する"""
        if not self.records:
            return
        if messagebox.askyesno("確認", "全ての取引を削除しますか?"):
            self.records.clear()
            self._refresh_view()

    def save_csv(self):
        """CSVファイルとして保存する"""
        if not self.records:
            messagebox.showinfo("情報", "保存する取引がありません")
            return
        path = filedialog.asksaveasfilename(
            defaultextension=".csv",
            filetypes=[("CSVファイル", "*.csv")],
            initialfile="allowance.csv",
        )
        if not path:
            return
        try:
            with open(path, "w", newline="", encoding="utf-8-sig") as f:
                w = csv.DictWriter(f, fieldnames=["date", "type", "category", "amount", "memo"])
                w.writeheader()
                w.writerows(self.records)
            messagebox.showinfo("完了", f"保存しました: {path}")
        except OSError as e:
            messagebox.showerror("エラー", f"保存に失敗しました: {e}")

    def load_csv(self):
        """CSVファイルから読み込む"""
        path = filedialog.askopenfilename(filetypes=[("CSVファイル", "*.csv")])
        if not path:
            return
        try:
            with open(path, "r", encoding="utf-8-sig") as f:
                reader = csv.DictReader(f)
                loaded = []
                for row in reader:
                    try:
                        loaded.append({
                            "date": row["date"],
                            "type": row["type"],
                            "category": row.get("category", "その他"),
                            "amount": int(row["amount"]),
                            "memo": row.get("memo", ""),
                        })
                    except (KeyError, ValueError):
                        continue
            self.records.extend(loaded)
            self._refresh_view()
            messagebox.showinfo("完了", f"{len(loaded)} 件読み込みました")
        except (OSError, csv.Error) as e:
            messagebox.showerror("エラー", f"読み込みに失敗しました: {e}")

    def _refresh_view(self):
        """ツリービューと集計を更新する"""
        self.tree.delete(*self.tree.get_children())
        income = 0
        expense = 0
        cat_sum = {}
        # 日付昇順表示
        ordered = sorted(enumerate(self.records), key=lambda x: x[1]["date"])
        for idx, r in ordered:
            sign = "+" if r["type"] == "収入" else "-"
            self.tree.insert("", tk.END, values=(
                r["date"], r["type"], r["category"],
                f"{sign}{r['amount']:,}円", r["memo"]
            ), tags=(str(idx),))
            if r["type"] == "収入":
                income += r["amount"]
            else:
                expense += r["amount"]
                cat_sum[r["category"]] = cat_sum.get(r["category"], 0) + r["amount"]
        balance = income - expense
        cat_lines = ", ".join(f"{k}:{v:,}円" for k, v in sorted(cat_sum.items(), key=lambda x: -x[1]))
        self.summary_var.set(
            f"収入合計: {income:,}円  支出合計: {expense:,}円  残高: {balance:,}円\n"
            f"支出カテゴリ別: {cat_lines or '(なし)'}"
        )


if __name__ == "__main__":
    root = tk.Tk()
    app = App064(root)
    root.mainloop()

5. コード解説

お小遣い帳のコードを、実際に書かれている実装に沿って解説します。

クラス設計とコンストラクタ

App064 クラスにアプリの全機能をまとめています（メソッド8個・全225行）。__init__ ではタイトル「お小遣い帳」とウィンドウサイズ 760x552 を設定します。そのあと _build_ui() → _refresh_view() の順に呼び出して初期状態を作ります。