初心者向け No.051

名言ランダム表示アプリ

名言集からランダムに格言を表示するモチベーションアプリ。リスト操作とrandomモジュールの基本を学ぶ。お気に入り保存機能付き。

🎯 難易度: ★☆☆ 易しい 📦 ライブラリ: tkinter, random, json ⏱️ 制作時間: 30〜90分

📋 目次

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

1. アプリ概要

名言集からランダムに格言を表示するモチベーションアプリ。リスト操作とrandomモジュールの基本を学ぶ。お気に入り保存機能付き。

このアプリはtoolsカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter・random・json、難易度は ★☆☆ 易しい です。

このアプリは「ツール」カテゴリです。日々の作業を自動化する実用ツールは Python が最も得意とする領域です。短いコードで実用性のある成果物が作れる点が魅力です。tkinter・random・json を活かして実装するこの構造は、他のアプリにも応用が効きます。

コピー＆実行で動作確認 → コード解説で構造理解 → カスタマイズで応用、の 3 ステップで進めると、短時間で本質を押さえられます。

アプリを完成させた後は、自分の使い方に合わせて改造するのが学びを定着させる近道です。カスタマイズ章のアイデアを足がかりに、独自機能を一つ追加してみてください。

2. 機能一覧

名言ランダム表示アプリのメイン機能
直感的なGUIインターフェース
入力値のバリデーション
エラーハンドリング
結果の見やすい表示
クリア機能付き

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows・Mac・Linux すべて対応

以下の環境で動作確認しています。

Python 3.10 以上
OS: Windows 10/11・macOS 12+・Ubuntu 20.04+

4. 完全なソースコード

💡

コードのコピー方法

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

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

app051.py

import tkinter as tk
from tkinter import ttk, messagebox
import random
import json
import os


class App051:
    """名言ランダム表示アプリ"""

    QUOTES = [
        ("継続は力なり", "格言"),
        ("天才とは1%のひらめきと99%の努力である", "エジソン"),
        ("人生は近くで見ると悲劇だが、遠くから見ると喜劇である", "チャップリン"),
        ("為せば成る、為さねば成らぬ何事も", "上杉鷹山"),
        ("失敗は成功のもと", "格言"),
        ("時は金なり", "ベンジャミン・フランクリン"),
        ("我思う、故に我あり", "デカルト"),
        ("今日できることを明日に延ばすな", "フランクリン"),
        ("夢なき者に成功なし", "吉田松陰"),
        ("逆境こそが人を作る", "セネカ"),
        ("行動なくして成功なし", "格言"),
        ("最も強い者が生き残るのではなく、変化に対応できる者が生き残る", "ダーウィン"),
    ]

    FAV_FILE = "quotes_favorites.json"

    def __init__(self, root):
        self.root = root
        self.root.title("名言ランダム表示")
        self.root.geometry("620x420")
        self.root.configure(bg="#f8f9fc")
        self.favorites = []  # [(text, author)]
        self.current = None
        self._build_ui()
        self._load_favorites()
        self.next_quote()

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

        quote_frame = tk.Frame(main_frame, bg="white", relief=tk.GROOVE, bd=1, padx=20, pady=20)
        quote_frame.pack(fill=tk.BOTH, expand=True, pady=(0, 10))
        self.quote_label = tk.Label(
            quote_frame, text="", font=("Noto Sans JP", 14),
            bg="white", wraplength=520, justify="center"
        )
        self.quote_label.pack(expand=True)
        self.author_label = tk.Label(
            quote_frame, text="", font=("Noto Sans JP", 11, "italic"),
            bg="white", fg="#666"
        )
        self.author_label.pack(pady=(8, 0))

        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(pady=4)
        ttk.Button(btn_frame, text="次の名言", command=self.next_quote).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn_frame, text="お気に入り追加", command=self.add_favorite).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn_frame, text="お気に入り表示", command=self.show_favorites).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn_frame, text="コピー", command=self.copy_to_clipboard).pack(side=tk.LEFT, padx=4)

    def next_quote(self):
        """ランダムに名言を選んで表示"""
        self.current = random.choice(self.QUOTES)
        self.quote_label.config(text=f"「{self.current[0]}」")
        self.author_label.config(text=f"― {self.current[1]}")

    def add_favorite(self):
        """現在の名言をお気に入りに追加"""
        if not self.current:
            return
        if self.current in self.favorites:
            messagebox.showinfo("情報", "既にお気に入りに登録されています")
            return
        self.favorites.append(self.current)
        self._save_favorites()
        messagebox.showinfo("完了", "お気に入りに追加しました")

    def show_favorites(self):
        """お気に入り一覧をサブウィンドウで表示"""
        win = tk.Toplevel(self.root)
        win.title("お気に入り一覧")
        win.geometry("500x360")
        listbox = tk.Listbox(win, font=("Noto Sans JP", 11))
        listbox.pack(fill=tk.BOTH, expand=True, padx=10, pady=10)
        for q, a in self.favorites:
            listbox.insert(tk.END, f"「{q}」 ― {a}")

        def remove_selected():
            """選択行を削除する"""
            sel = listbox.curselection()
            if not sel:
                return
            idx = sel[0]
            del self.favorites[idx]
            listbox.delete(idx)
            self._save_favorites()

        ttk.Button(win, text="選択を削除", command=remove_selected).pack(pady=(0, 10))

    def copy_to_clipboard(self):
        """現在の名言をクリップボードにコピー"""
        if not self.current:
            return
        text = f"「{self.current[0]}」 ― {self.current[1]}"
        self.root.clipboard_clear()
        self.root.clipboard_append(text)
        messagebox.showinfo("完了", "クリップボードにコピーしました")

    def _load_favorites(self):
        """お気に入りファイルを読み込む"""
        if os.path.exists(self.FAV_FILE):
            try:
                with open(self.FAV_FILE, "r", encoding="utf-8") as f:
                    self.favorites = [tuple(x) for x in json.load(f)]
            except Exception:
                self.favorites = []

    def _save_favorites(self):
        """お気に入りを保存"""
        try:
            with open(self.FAV_FILE, "w", encoding="utf-8") as f:
                json.dump(self.favorites, f, ensure_ascii=False, indent=2)
        except Exception as e:
            messagebox.showerror("エラー", f"保存失敗: {e}")


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

5. コード解説

名言ランダム表示アプリのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

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

App051クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。