ペット健康ノート
ペットの体重・食事・投薬・通院を日付別に記録するノートアプリ。グラフ表示と健康アラート付き。
1. アプリ概要
ペットの体重・食事・投薬・通院を日付別に記録するノートアプリ。グラフ表示と健康アラート付き。
このアプリはorganizersカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★★☆ です。
このアプリは「整理ツール」カテゴリです。整理・分類系のツールはデータ構造とユーザー操作を結びつける書き方を学ぶ好機です。設計次第で書きやすさが大きく変わります。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 json
import os
from datetime import datetime, date
class App096:
"""ペット健康ノート"""
SAVE_FILE = "pet_health.json"
KINDS = ("体重", "食事", "投薬", "通院")
def __init__(self, root):
self.root = root
self.root.title("ペット健康ノート")
self.root.geometry("780x560")
self.root.configure(bg="#f8f9fc")
self.records = [] # [{date, kind, value, note}]
self._build_ui()
self._load()
self._refresh()
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=14, pady=14)
main_frame.pack(fill=tk.BOTH, expand=True)
# 入力エリア
input_frame = ttk.LabelFrame(main_frame, text="記録の追加", padding=10)
input_frame.pack(fill=tk.X, pady=(0, 10))
tk.Label(input_frame, text="日付(YYYY-MM-DD):").grid(row=0, column=0, sticky="w")
self.date_entry = ttk.Entry(input_frame, width=12)
self.date_entry.insert(0, date.today().isoformat())
self.date_entry.grid(row=0, column=1, padx=4)
tk.Label(input_frame, text="種別:").grid(row=0, column=2, sticky="w")
self.kind_var = tk.StringVar(value=self.KINDS[0])
ttk.Combobox(
input_frame, textvariable=self.kind_var,
values=self.KINDS, width=8, state="readonly"
).grid(row=0, column=3, padx=4)
tk.Label(input_frame, text="値:").grid(row=0, column=4, sticky="w")
self.value_entry = ttk.Entry(input_frame, width=10)
self.value_entry.grid(row=0, column=5, padx=4)
tk.Label(input_frame, text="メモ:").grid(row=1, column=0, sticky="w", pady=(6, 0))
self.note_entry = ttk.Entry(input_frame)
self.note_entry.grid(row=1, column=1, columnspan=4, sticky="ew", padx=4, pady=(6, 0))
input_frame.columnconfigure(3, weight=1)
ttk.Button(input_frame, text="追加", command=self.add_record).grid(row=1, column=5, padx=4, pady=(6, 0))
# 一覧
list_frame = ttk.LabelFrame(main_frame, text="記録一覧", padding=6)
list_frame.pack(fill=tk.BOTH, expand=True, pady=(0, 8))
cols = ("date", "kind", "value", "note")
self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=10)
for c, w in zip(cols, (110, 80, 100, 380)):
self.tree.heading(c, text={"date": "日付", "kind": "種別", "value": "値", "note": "メモ"}[c])
self.tree.column(c, width=w, anchor="w")
self.tree.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
self.tree.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
# グラフ＆操作
bottom = tk.Frame(main_frame, bg="#f8f9fc")
bottom.pack(fill=tk.BOTH, expand=False)
graph_frame = ttk.LabelFrame(bottom, text="体重推移グラフ", padding=6)
graph_frame.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
self.canvas = tk.Canvas(graph_frame, height=130, bg="white", highlightthickness=1)
self.canvas.pack(fill=tk.BOTH, expand=True)
op_frame = tk.Frame(bottom, bg="#f8f9fc")
op_frame.pack(side=tk.RIGHT, padx=(8, 0))
ttk.Button(op_frame, text="選択削除", command=self.delete_selected).pack(fill=tk.X, pady=2)
ttk.Button(op_frame, text="保存", command=self._save).pack(fill=tk.X, pady=2)
ttk.Button(op_frame, text="エクスポート", command=self.export_json).pack(fill=tk.X, pady=2)
# アラート表示
self.alert_label = tk.Label(main_frame, text="", bg="#f8f9fc", fg="#dc3545", anchor="w")
self.alert_label.pack(fill=tk.X, pady=(6, 0))
def add_record(self):
"""記録を追加する"""
d = self.date_entry.get().strip()
kind = self.kind_var.get()
val = self.value_entry.get().strip()
note = self.note_entry.get().strip()
try:
datetime.strptime(d, "%Y-%m-%d")
except ValueError:
messagebox.showerror("エラー", "日付は YYYY-MM-DD 形式で入力してください")
return
if not val:
messagebox.showwarning("警告", "値を入力してください")
return
self.records.append({"date": d, "kind": kind, "value": val, "note": note})
self.value_entry.delete(0, tk.END)
self.note_entry.delete(0, tk.END)
self._save()
self._refresh()
def delete_selected(self):
"""選択行を削除"""
sel = self.tree.selection()
if not sel:
return
idx = int(self.tree.item(sel[0], "tags")[0])
del self.records[idx]
self._save()
self._refresh()
def _refresh(self):
"""一覧とグラフを再描画"""
for i in self.tree.get_children():
self.tree.delete(i)
sorted_recs = sorted(enumerate(self.records), key=lambda x: x[1]["date"])
for orig_i, r in sorted_recs:
self.tree.insert("", tk.END, values=(r["date"], r["kind"], r["value"], r["note"]), tags=(str(orig_i),))
self._draw_graph()
self._check_alerts()
def _draw_graph(self):
"""体重データを折れ線グラフで描画"""
self.canvas.delete("all")
weights = []
for r in sorted(self.records, key=lambda x: x["date"]):
if r["kind"] == "体重":
try:
weights.append((r["date"], float(r["value"])))
except ValueError:
continue
self.canvas.update_idletasks()
w = self.canvas.winfo_width() or 500
h = self.canvas.winfo_height() or 130
if len(weights) < 2:
self.canvas.create_text(w / 2, h / 2, text="体重データが2件以上で表示されます", fill="#999")
return
ys = [v for _, v in weights]
ymin, ymax = min(ys), max(ys)
if ymin == ymax:
ymin -= 1
ymax += 1
pad = 20
n = len(weights)
pts = []
for i, (_, v) in enumerate(weights):
x = pad + (w - 2 * pad) * i / max(1, n - 1)
y = h - pad - (h - 2 * pad) * (v - ymin) / (ymax - ymin)
pts.extend([x, y])
self.canvas.create_line(*pts, fill="#3776ab", width=2)
for i in range(0, len(pts), 2):
self.canvas.create_oval(pts[i] - 3, pts[i + 1] - 3, pts[i] + 3, pts[i + 1] + 3, fill="#3776ab")
self.canvas.create_text(pad, pad - 8, anchor="w", text=f"最高 {ymax}kg / 最低 {ymin}kg", fill="#333")
def _check_alerts(self):
"""健康アラートを判定して表示"""
weights = sorted(
[r for r in self.records if r["kind"] == "体重"],
key=lambda x: x["date"]
)
msg = ""
if len(weights) >= 2:
try:
first = float(weights[0]["value"])
last = float(weights[-1]["value"])
if first > 0:
rate = (last - first) / first * 100
if abs(rate) >= 10:
msg = f"⚠ 体重が {rate:+.1f}% 変化しています。獣医師に相談を検討してください。"
except ValueError:
pass
self.alert_label.config(text=msg)
def _load(self):
"""保存ファイルを読み込む"""
if os.path.exists(self.SAVE_FILE):
try:
with open(self.SAVE_FILE, "r", encoding="utf-8") as f:
self.records = json.load(f)
except Exception:
self.records = []
def _save(self):
"""保存ファイルに書き出す"""
try:
with open(self.SAVE_FILE, "w", encoding="utf-8") as f:
json.dump(self.records, f, ensure_ascii=False, indent=2)
except Exception as e:
messagebox.showerror("エラー", f"保存に失敗: {e}")
def export_json(self):
"""ファイルダイアログでエクスポート"""
path = filedialog.asksaveasfilename(defaultextension=".json", filetypes=[("JSON", "*.json")])
if not path:
return
try:
with open(path, "w", encoding="utf-8") as f:
json.dump(self.records, f, ensure_ascii=False, indent=2)
messagebox.showinfo("完了", f"{path} に保存しました")
except Exception as e:
messagebox.showerror("エラー", f"書き出しに失敗: {e}")
if __name__ == "__main__":
root = tk.Tk()
app = App096(root)
root.mainloop()
5. コード解説
ペット健康ノートのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。
クラス設計とコンストラクタ
App096クラスにアプリの全機能をまとめています。__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ファイルを作成する
新しいファイルを作成して app096.py と保存します。
-
2クラスの骨格を作る
App096クラスを定義し、__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：保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。