中級者向け No.22

レシピ管理アプリ

レシピの登録・検索・カテゴリ管理・材料リスト作成ができるアプリ。画像添付機能付きの本格的なDBアプリです。

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

📋 目次

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

1. アプリ概要

レシピの登録・検索・カテゴリ管理・材料リスト作成ができるアプリ。画像添付機能付きの本格的なDBアプリです。

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

このアプリは「データベース連携」カテゴリです。データベース連携 GUI は永続化と画面更新を結びつける典型例で、トランザクション・スキーマ設計・UI 反映の三点を一度に学べます。tkinter（標準ライブラリ）・Pillow を活かして実装するこの構造は、他のアプリにも応用が効きます。

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

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

レシピ管理アプリ実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

ループで生成するボタン群（それぞれ _add_recipe()・_update_recipe()・_delete_recipe() を実行）
「🛒 材料リスト作成」ボタン（_shopping_list()）・「📷 画像選択」ボタン（_pick_image()）で操作
イベント <<ComboboxSelected>> から _load_recipes() を実行
イベント <<TreeviewSelect>> から _on_select() を実行
ttk.Treeview による表形式の一覧表示
sqlite3.connect() による SQLite データベース接続と SQL 実行
filedialog.askopenfilename() によるファイル選択ダイアログ
messagebox.askyesno()・messagebox.showinfo()・messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「レシピ管理アプリ」・サイズ 960x730 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

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

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

インストールが必要なライブラリ

pip install pillow

4. 完全なソースコード

💡

コードのコピー方法

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

📦 必要なライブラリをインストール（初回のみ）

pip install pillow

app22.py

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import sqlite3
import os
from datetime import datetime

try:
    from PIL import Image, ImageTk
    PIL_AVAILABLE = True
except ImportError:
    PIL_AVAILABLE = False


