単語帳フラッシュカード

1. アプリ概要

英単語と日本語訳を表示するフラッシュカードアプリ。CSVから問題を読み込み正誤記録で苦手単語を集中学習。

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

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

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

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

2. 機能一覧

• 「めくる」ボタン（flip()）・「◯ 正解」ボタン（answer()）・「✕ 不正解」ボタン（answer()）・「次へ」ボタン（next_card()）・「CSV読込」ボタン（load_csv()）で操作
• マウス操作 <Button-1> から flip() を実行
• filedialog.askopenfilename() によるファイル選択ダイアログ
• messagebox.showerror()・messagebox.showinfo()・messagebox.showwarning() によるダイアログ通知
• ウィンドウはタイトル「単語帳フラッシュカード」・サイズ 650x500 で起動

3. 事前準備・環境

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

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

4. 完全なソースコード

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import csv
import random


class App068:
    """単語帳フラッシュカード: CSV から英単語と訳を読み込み、正誤記録で苦手単語を集中学習"""

    DEFAULT_DECK = [
        ("apple", "りんご"),
        ("book", "本"),
        ("cat", "猫"),
        ("dog", "犬"),
        ("elephant", "象"),
        ("forest", "森"),
        ("guitar", "ギター"),
        ("happy", "幸せな"),
    ]

    def __init__(self, root):
        self.root = root
        self.root.title("単語帳フラッシュカード")
        self.root.geometry("650x500")
        self.root.minsize(650, 500)
        self.root.configure(bg="#f8f9fc")
        # cards: [{"q":英単語,"a":日本語訳,"wrong":誤答数}, ...]
        self.cards = [{"q": q, "a": a, "wrong": 0} for q, a in self.DEFAULT_DECK]
        self.current = None
        self.show_back = False
        self.weak_mode = False
        self._build_ui()
        self.next_card()

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

        # ステータス
        self.status_var = tk.StringVar()
        tk.Label(main, textvariable=self.status_var, bg="#f8f9fc",
                 font=("Noto Sans JP", 11)).pack(anchor="w")

        # カード表示
        card_frame = tk.Frame(main, bg="white", bd=2, relief=tk.RIDGE, height=180)
        card_frame.pack(fill=tk.X, pady=15)
        card_frame.pack_propagate(False)
        self.card_var = tk.StringVar(value="-")
        tk.Label(card_frame, textvariable=self.card_var, bg="white",
                 font=("Noto Sans JP", 28, "bold"), fg="#3776ab").pack(expand=True)

        # クリックでひっくり返し
        for w in (card_frame,):
            w.bind("<Button-1>", lambda e: self.flip())

        # 操作ボタン
        btn = tk.Frame(main, bg="#f8f9fc")
        btn.pack(pady=4)
        ttk.Button(btn, text="めくる", command=self.flip).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="◯ 正解", command=lambda: self.answer(True)).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="✕ 不正解", command=lambda: self.answer(False)).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="次へ", command=self.next_card).pack(side=tk.LEFT, padx=4)

        # オプション
        opt = tk.Frame(main, bg="#f8f9fc")
        opt.pack(pady=8)
        ttk.Button(opt, text="CSV読込", command=self.load_csv).pack(side=tk.LEFT, padx=4)
        self.weak_var = tk.BooleanVar(value=False)
        ttk.Checkbutton(opt, text="苦手単語のみ", variable=self.weak_var,
                        command=lambda: setattr(self, "weak_mode", self.weak_var.get())
                        ).pack(side=tk.LEFT, padx=8)

        # 統計
        stat_frame = ttk.LabelFrame(main, text="不正解履歴", padding=6)
        stat_frame.pack(fill=tk.BOTH, expand=True, pady=4)
        self.stat_text = tk.Text(stat_frame, height=6, font=("Noto Sans JP", 10), bg="white", state=tk.DISABLED)
        self.stat_text.pack(fill=tk.BOTH, expand=True)

    def next_card(self):
        """次のカードを表示する (苦手モードなら誤答数の多い順)"""
        pool = self.cards
        if self.weak_var.get() if hasattr(self, "weak_var") else False:
            weak = [c for c in self.cards if c["wrong"] > 0]
            if weak:
                pool = weak
        if not pool:
            self.card_var.set("カードがありません")
            return
        # 誤答が多いカードを優先したいので重み付けランダム
        weights = [1 + c["wrong"] * 2 for c in pool]
        self.current = random.choices(pool, weights=weights, k=1)[0]
        self.show_back = False
        self.card_var.set(self.current["q"])
        self._update_status()

    def flip(self):
        """カードを裏表ひっくり返す"""
        if not self.current:
            return
        self.show_back = not self.show_back
        self.card_var.set(self.current["a"] if self.show_back else self.current["q"])

    def answer(self, correct):
        """正誤を記録して次のカードへ"""
        if not self.current:
            return
        if not correct:
            self.current["wrong"] += 1
        self._update_status()
        self.next_card()

    def _update_status(self):
        """ステータス表示と統計表示を更新する"""
        total = len(self.cards)
        wrong_total = sum(c["wrong"] for c in self.cards)
        self.status_var.set(f"カード総数: {total} 件 / 累計不正解: {wrong_total} 回")
        self.stat_text.config(state=tk.NORMAL)
        self.stat_text.delete("1.0", tk.END)
        ranked = sorted(self.cards, key=lambda c: -c["wrong"])
        for c in ranked[:10]:
            if c["wrong"] > 0:
                self.stat_text.insert(tk.END, f"  {c['q']:>20}  ({c['a']})  ✗{c['wrong']}\n")
        self.stat_text.config(state=tk.DISABLED)

    def load_csv(self):
        """CSV から単語を読み込む (1行目: 英単語, 2行目: 訳)"""
        path = filedialog.askopenfilename(filetypes=[("CSVファイル", "*.csv")])
        if not path:
            return
        try:
            with open(path, "r", encoding="utf-8-sig", newline="") as f:
                reader = csv.reader(f)
                rows = [r for r in reader if len(r) >= 2]
            if not rows:
                messagebox.showwarning("警告", "有効な行がありません")
                return
            # ヘッダー行をスキップ判定 (第1列が "word"/"english" など)
            head = rows[0][0].strip().lower()
            if head in ("word", "english", "英単語", "q", "question"):
                rows = rows[1:]
            self.cards = [{"q": r[0].strip(), "a": r[1].strip(), "wrong": 0} for r in rows if r[0].strip()]
            messagebox.showinfo("読込完了", f"{len(self.cards)} 件読み込みました")
            self.next_card()
        except Exception as e:
            messagebox.showerror("エラー", f"読み込み失敗: {e}")


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

