ランダム献立提案
朝・昼・夜の献立をランダムに提案するアプリ。メニューリストをJSONで管理しカスタマイズ可能。
1. アプリ概要
朝・昼・夜の献立をランダムに提案するアプリ。メニューリストをJSONで管理しカスタマイズ可能。
このアプリはtoolsカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter(標準ライブラリ)、難易度は ★☆☆ です。
このアプリは「ツール」カテゴリです。日々の作業を自動化する実用ツールは Python が最も得意とする領域です。短いコードで実用性のある成果物が作れる点が魅力です。tkinter(標準ライブラリ) を活かして実装するこの構造は、他のアプリにも応用が効きます。
動かしながら読むことが理解の最短経路です。まずはコードをコピーして実行し、想定どおりに動くことを確認したうえで解説と照らし合わせてください。
カスタマイズでは「機能追加」「UI 改善」「エラー耐性」の三方向で考えると視野が広がります。練習問題にもそれぞれの方向の具体例を用意しています。
2. 機能一覧
- ランダム献立提案のメイン機能
- 直感的なGUIインターフェース
- 入力値のバリデーション
- エラーハンドリング
- 結果の見やすい表示
- クリア機能付き
3. 事前準備・環境
Python 3.10 以上 / Windows・Mac・Linux すべて対応
以下の環境で動作確認しています。
- Python 3.10 以上
- OS: Windows 10/11・macOS 12+・Ubuntu 20.04+
4. 完全なソースコード
右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。
import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import random
import json
import os
class App072:
"""ランダム献立提案アプリ"""
DEFAULT_MENUS = {
"朝": ["トースト&コーヒー", "ご飯と味噌汁", "オムレツとサラダ", "シリアル", "おにぎり", "卵かけご飯", "サンドイッチ", "フルーツヨーグルト"],
"昼": ["ラーメン", "カレーライス", "パスタ", "うどん", "ハンバーガー", "牛丼", "親子丼", "サラダボウル", "お弁当", "焼きそば"],
"夜": ["焼き魚定食", "唐揚げ", "ステーキ", "鍋", "餃子と炒飯", "天ぷら", "ハンバーグ", "豚の生姜焼き", "刺身定食", "シチュー"],
}
SAVE_FILE = "meal_menus.json"
def __init__(self, root):
self.root = root
self.root.title("ランダム献立提案")
self.root.geometry("620x520")
self.root.configure(bg="#f8f9fc")
self.menus = {k: list(v) for k, v in self.DEFAULT_MENUS.items()}
self._load()
self._build_ui()
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)
# 提案表示
prop_frame = ttk.LabelFrame(main_frame, text="今日の献立", padding=14)
prop_frame.pack(fill=tk.X, pady=(0, 10))
self.labels = {}
for i, meal in enumerate(("朝", "昼", "夜")):
tk.Label(prop_frame, text=f"{meal}食:", font=("Noto Sans JP", 12, "bold"), bg="#f8f9fc").grid(row=i, column=0, sticky="w", pady=4)
lab = tk.Label(prop_frame, text="-", font=("Noto Sans JP", 12), bg="#f8f9fc", anchor="w")
lab.grid(row=i, column=1, sticky="w", padx=10)
self.labels[meal] = lab
btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
btn_frame.pack(pady=4)
ttk.Button(btn_frame, text="提案する", command=self.suggest).pack(side=tk.LEFT, padx=4)
ttk.Button(btn_frame, text="メニュー編集", command=self.edit_menus).pack(side=tk.LEFT, padx=4)
ttk.Button(btn_frame, text="保存", command=self._save).pack(side=tk.LEFT, padx=4)
ttk.Button(btn_frame, text="読込", command=self.import_json).pack(side=tk.LEFT, padx=4)
# 一覧表示
list_frame = ttk.LabelFrame(main_frame, text="現在のメニュー一覧", padding=8)
list_frame.pack(fill=tk.BOTH, expand=True)
self.list_text = tk.Text(list_frame, font=("Noto Sans JP", 11), bg="white", state=tk.DISABLED)
self.list_text.pack(fill=tk.BOTH, expand=True)
self._refresh_list()
def suggest(self):
"""各食事をランダム提案"""
for meal, lab in self.labels.items():
choices = self.menus.get(meal) or ["(未登録)"]
lab.config(text=random.choice(choices))
def edit_menus(self):
"""編集ダイアログを開く"""
win = tk.Toplevel(self.root)
win.title("メニュー編集")
win.geometry("500x400")
nb = ttk.Notebook(win)
nb.pack(fill=tk.BOTH, expand=True)
listboxes = {}
for meal in ("朝", "昼", "夜"):
frame = tk.Frame(nb)
nb.add(frame, text=f"{meal}食")
lb = tk.Listbox(frame, font=("Noto Sans JP", 11))
lb.pack(fill=tk.BOTH, expand=True, padx=8, pady=8)
for m in self.menus[meal]:
lb.insert(tk.END, m)
entry = ttk.Entry(frame)
entry.pack(fill=tk.X, padx=8)
ctrl = tk.Frame(frame)
ctrl.pack(pady=6)
def make_add(meal_=meal, lb_=lb, entry_=entry):
def _add():
"""項目を追加"""
v = entry_.get().strip()
if not v:
return
self.menus[meal_].append(v)
lb_.insert(tk.END, v)
entry_.delete(0, tk.END)
return _add
def make_del(meal_=meal, lb_=lb):
def _del():
"""選択項目を削除"""
sel = lb_.curselection()
if not sel:
return
idx = sel[0]
del self.menus[meal_][idx]
lb_.delete(idx)
return _del
ttk.Button(ctrl, text="追加", command=make_add()).pack(side=tk.LEFT, padx=4)
ttk.Button(ctrl, text="削除", command=make_del()).pack(side=tk.LEFT, padx=4)
listboxes[meal] = lb
def on_close():
"""閉じるときに保存と再描画"""
self._save()
self._refresh_list()
win.destroy()
ttk.Button(win, text="閉じる", command=on_close).pack(pady=4)
win.protocol("WM_DELETE_WINDOW", on_close)
def _refresh_list(self):
"""一覧テキストを更新"""
self.list_text.config(state=tk.NORMAL)
self.list_text.delete("1.0", tk.END)
for meal, items in self.menus.items():
self.list_text.insert(tk.END, f"【{meal}食】 {', '.join(items)}\n")
self.list_text.config(state=tk.DISABLED)
def _load(self):
"""JSONメニュー読み込み"""
if os.path.exists(self.SAVE_FILE):
try:
with open(self.SAVE_FILE, "r", encoding="utf-8") as f:
data = json.load(f)
if isinstance(data, dict):
for k in ("朝", "昼", "夜"):
if k in data and isinstance(data[k], list):
self.menus[k] = data[k]
except Exception:
pass
def _save(self):
"""JSONメニュー書き出し"""
try:
with open(self.SAVE_FILE, "w", encoding="utf-8") as f:
json.dump(self.menus, f, ensure_ascii=False, indent=2)
except Exception as e:
messagebox.showerror("エラー", f"保存失敗: {e}")
def import_json(self):
"""ファイルからJSONを読み込む"""
path = filedialog.askopenfilename(filetypes=[("JSON", "*.json")])
if not path:
return
try:
with open(path, "r", encoding="utf-8") as f:
data = json.load(f)
for k in ("朝", "昼", "夜"):
if k in data:
self.menus[k] = data[k]
self._refresh_list()
messagebox.showinfo("完了", "メニューを読み込みました")
except Exception as e:
messagebox.showerror("エラー", f"読み込み失敗: {e}")
if __name__ == "__main__":
root = tk.Tk()
app = App072(root)
root.mainloop()
5. コード解説
ランダム献立提案のコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。
クラス設計とコンストラクタ
App072クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。
UIレイアウトの構築
LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。
イベント処理
ボタンのcommand引数でクリックイベントを、bind('
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。
Textウィジェットでの結果表示
tk.Textウィジェットをstate=DISABLED(読み取り専用)で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。
例外処理とエラーハンドリング
try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。
6. ステップバイステップガイド
このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。
-
1ファイルを作成する
新しいファイルを作成して app072.py と保存します。
-
2クラスの骨格を作る
App072クラスを定義し、__init__とmainloop()の最小構成を作ります。
-
3タイトルバーを作る
Frameを使ってカラーバー付きのタイトルエリアを作ります。
-
4入力フォームを実装する
LabelFrameとEntryウィジェットで入力エリアを作ります。
-
5処理ロジックを実装する
_execute()メソッドにメインロジックを実装します。
-
6結果表示を実装する
TextウィジェットかLabelに結果を表示する_show_result()を実装します。
-
7エラー処理を追加する
try-exceptとmessageboxでエラーハンドリングを追加します。
7. カスタマイズアイデア
基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。
💡 ダークモードを追加する
bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。
💡 データの保存機能
処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。
💡 設定ダイアログ
フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。
8. よくある問題と解決法
❌ 日本語フォントが表示されない
原因:システムに日本語フォントが見つからない場合があります。
解決法:font引数を省略するかシステムに合ったフォントを指定してください。
❌ ライブラリのインポートエラー
原因:必要なライブラリがインストールされていません。
解決法:pip install コマンドで必要なライブラリをインストールしてください。
❌ ウィンドウサイズが合わない
原因:画面解像度や表示スケールによって異なる場合があります。
解決法:root.geometry()で適切なサイズに調整してください。
9. 練習問題
アプリの理解を深めるための練習問題です。
-
課題1:機能拡張
ランダム献立提案に新しい機能を1つ追加してみましょう。
-
課題2:UIの改善
色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。
-
課題3:保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。