初心者向け No.052

割り勘計算アプリ

飲食代・人数・チップ率を入力して一人当たりの支払い金額を計算するアプリ。Scaleウィジェットとリアルタイム計算を学ぶ。

🎯 難易度: ★☆☆ 易しい 📦 ライブラリ: tkinter ⏱️ 制作時間: 30〜90分

1. アプリ概要

飲食代・人数・チップ率を入力して一人当たりの支払い金額を計算するアプリ。Scaleウィジェットとリアルタイム計算を学ぶ。

このアプリは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. 完全なソースコード

💡
コードのコピー方法

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

追加インストール不要(標準ライブラリのみ使用)
app052.py
import tkinter as tk
from tkinter import ttk, messagebox


class App052:
    """割り勘計算アプリ: 金額・人数・チップ率から1人あたりの金額を算出"""

    def __init__(self, root):
        self.root = root
        self.root.title("割り勘計算アプリ")
        self.root.geometry("600x500")
        self.root.configure(bg="#f8f9fc")
        self._build_ui()
        self._calculate()  # 初期表示

    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)

        # 入力フォーム
        form = ttk.LabelFrame(main, text="入力", padding=12)
        form.pack(fill=tk.X)

        ttk.Label(form, text="飲食代の合計 (円)").grid(row=0, column=0, sticky="w", pady=4)
        self.amount_var = tk.StringVar(value="10000")
        self.amount_entry = ttk.Entry(form, textvariable=self.amount_var, width=15)
        self.amount_entry.grid(row=0, column=1, sticky="w", padx=8)
        self.amount_var.trace_add("write", lambda *a: self._calculate())

        ttk.Label(form, text="人数").grid(row=1, column=0, sticky="w", pady=4)
        self.people_var = tk.IntVar(value=4)
        self.people_scale = ttk.Scale(
            form, from_=1, to=20, orient=tk.HORIZONTAL,
            variable=self.people_var, command=lambda v: self._on_scale()
        )
        self.people_scale.grid(row=1, column=1, sticky="ew", padx=8)
        self.people_label = ttk.Label(form, text="4 人")
        self.people_label.grid(row=1, column=2, sticky="w")

        ttk.Label(form, text="チップ率 (%)").grid(row=2, column=0, sticky="w", pady=4)
        self.tip_var = tk.DoubleVar(value=0)
        self.tip_scale = ttk.Scale(
            form, from_=0, to=30, orient=tk.HORIZONTAL,
            variable=self.tip_var, command=lambda v: self._on_scale()
        )
        self.tip_scale.grid(row=2, column=1, sticky="ew", padx=8)
        self.tip_label = ttk.Label(form, text="0 %")
        self.tip_label.grid(row=2, column=2, sticky="w")

        form.columnconfigure(1, weight=1)

        # 結果表示
        result = ttk.LabelFrame(main, text="計算結果", padding=12)
        result.pack(fill=tk.BOTH, expand=True, pady=(12, 0))
        self.total_var = tk.StringVar(value="-")
        self.per_var = tk.StringVar(value="-")
        self.tip_amt_var = tk.StringVar(value="-")
        ttk.Label(result, text="合計 (チップ込み):").grid(row=0, column=0, sticky="w", pady=4)
        ttk.Label(result, textvariable=self.total_var, font=("Noto Sans JP", 12, "bold")).grid(row=0, column=1, sticky="w")
        ttk.Label(result, text="うちチップ:").grid(row=1, column=0, sticky="w", pady=4)
        ttk.Label(result, textvariable=self.tip_amt_var).grid(row=1, column=1, sticky="w")
        ttk.Label(result, text="一人あたり:").grid(row=2, column=0, sticky="w", pady=4)
        ttk.Label(result, textvariable=self.per_var, font=("Noto Sans JP", 14, "bold"), foreground="#3776ab").grid(row=2, column=1, sticky="w")

    def _on_scale(self):
        """Scale 変更ハンドラ: ラベル更新と再計算"""
        self.people_label.config(text=f"{int(self.people_var.get())} 人")
        self.tip_label.config(text=f"{int(self.tip_var.get())} %")
        self._calculate()

    def _calculate(self):
        """金額を計算して結果を更新する"""
        try:
            amount = float(self.amount_var.get())
        except ValueError:
            self.total_var.set("入力エラー")
            self.per_var.set("-")
            self.tip_amt_var.set("-")
            return
        if amount < 0:
            self.total_var.set("金額が不正")
            self.per_var.set("-")
            self.tip_amt_var.set("-")
            return
        people = max(1, int(self.people_var.get()))
        tip_pct = float(self.tip_var.get())
        tip_amt = amount * tip_pct / 100
        total = amount + tip_amt
        per = total / people
        self.total_var.set(f"{total:,.0f} 円")
        self.tip_amt_var.set(f"{tip_amt:,.0f} 円 ({tip_pct:.0f}%)")
        self.per_var.set(f"{per:,.0f} 円 / 人")


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

5. コード解説

割り勘計算アプリのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

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

App052クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

UIレイアウトの構築

LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

イベント処理

ボタンのcommand引数でクリックイベントを、bind('')でEnterキーイベントを処理します。どちらの操作でも同じprocess()が呼ばれ、コードの重複を避けられます。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

Textウィジェットでの結果表示

tk.Textウィジェットをstate=DISABLED(読み取り専用)で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

例外処理とエラーハンドリング

try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

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

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

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

    新しいファイルを作成して app052.py と保存します。

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

    App052クラスを定義し、__init__とmainloop()の最小構成を作ります。

  3. 3
    タイトルバーを作る

    Frameを使ってカラーバー付きのタイトルエリアを作ります。

  4. 4
    入力フォームを実装する

    LabelFrameとEntryウィジェットで入力エリアを作ります。

  5. 5
    処理ロジックを実装する

    _execute()メソッドにメインロジックを実装します。

  6. 6
    結果表示を実装する

    TextウィジェットかLabelに結果を表示する_show_result()を実装します。

  7. 7
    エラー処理を追加する

    try-exceptとmessageboxでエラーハンドリングを追加します。

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

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

💡 ダークモードを追加する

bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。

💡 データの保存機能

処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。

💡 設定ダイアログ

フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。

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

❌ 日本語フォントが表示されない

原因:システムに日本語フォントが見つからない場合があります。

解決法:font引数を省略するかシステムに合ったフォントを指定してください。

❌ ライブラリのインポートエラー

原因:必要なライブラリがインストールされていません。

解決法:pip install コマンドで必要なライブラリをインストールしてください。

❌ ウィンドウサイズが合わない

原因:画面解像度や表示スケールによって異なる場合があります。

解決法:root.geometry()で適切なサイズに調整してください。

9. 練習問題

アプリの理解を深めるための練習問題です。

  1. 課題1:機能拡張

    割り勘計算アプリに新しい機能を1つ追加してみましょう。

  2. 課題2:UIの改善

    色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。

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

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

🚀
次に挑戦するアプリ

このアプリをマスターしたら、次のアプリに挑戦しましょう。