5. コード解説

単語帳フラッシュカード: CSV から英単語と訳を読み込み、正誤記録で苦手単語を集中学習のコードを、実際に書かれている実装に沿って解説します。

6. ステップバイステップガイド

このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。

1. 1
   ファイルを作成する

   新しいファイルを作成して app068.py と保存します。使うのは csv・random・tkinter だけなので、追加インストールは不要です。

2. 2
   クラスの骨格を作る

   App068 クラスを定義し、__init__ と、末尾の root = tk.Tk() ～ mainloop() の最小構成を書いて、まず空のウィンドウが出ることを確認します。

3. 3
   ウィンドウを設定する

   title("単語帳フラッシュカード")・geometry("650x500")・configure(bg="#f8f9fc")・minsize(650, 500) をコンストラクタで設定します。

4. 4
   画面部品を並べる

   _build_ui() の中で、tk.Frame×5・tk.Label×3・ttk.Button×5・ttk.Checkbutton・ttk.LabelFrame・tk.Text を作って配置します（掲載コードと同じ並び順で書くとレイアウトが一致します）。まず表示だけ確認しましょう。

5. 5
   イベントを接続する

   「2. 機能一覧」で挙げた各ボタンを command= で対応するメソッド（flip()・answer()・answer()・next_card()・load_csv()）につなぎます。bind("<Button-1>", ...) の登録も忘れずに。

6. 6
   中心になるメソッドを実装する

   アプリの本体である load_csv()（21行）・next_card()（16行）・answer()（8行）・flip()（6行） を実装します。

7. 7
   動作確認する

   python app068.py で起動し、各ボタンが反応すること・マウス操作（クリック・ホイールなど）が効くことを確認します。

7. カスタマイズアイデア

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。

8. よくある問題と解決法

9. 練習問題

アプリの理解を深めるための練習問題です。気になるものから挑戦してみてください（課題3は全アプリ共通の定型課題です）。

1. 課題1：正解した回数と正答率も表示する

   いまのステータス行はカード総数と累計不正解しか出していません。正解した回数を数え、正答率も一緒に表示します。

   期待結果：起動直後は「カード総数: 8 件 / 累計不正解: 0 回 / 正解: 0 回 / 正答率: -」と出る。「◯ 正解」を3回・「✕ 不正解」を1回押すと「累計不正解: 1 回 / 正解: 3 回 / 正答率: 75.0%」になる。

   合格条件

   • 「CSV読込」で別のCSVを読み込んだあとも、正解数と正答率がエラーなく出る
   • 1回も答えていない状態で 0 除算のエラーが出ない
   • 「✕ 不正解」を押した回数は今までどおり「累計不正解」に反映される

   ヒント①（どこを触るか）: "wrong" を持つカードの辞書を作っているのは __init__() と load_csv() の2か所です。加算は answer()、表示は _update_status() の self.status_var.set(...) で、合計4か所を触ります。
   ヒント②（使うもの）: 正解数のキー（例 "right"）をカードの辞書に足します。合計は sum(c["right"] for c in self.cards) で出せて、正答率は 正解 ÷（正解＋不正解）× 100 です。
   つまずきやすい点: load_csv() は読み込んだ行からカードの辞書を作り直します。ここに新しいキーを足し忘れると、CSV 読込のあとに KeyError で止まります。

2. 課題2：裏を見るまで正解・不正解を押せないようにする

   いまは英単語（表）を見たまま「◯ 正解」を押せてしまいます。訳を確認してから採点するように、めくるまでこの2つのボタンを押せない状態にします。

   期待結果：起動直後は「◯ 正解」と「✕ 不正解」が灰色で押せない。「めくる」を押して訳が出ると押せるようになり、「次へ」で次の単語に進むとまた押せなくなる。

   合格条件

   • カードの枠をクリックしてめくった場合も押せるようになる
   • 「めくる」をもう一度押して英単語に戻しても、押せる状態のまま
   • 「CSV読込」で読み込み直した直後は、また押せない状態から始まる

   ヒント①（どこを触るか）: ボタンを作っているのは _build_ui() の text="◯ 正解" と text="✕ 不正解" の2行です。状態を切り替えるのは next_card()（押せなくする）と flip()（押せるようにする）の2か所になります。
   ヒント②（使うもの）: 切り替えは config(state="disabled") と config(state="normal") です。カードの枠のクリックも flip() を呼ぶので、flip() 側に書けば両方に効きます。
   つまずきやすい点: いまのコードは ttk.Button(...).pack(...) と1行で書いているため、この式の値は None です。ボタンを覚えておくには、生成と pack() を2行に分けてください。

3. 課題3：保存機能の追加

   処理結果をファイルに保存する機能を追加しましょう。