習慣トラッカー
毎日の習慣をチェックで管理し週間達成率を表示するアプリ。継続記録をCSVに保存する機能付き。
1. アプリ概要
毎日の習慣をチェックで管理し週間達成率を表示するアプリ。継続記録をCSVに保存する機能付き。
このアプリはorganizersカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★★☆ です。
このアプリは「整理ツール」カテゴリです。整理・分類系のツールはデータ構造とユーザー操作を結びつける書き方を学ぶ好機です。設計次第で書きやすさが大きく変わります。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。
完成形を見てから細部の解説に進む流れが効果的です。実行→気になる箇所を解説で確認→自分の手で改造、というサイクルで定着が早まります。
カスタマイズ章では具体的な拡張アイデアを示しています。一つ実装するごとに動作確認することで、変更が予期せぬ副作用を起こさないかも体感できます。
2. 機能一覧
- 習慣トラッカーのメイン機能
- 直感的なGUIインターフェース
- 入力値のバリデーション
- エラーハンドリング
- 結果の見やすい表示
- クリア機能付き
3. 事前準備・環境
Python 3.10 以上 / Windows・Mac・Linux すべて対応
以下の環境で動作確認しています。
- Python 3.10 以上
- OS: Windows 10/11・macOS 12+・Ubuntu 20.04+
4. 完全なソースコード
右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。
import csv
import datetime
import os
import tkinter as tk
from tkinter import filedialog, messagebox, ttk
class App062:
"""習慣トラッカー"""
def __init__(self, root):
self.root = root
self.root.title("習慣トラッカー")
self.root.geometry("780x520")
self.root.configure(bg="#f8f9fc")
# 過去7日間 (今日を含む)
today = datetime.date.today()
self.days = [today - datetime.timedelta(days=6 - i) for i in range(7)]
# habit name -> {date: bool}
self.habits = {}
self.vars = {} # (habit, date) -> IntVar
self._build_ui()
def _build_ui(self):
"""UI を構築する"""
title = tk.Frame(self.root, bg="#3776ab", pady=12)
title.pack(fill=tk.X)
tk.Label(title, text="習慣トラッカー", font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white").pack()
ctrl = ttk.LabelFrame(self.root, text="操作", padding=10)
ctrl.pack(fill=tk.X, padx=15, pady=10)
ttk.Label(ctrl, text="習慣:").grid(row=0, column=0)
self.entry = ttk.Entry(ctrl, width=22)
self.entry.grid(row=0, column=1, padx=6)
self.entry.bind("<Return>", lambda e: self.add_habit())
ttk.Button(ctrl, text="追加", command=self.add_habit).grid(row=0, column=2, padx=4)
ttk.Button(ctrl, text="選択削除", command=self.remove_habit).grid(row=0, column=3, padx=4)
ttk.Button(ctrl, text="CSV保存", command=self.save_csv).grid(row=0, column=4, padx=4)
ttk.Button(ctrl, text="CSV読込", command=self.load_csv).grid(row=0, column=5, padx=4)
self.grid_frame = ttk.LabelFrame(self.root, text="チェックリスト（過去7日間）", padding=10)
self.grid_frame.pack(fill=tk.BOTH, expand=True, padx=15, pady=5)
self.summary = tk.Label(self.root, text="", bg="#f8f9fc",
font=("Noto Sans JP", 11, "bold"), fg="#3776ab")
self.summary.pack(pady=8)
self._render_grid()
def _render_grid(self):
"""チェックリストグリッドを再描画する"""
for w in self.grid_frame.winfo_children():
w.destroy()
# ヘッダ
ttk.Label(self.grid_frame, text="習慣", width=20, anchor="w",
font=("Noto Sans JP", 10, "bold")).grid(row=0, column=0, padx=4, pady=4)
for i, d in enumerate(self.days):
ttk.Label(self.grid_frame, text=d.strftime("%m/%d\n(%a)"),
font=("Noto Sans JP", 9, "bold")).grid(row=0, column=i + 1, padx=2)
ttk.Label(self.grid_frame, text="達成率", font=("Noto Sans JP", 10, "bold")).grid(
row=0, column=8, padx=6)
self.selected = tk.StringVar(value="")
for r, habit in enumerate(self.habits, start=1):
ttk.Radiobutton(self.grid_frame, text=habit, value=habit,
variable=self.selected).grid(row=r, column=0, sticky="w", padx=4)
for c, d in enumerate(self.days):
v = tk.IntVar(value=1 if self.habits[habit].get(d.isoformat()) else 0)
self.vars[(habit, d.isoformat())] = v
ttk.Checkbutton(self.grid_frame, variable=v,
command=lambda h=habit, dt=d: self._on_check(h, dt)).grid(
row=r, column=c + 1)
ttk.Label(self.grid_frame, text=self._rate(habit)).grid(row=r, column=8)
self._update_summary()
def _on_check(self, habit, date):
"""チェック状態を保存しサマリを更新する"""
v = self.vars[(habit, date.isoformat())].get()
self.habits[habit][date.isoformat()] = bool(v)
self._render_grid()
def _rate(self, habit) -> str:
"""指定習慣の週間達成率を文字列で返す"""
done = sum(1 for d in self.days if self.habits[habit].get(d.isoformat()))
return f"{done}/7 ({int(done / 7 * 100)}%)"
def _update_summary(self):
"""全体達成率をサマリ欄に出す"""
if not self.habits:
self.summary.config(text="習慣を追加してください")
return
total = len(self.habits) * 7
done = sum(1 for h in self.habits for d in self.days
if self.habits[h].get(d.isoformat()))
self.summary.config(text=f"全体達成率: {done}/{total} ({int(done / total * 100)}%)")
def add_habit(self):
"""習慣を追加する"""
name = self.entry.get().strip()
if not name:
messagebox.showwarning("警告", "習慣名を入力してください")
return
if name in self.habits:
messagebox.showinfo("情報", "既に登録されています")
return
self.habits[name] = {}
self.entry.delete(0, tk.END)
self._render_grid()
def remove_habit(self):
"""選択中の習慣を削除する"""
target = getattr(self, "selected", tk.StringVar()).get()
if not target:
messagebox.showinfo("情報", "削除する習慣を選択してください")
return
if messagebox.askyesno("確認", f"「{target}」を削除しますか？"):
self.habits.pop(target, None)
self._render_grid()
def save_csv(self):
"""習慣記録をCSVに保存する"""
path = filedialog.asksaveasfilename(defaultextension=".csv",
filetypes=[("CSV", "*.csv")])
if not path:
return
try:
with open(path, "w", newline="", encoding="utf-8") as f:
writer = csv.writer(f)
writer.writerow(["habit"] + [d.isoformat() for d in self.days])
for h in self.habits:
row = [h] + [int(bool(self.habits[h].get(d.isoformat()))) for d in self.days]
writer.writerow(row)
messagebox.showinfo("保存完了", os.path.basename(path))
except OSError as e:
messagebox.showerror("エラー", str(e))
def load_csv(self):
"""CSV から記録を読み込む"""
path = filedialog.askopenfilename(filetypes=[("CSV", "*.csv")])
if not path:
return
try:
with open(path, "r", encoding="utf-8") as f:
reader = csv.reader(f)
header = next(reader)
date_cols = header[1:]
self.habits = {}
for row in reader:
if not row:
continue
self.habits[row[0]] = {date_cols[i]: bool(int(v))
for i, v in enumerate(row[1:]) if v}
self._render_grid()
except (OSError, ValueError, StopIteration) as e:
messagebox.showerror("エラー", f"読込失敗: {e}")
if __name__ == "__main__":
root = tk.Tk()
app = App062(root)
root.mainloop()
5. コード解説
習慣トラッカーのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。
クラス設計とコンストラクタ
App062クラスにアプリの全機能をまとめています。__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ファイルを作成する
新しいファイルを作成して app062.py と保存します。
-
2クラスの骨格を作る
App062クラスを定義し、__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：保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。