初心者向け No.44

ランダム名言ジェネレーター

ボタンを押すたびにランダムな名言を表示するアプリ。リストからの無作為選択と表示更新を学びます。

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

📋 目次

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

1. アプリ概要

ボタンを押すたびにランダムな名言を表示するアプリ。リストからの無作為選択と表示更新を学びます。

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

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

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

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

ランダム名言ジェネレーター実行画面（Windows） — 実行画面（Windows）

ランダム名言ジェネレーター実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「🔀 次の名言」ボタン（show_quote()）・「⭐ お気に入り」ボタン（add_favorite()）・「📋 コピー」ボタン（copy_quote()）で操作
tk.Listbox による一覧表示
JSON ファイルの保存・読み込み（起動時に自動実行）
messagebox.showerror()・messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「ランダム名言ジェネレーター」・サイズ 520x416 で起動
お気に入りは favorites.json に保存され、次に起動したときに自動で読み込まれる（保存先は app44.py と同じフォルダ）

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

💡

コードのコピー方法

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

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

app44.py

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

# お気に入りの保存先。このスクリプトと同じフォルダに favorites.json が作られる
FAV_FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "favorites.json")


class App44:
    """ランダム名言ジェネレーター"""

    QUOTES = [
        ("シンプルさは究極の洗練である。", "レオナルド・ダ・ヴィンチ"),
        ("プログラミングはアートであり、科学であり、工学でもある。", "ドナルド・クヌース"),
        ("コードの読みやすさは、書きやすさと同じくらい重要だ。", "グイド・ヴァンロッサム"),
        ("最初に動くものを作れ。それから美しくせよ。", "ケント・ベック"),
        ("バグを見つけるよりも、バグを作らないことの方が難しい。", "エドガー・ダイクストラ"),
        ("学ぶことをやめたら、教えることもやめなければならない。", "アルベルト・アインシュタイン"),
        ("失敗は成功のもと。大切なのは諦めないこと。", "トーマス・エジソン"),
        ("千里の道も一歩から。", "老子"),
        ("コードは書く回数より読む回数の方がはるかに多い。", "不明"),
        ("動くコードは最良のドキュメントだ。", "不明"),
        ("シンプルにすることは複雑にするよりも難しい。", "スティーブ・ジョブズ"),
        ("最良のエラーメッセージとは、エラーが起きないことだ。", "不明"),
        ("まず動かせ。正しくせよ。速くせよ。", "肯特・ベック"),
        ("コードを書く前に考え、考える前に仕様を理解せよ。", "不明"),
        ("チームワークは夢を現実にする。", "不明"),
    ]

    def __init__(self, root):
        self.root = root
        self.root.title("ランダム名言ジェネレーター")
        self.root.geometry("520x416")
        self.root.minsize(520, 416)
        self.root.configure(bg="#f8f9fc")
        self.favorites = []
        self._build_ui()
        self._load_favorites()
        self.show_quote()

    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=24, pady=16)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 名言カード
        card = tk.Frame(main_frame, bg="white", relief=tk.RAISED, bd=1)
        card.pack(fill=tk.X, pady=(0, 14), ipady=16)

        tk.Label(card, text="❝", font=("Noto Sans JP", 24), bg="white",
                 fg="#3776ab").pack(anchor="w", padx=16, pady=(8, 0))

        self.quote_label = tk.Label(card, text="", bg="white",
                                    font=("Noto Sans JP", 13),
                                    wraplength=440, justify="center",
                                    fg="#222")
        self.quote_label.pack(padx=16, pady=(0, 8))

        self.author_label = tk.Label(card, text="", bg="white",
                                     font=("Noto Sans JP", 11, "italic"),
                                     fg="#888")
        self.author_label.pack(anchor="e", padx=16, pady=(0, 8))

        # ボタン
        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack()
        tk.Button(btn_frame, text="🔀 次の名言",
                  font=("Noto Sans JP", 13, "bold"),
                  bg="#3776ab", fg="white", activebackground="#2a5a8a",
                  relief=tk.FLAT, padx=16, pady=8,
                  command=self.show_quote).pack(side=tk.LEFT, padx=6)
        ttk.Button(btn_frame, text="⭐ お気に入り", command=self.add_favorite).pack(side=tk.LEFT, padx=6)
        ttk.Button(btn_frame, text="📋 コピー", command=self.copy_quote).pack(side=tk.LEFT, padx=6)

        # お気に入り
        fav_frame = ttk.LabelFrame(main_frame, text="お気に入り", padding=6)
        fav_frame.pack(fill=tk.BOTH, expand=True, pady=(14, 0))
        self.fav_listbox = tk.Listbox(fav_frame, font=("Noto Sans JP", 9),
                                      bg="white", relief=tk.FLAT, height=4)
        self.fav_listbox.pack(fill=tk.BOTH, expand=True)

        self.current_quote = None

    def show_quote(self):
        quote, author = random.choice(self.QUOTES)
        self.current_quote = (quote, author)
        self.quote_label.config(text=quote)
        self.author_label.config(text=f"— {author}")

    def add_favorite(self):
        if self.current_quote:
            q, a = self.current_quote
            entry = f"{q}（{a}）"
            if entry not in self.favorites:
                self.favorites.append(entry)
                self.fav_listbox.insert(tk.END, entry)
                self._save_favorites()

    def copy_quote(self):
        if self.current_quote:
            q, a = self.current_quote
            self.root.clipboard_clear()
            self.root.clipboard_append(f"「{q}」— {a}")

    def _load_favorites(self):
        """保存済みのお気に入りを読み込む（無い・壊れている場合は空のまま続行）"""
        try:
            with open(FAV_FILE, "r", encoding="utf-8") as f:
                saved = json.load(f)
        except FileNotFoundError:
            return
        except (OSError, json.JSONDecodeError):
            messagebox.showwarning(
                "お気に入り",
                f"{FAV_FILE} を読み込めませんでした。お気に入りは空の状態で始めます。")
            return
        if not isinstance(saved, list):
            return
        for entry in saved:
            if isinstance(entry, str) and entry not in self.favorites:
                self.favorites.append(entry)
                self.fav_listbox.insert(tk.END, entry)

    def _save_favorites(self):
        """お気に入りを JSON ファイルへ保存する"""
        try:
            with open(FAV_FILE, "w", encoding="utf-8") as f:
                json.dump(self.favorites, f, ensure_ascii=False, indent=2)
        except OSError as e:
            messagebox.showerror("保存エラー", f"お気に入りを保存できませんでした: {e}")


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

5. コード解説

ランダム名言ジェネレーターのコードを、実際に書かれている実装に沿って解説します。

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

App44 クラスにアプリの全機能をまとめています（メソッド7個・全143行）。__init__ ではタイトル「ランダム名言ジェネレーター」とウィンドウサイズ 520x416 を設定します。そのあと _build_ui() → _load_favorites() → show_quote() の順に呼び出して初期状態を作ります。