class App22:
    """レシピ管理アプリ"""

    DB_PATH = os.path.join(os.path.dirname(__file__), "recipes.db")
    CATEGORIES = ["和食", "洋食", "中華", "イタリアン", "デザート",
                  "サラダ", "スープ", "その他"]

    def __init__(self, root):
        self.root = root
        self.root.title("レシピ管理アプリ")
        self.root.geometry("960x730")
        self.root.minsize(960, 730)
        self.root.configure(bg="#fff8f0")
        self._init_db()
        self._build_ui()
        self._load_recipes()

    def _init_db(self):
        self.conn = sqlite3.connect(self.DB_PATH)
        self.conn.execute("""
            CREATE TABLE IF NOT EXISTS recipes (
                id INTEGER PRIMARY KEY AUTOINCREMENT,
                name TEXT NOT NULL,
                category TEXT,
                servings INTEGER DEFAULT 2,
                prep_time INTEGER,
                cook_time INTEGER,
                ingredients TEXT,
                steps TEXT,
                notes TEXT,
                image_path TEXT,
                created_at TEXT
            )
        """)
        self.conn.commit()
        if not self.conn.execute("SELECT 1 FROM recipes").fetchone():
            samples = [
                ("肉じゃが", "和食", 4, 10, 30,
                 "じゃがいも 4個\n玉ねぎ 1個\n牛肉 200g\nしょうゆ 大3\n砂糖 大2\nみりん 大2",
                 "1. じゃがいもを一口大に切る\n2. 玉ねぎを薄切りにする\n3. 油で肉を炒め野菜を加える\n4. 調味料と水を加えて20分煮る",
                 "じゃがいもが崩れる前に火を止める", ""),
                ("オムライス", "洋食", 2, 10, 15,
                 "卵 3個\nご飯 1膳\n鶏もも肉 100g\n玉ねぎ 1/4個\nケチャップ 大3\nバター 10g",
                 "1. 鶏肉と玉ねぎを炒める\n2. ご飯とケチャップを混ぜる\n3. 卵でご飯を包む",
                 "卵は半熟に仕上げる", ""),
            ]
            for s in samples:
                self.conn.execute(
                    "INSERT INTO recipes (name,category,servings,prep_time,"
                    "cook_time,ingredients,steps,notes,image_path,created_at) "
                    "VALUES (?,?,?,?,?,?,?,?,?,?)",
                    (*s, datetime.now().isoformat()))
            self.conn.commit()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#e65100", pady=10)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="🍳 レシピ管理アプリ",
                 font=("Noto Sans JP", 15, "bold"),
                 bg="#e65100", fg="white").pack(side=tk.LEFT, padx=12)

        # 検索バー
        search_f = tk.Frame(self.root, bg="#fff3e0", pady=6)
        search_f.pack(fill=tk.X)
        tk.Label(search_f, text="🔍", bg="#fff3e0").pack(side=tk.LEFT, padx=8)
        self.search_var = tk.StringVar()
        ttk.Entry(search_f, textvariable=self.search_var, width=22).pack(
            side=tk.LEFT, padx=4)
        self.search_var.trace_add("write", lambda *a: self._load_recipes())
        tk.Label(search_f, text="カテゴリ:", bg="#fff3e0").pack(side=tk.LEFT, padx=(12, 4))
        self.cat_var = tk.StringVar(value="すべて")
        cat_cb = ttk.Combobox(search_f, textvariable=self.cat_var,
                               values=["すべて"] + self.CATEGORIES,
                               state="readonly", width=12)
        cat_cb.pack(side=tk.LEFT)
        cat_cb.bind("<<ComboboxSelected>>", lambda e: self._load_recipes())
        ttk.Button(search_f, text="🛒 材料リスト作成",
                   command=self._shopping_list).pack(side=tk.RIGHT, padx=8)

        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)

        # 左: レシピ一覧
        left = tk.Frame(paned, bg="#fff8f0")
        cols = ("name", "category", "servings", "prep", "cook")
        self.tree = ttk.Treeview(left, columns=cols,
                                  show="headings", selectmode="browse")
        for c, h, w in [("name", "レシピ名", 160), ("category", "カテゴリ", 80),
                         ("servings", "人数", 50), ("prep", "下準備(分)", 70),
                         ("cook", "調理時間(分)", 80)]:
            self.tree.heading(c, text=h)
            self.tree.column(c, width=w, minwidth=40)
        sb = ttk.Scrollbar(left, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.bind("<<TreeviewSelect>>", self._on_select)
        paned.add(left, weight=1)

        # 右: 詳細タブ
        right = tk.Frame(paned, bg="#fff8f0")
        self.notebook = ttk.Notebook(right)
        self.notebook.pack(fill=tk.BOTH, expand=True)

        # レシピ詳細タブ
        detail_tab = tk.Frame(self.notebook, bg="#fff8f0")
        self.notebook.add(detail_tab, text="レシピ詳細")
        self._build_detail_tab(detail_tab)

        # 編集タブ
        edit_tab = tk.Frame(self.notebook, bg="#fff8f0")
        self.notebook.add(edit_tab, text="編集")
        self._build_edit_tab(edit_tab)
        paned.add(right, weight=2)

        self.status_var = tk.StringVar(value="")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#ffe0b2", font=("Arial", 9), anchor="w", padx=8
                 ).pack(fill=tk.X, side=tk.BOTTOM)
        self._selected_id = None

    def _build_detail_tab(self, parent):
        self.detail_name = tk.Label(parent, text="",
                                    font=("Noto Sans JP", 14, "bold"),
                                    bg="#fff8f0", fg="#e65100")
        self.detail_name.pack(anchor="w", padx=8, pady=4)
        info_f = tk.Frame(parent, bg="#fff8f0")
        info_f.pack(fill=tk.X, padx=8)
        self.detail_info = tk.Label(info_f, text="",
                                    bg="#fff8f0", fg="#555",
                                    font=("Arial", 10))
        self.detail_info.pack(side=tk.LEFT)

        # 画像
        self.img_label = tk.Label(parent, bg="#fff8f0", text="")
        self.img_label.pack(anchor="w", padx=8)

        inner = ttk.PanedWindow(parent, orient=tk.HORIZONTAL)
        inner.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        ing_f = ttk.LabelFrame(inner, text="材料", padding=6)
        self.ing_text = tk.Text(ing_f, width=20, font=("Noto Sans JP", 10),
                                bg="#fffde7", relief=tk.FLAT, state=tk.DISABLED)
        self.ing_text.pack(fill=tk.BOTH, expand=True)
        inner.add(ing_f, weight=1)

        step_f = ttk.LabelFrame(inner, text="手順", padding=6)
        self.step_text = tk.Text(step_f, width=32, font=("Noto Sans JP", 10),
                                  bg="#f1f8e9", relief=tk.FLAT, state=tk.DISABLED,
                                  wrap=tk.WORD)
        self.step_text.pack(fill=tk.BOTH, expand=True)
        inner.add(step_f, weight=2)

    def _build_edit_tab(self, parent):
        f = tk.Frame(parent, bg="#fff8f0")
        f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        for row, (lbl, attr) in enumerate([("レシピ名", "ename"),
                                            ("カテゴリ", None),
                                            ("人数", "eservings"),
                                            ("下準備(分)", "eprep"),
                                            ("調理時間(分)", "ecook"),
                                            ("画像パス", "eimg")]):
            tk.Label(f, text=f"{lbl}:", bg="#fff8f0").grid(
                row=row, column=0, sticky="w", pady=3)
            if lbl == "カテゴリ":
                self.ecat_var = tk.StringVar(value=self.CATEGORIES[0])
                ttk.Combobox(f, textvariable=self.ecat_var,
                             values=self.CATEGORIES, state="readonly",
                             width=14).grid(row=row, column=1, padx=4, sticky="w")
            else:
                var = tk.StringVar()
                ttk.Entry(f, textvariable=var, width=22).grid(
                    row=row, column=1, padx=4, sticky="w")
                setattr(self, f"{attr}_var", var)

        ttk.Button(f, text="📷 画像選択",
                   command=self._pick_image).grid(
            row=len([0]*6), column=2, padx=4)

        tk.Label(f, text="材料:", bg="#fff8f0").grid(
            row=7, column=0, sticky="nw", pady=3)
        self.eing_text = tk.Text(f, height=4, width=30, font=("Arial", 10))
        self.eing_text.grid(row=7, column=1, columnspan=2, padx=4, pady=2)

        tk.Label(f, text="手順:", bg="#fff8f0").grid(
            row=8, column=0, sticky="nw", pady=3)
        self.estep_text = tk.Text(f, height=5, width=30, font=("Arial", 10))
        self.estep_text.grid(row=8, column=1, columnspan=2, padx=4, pady=2)

        tk.Label(f, text="メモ:", bg="#fff8f0").grid(
            row=9, column=0, sticky="nw", pady=3)
        self.enotes_text = tk.Text(f, height=2, width=30, font=("Arial", 10))
        self.enotes_text.grid(row=9, column=1, columnspan=2, padx=4, pady=2)

        btn_f = tk.Frame(f, bg="#fff8f0")
        btn_f.grid(row=10, column=0, columnspan=3, pady=6)
        for text, cmd in [("➕ 追加", self._add_recipe),
                           ("✏️ 更新", self._update_recipe),
                           ("🗑️ 削除", self._delete_recipe)]:
            ttk.Button(btn_f, text=text, command=cmd).pack(side=tk.LEFT, padx=4)

    def _load_recipes(self):
        q = self.search_var.get().lower()
        cat = self.cat_var.get()
        sql = ("SELECT id,name,category,servings,prep_time,cook_time "
               "FROM recipes WHERE 1=1")
        params = []
        if q:
            sql += " AND LOWER(name) LIKE ?"
            params.append(f"%{q}%")
        if cat != "すべて":
            sql += " AND category=?"
            params.append(cat)
        sql += " ORDER BY name"
        rows = self.conn.execute(sql, params).fetchall()
        self.tree.delete(*self.tree.get_children())
        for row in rows:
            rid, name, category, srv, prep, cook = row
            self.tree.insert("", "end", iid=str(rid),
                             values=(name, category, srv, prep or "", cook or ""))
        self.status_var.set(f"{len(rows)} 件")

    def _on_select(self, event):
        sel = self.tree.selection()
        if not sel:
            return
        rid = int(sel[0])
        self._selected_id = rid
        row = self.conn.execute(
            "SELECT name,category,servings,prep_time,cook_time,"
            "ingredients,steps,notes,image_path FROM recipes WHERE id=?",
            (rid,)).fetchone()
        if not row:
            return
        (name, cat, srv, prep, cook, ing, steps, notes, img_path) = row
        # 詳細タブ更新
        self.detail_name.config(text=name)
        self.detail_info.config(
            text=f"📂 {cat}  👥 {srv}人前  ⏱ 下{prep or '-'}分 / 調{cook or '-'}分"
                 + (f"\n📝 {notes}" if notes else ""))
        for txt, content in [(self.ing_text, ing or ""),
                              (self.step_text, steps or "")]:
            txt.config(state=tk.NORMAL)
            txt.delete("1.0", tk.END)
            txt.insert("1.0", content)
            txt.config(state=tk.DISABLED)
        # 画像
        if PIL_AVAILABLE and img_path and os.path.exists(img_path):
            try:
                img = Image.open(img_path).resize((200, 150), Image.LANCZOS)
                self._photo = ImageTk.PhotoImage(img)
                self.img_label.config(image=self._photo)
            except Exception:
                self.img_label.config(image="")
        else:
            self.img_label.config(image="")
        # 編集タブ更新
        self.ename_var.set(name)
        self.ecat_var.set(cat or self.CATEGORIES[0])
        self.eservings_var.set(str(srv))
        self.eprep_var.set(str(prep or ""))
        self.ecook_var.set(str(cook or ""))
        self.eimg_var.set(img_path or "")
        self.eing_text.delete("1.0", tk.END)
        self.eing_text.insert("1.0", ing or "")
        self.estep_text.delete("1.0", tk.END)
        self.estep_text.insert("1.0", steps or "")
        self.enotes_text.delete("1.0", tk.END)
        self.enotes_text.insert("1.0", notes or "")

    def _add_recipe(self):
        name = self.ename_var.get().strip()
        if not name:
            messagebox.showwarning("警告", "レシピ名を入力してください")
            return
        self.conn.execute(
            "INSERT INTO recipes (name,category,servings,prep_time,cook_time,"
            "ingredients,steps,notes,image_path,created_at) VALUES "
            "(?,?,?,?,?,?,?,?,?,?)",
            (name, self.ecat_var.get(),
             int(self.eservings_var.get() or 2),
             int(self.eprep_var.get() or 0),
             int(self.ecook_var.get() or 0),
             self.eing_text.get("1.0", tk.END).strip(),
             self.estep_text.get("1.0", tk.END).strip(),
             self.enotes_text.get("1.0", tk.END).strip(),
             self.eimg_var.get(),
             datetime.now().isoformat()))
        self.conn.commit()
        self._load_recipes()

    def _update_recipe(self):
        if not self._selected_id:
            return
        name = self.ename_var.get().strip()
        if not name:
            return
        self.conn.execute(
            "UPDATE recipes SET name=?,category=?,servings=?,prep_time=?,"
            "cook_time=?,ingredients=?,steps=?,notes=?,image_path=? WHERE id=?",
            (name, self.ecat_var.get(),
             int(self.eservings_var.get() or 2),
             int(self.eprep_var.get() or 0),
             int(self.ecook_var.get() or 0),
             self.eing_text.get("1.0", tk.END).strip(),
             self.estep_text.get("1.0", tk.END).strip(),
             self.enotes_text.get("1.0", tk.END).strip(),
             self.eimg_var.get(), self._selected_id))
        self.conn.commit()
        self._load_recipes()

    def _delete_recipe(self):
        if not self._selected_id:
            return
        if messagebox.askyesno("確認", "このレシピを削除しますか?"):
            self.conn.execute("DELETE FROM recipes WHERE id=?",
                              (self._selected_id,))
            self.conn.commit()
            self._selected_id = None
            self._load_recipes()

    def _pick_image(self):
        path = filedialog.askopenfilename(
            filetypes=[("画像", "*.jpg *.jpeg *.png *.bmp"),
                       ("すべて", "*.*")])
        if path:
            self.eimg_var.set(path)

    def _shopping_list(self):
        """選択中のレシピの材料リストを表示"""
        if not self._selected_id:
            messagebox.showinfo("情報", "レシピを選択してください")
            return
        ing = self.conn.execute(
            "SELECT ingredients FROM recipes WHERE id=?",
            (self._selected_id,)).fetchone()
        if not ing or not ing[0]:
            return
        win = tk.Toplevel(self.root)
        win.title("🛒 材料リスト")
        win.geometry("300x300")
        txt = tk.Text(win, font=("Noto Sans JP", 11), wrap=tk.WORD)
        txt.pack(fill=tk.BOTH, expand=True, padx=8, pady=8)
        txt.insert("1.0", "【材料リスト】\n\n" + ing[0])
        txt.config(state=tk.DISABLED)


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

5. コード解説

レシピ管理アプリのコードを、実際に書かれている実装に沿って解説します。

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

App22 クラスにアプリの全機能をまとめています（メソッド12個・全365行）。__init__ ではタイトル「レシピ管理アプリ」とウィンドウサイズ 960x730 を設定します。そのあと _init_db() → _build_ui() → _load_recipes() の順に呼び出して初期状態を作ります。