お小遣い帳
収入・支出を入力して残高を管理するシンプルな家計アプリ。カテゴリ別集計とCSVエクスポート機能付き。
1. アプリ概要
収入・支出を入力して残高を管理するシンプルな家計アプリ。カテゴリ別集計とCSVエクスポート機能付き。
このアプリはorganizersカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★★☆ です。
このアプリは「整理ツール」カテゴリです。整理・分類系のツールはデータ構造とユーザー操作を結びつける書き方を学ぶ好機です。設計次第で書きやすさが大きく変わります。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。
動かしながら読むことが理解の最短経路です。まずはコードをコピーして実行し、想定どおりに動くことを確認したうえで解説と照らし合わせてください。
カスタマイズでは「機能追加」「UI 改善」「エラー耐性」の三方向で考えると視野が広がります。練習問題にもそれぞれの方向の具体例を用意しています。
2. 機能一覧
- お小遣い帳のメイン機能
- 直感的なGUIインターフェース
- 入力値のバリデーション
- エラーハンドリング
- 結果の見やすい表示
- クリア機能付き
3. 事前準備・環境
Python 3.10 以上 / Windows・Mac・Linux すべて対応
以下の環境で動作確認しています。
- Python 3.10 以上
- OS: Windows 10/11・macOS 12+・Ubuntu 20.04+
4. 完全なソースコード
右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。
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("760x540")
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クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
UIレイアウトの構築
LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
イベント処理
ボタンのcommand引数でクリックイベントを、bind('
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
Textウィジェットでの結果表示
tk.Textウィジェットをstate=DISABLED（読み取り専用）で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
例外処理とエラーハンドリング
try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
6. ステップバイステップガイド
このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。
-
1ファイルを作成する
新しいファイルを作成して app064.py と保存します。
-
2クラスの骨格を作る
App064クラスを定義し、__init__とmainloop()の最小構成を作ります。
-
3タイトルバーを作る
Frameを使ってカラーバー付きのタイトルエリアを作ります。
-
4入力フォームを実装する
LabelFrameとEntryウィジェットで入力エリアを作ります。
-
5処理ロジックを実装する
_execute()メソッドにメインロジックを実装します。
-
6結果表示を実装する
TextウィジェットかLabelに結果を表示する_show_result()を実装します。
-
7エラー処理を追加する
try-exceptとmessageboxでエラーハンドリングを追加します。
7. カスタマイズアイデア
基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。
💡 ダークモードを追加する
bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。
💡 データの保存機能
処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。
💡 設定ダイアログ
フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。
8. よくある問題と解決法
❌ 日本語フォントが表示されない
原因：システムに日本語フォントが見つからない場合があります。
解決法：font引数を省略するかシステムに合ったフォントを指定してください。
❌ ライブラリのインポートエラー
原因：必要なライブラリがインストールされていません。
解決法：pip install コマンドで必要なライブラリをインストールしてください。
❌ ウィンドウサイズが合わない
原因：画面解像度や表示スケールによって異なる場合があります。
解決法：root.geometry()で適切なサイズに調整してください。
9. 練習問題
アプリの理解を深めるための練習問題です。
-
課題1：機能拡張
お小遣い帳に新しい機能を1つ追加してみましょう。
-
課題2：UIの改善
色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。
-
課題3：保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。