初心者向け No.34

気分トラッカー

毎日の気分を記録して履歴を一覧表示するアプリ。JSONファイルでデータを保存する方法を学びます。

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

📋 目次

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

1. アプリ概要

毎日の気分を記録して履歴を一覧表示するアプリ。JSONファイルでデータを保存する方法を学びます。

このアプリは管理カテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter（標準ライブラリ） で、難易度は ★★☆ です。

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

完成形を見てから細部の解説に進む流れが効果的です。実行→気になる箇所を解説で確認→自分の手で改造、というサイクルで定着が早まります。

カスタマイズ章では具体的な拡張アイデアを示しています。一つ実装するごとに動作確認することで、変更が予期せぬ副作用を起こさないかも体感できます。

気分トラッカー実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「記録する」ボタン（record()）で操作
JSON ファイルの保存・読み込み（起動時に自動実行）
messagebox.showinfo()・messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「気分トラッカー」・サイズ 641x460 で起動

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. 完全なソースコード

💡

コードのコピー方法

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

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

app34.py

import tkinter as tk
from tkinter import ttk, messagebox
import json
import os
from datetime import date


class App34:
    """気分トラッカー"""

    MOODS = [
        ("😄", "最高", "#27ae60"),
        ("😊", "良い", "#2ecc71"),
        ("😐", "普通", "#f39c12"),
        ("😔", "悪い", "#e67e22"),
        ("😢", "最悪", "#e74c3c"),
    ]
    SAVE_FILE = "mood_log.json"

    def __init__(self, root):
        self.root = root
        self.root.title("気分トラッカー")
        self.root.geometry("641x460")
        self.root.minsize(641, 460)
        self.root.configure(bg="#f8f9fc")
        self.records = self._load()
        self._build_ui()
        self._refresh_history()

    def _load(self):
        if os.path.exists(self.SAVE_FILE):
            with open(self.SAVE_FILE, encoding="utf-8") as f:
                return json.load(f)
        return []

    def _save(self):
        with open(self.SAVE_FILE, "w", encoding="utf-8") as f:
            json.dump(self.records, f, ensure_ascii=False, indent=2)

    def _build_ui(self):
        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_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=12)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 今日の気分
        today_frame = ttk.LabelFrame(main_frame, text=f"今日の気分（{date.today()}）", padding=10)
        today_frame.pack(fill=tk.X, pady=(0, 10))

        bg_color = self.root.cget("bg")
        mood_row = tk.Frame(today_frame, bg=bg_color)
        mood_row.pack()
        self.mood_var = tk.IntVar(value=-1)
        for i, (emoji, label, color) in enumerate(self.MOODS):
            col = tk.Frame(mood_row, bg=bg_color)
            col.pack(side=tk.LEFT, padx=8)
            tk.Label(col, text=emoji, font=("Segoe UI Emoji", 26),
                     bg=bg_color).pack()
            tk.Radiobutton(col, text=label, variable=self.mood_var, value=i,
                           bg=bg_color,
                           activebackground=bg_color,
                           font=("Noto Sans JP", 9)).pack()

        tk.Label(today_frame, text="メモ（任意）:", bg=bg_color).pack(anchor="w", pady=(8, 2))
        self.memo_entry = ttk.Entry(today_frame, font=("Noto Sans JP", 11), width=40)
        self.memo_entry.pack(fill=tk.X)

        ttk.Button(main_frame, text="記録する", command=self.record).pack(pady=8)

        # 履歴
        hist_frame = ttk.LabelFrame(main_frame, text="記録履歴", padding=8)
        hist_frame.pack(fill=tk.BOTH, expand=True)

        self.hist_text = tk.Text(hist_frame, font=("Noto Sans JP", 10),
                                 bg="white", relief=tk.FLAT, state=tk.DISABLED, height=8)
        self.hist_text.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        sb = ttk.Scrollbar(hist_frame, command=self.hist_text.yview)
        self.hist_text.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)

    def record(self):
        mood_idx = self.mood_var.get()
        if mood_idx == -1:
            messagebox.showwarning("警告", "気分を選択してください")
            return
        emoji, label, _ = self.MOODS[mood_idx]
        memo = self.memo_entry.get().strip()
        rec = {"date": str(date.today()), "mood": label, "emoji": emoji, "memo": memo}
        self.records.append(rec)
        self._save()
        self.memo_entry.delete(0, tk.END)
        self.mood_var.set(-1)
        self._refresh_history()
        messagebox.showinfo("記録完了", f"今日の気分「{emoji} {label}」を記録しました")

    def _refresh_history(self):
        self.hist_text.config(state=tk.NORMAL)
        self.hist_text.delete("1.0", tk.END)
        for r in reversed(self.records[-30:]):
            line = f"{r['date']}  {r['emoji']} {r['mood']}"
            if r.get("memo"):
                line += f"  — {r['memo']}"
            self.hist_text.insert(tk.END, line + "\n")
        self.hist_text.config(state=tk.DISABLED)


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

5. コード解説

気分トラッカーのコードを、実際に書かれている実装に沿って解説します。

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

App34 クラスにアプリの全機能をまとめています（メソッド6個・全114行）。__init__ ではタイトル「気分トラッカー」とウィンドウサイズ 641x460 を設定します。そのあと _build_ui() → _refresh_history() の順に呼び出して初期状態を作ります。