初心者向け No.100

旅行費用分割計算

旅行メンバーと各自の支払いを入力し誰が誰にいくら払うかを計算するアプリ。割り勘アルゴリズムを実装。

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

1. アプリ概要

旅行メンバーと各自の支払いを入力し誰が誰にいくら払うかを計算するアプリ。割り勘アルゴリズムを実装。

このアプリはconvertersカテゴリの実践的な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. 完全なソースコード

💡
コードのコピー方法

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

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


class App100:
    """旅行費用分割計算: メンバーごとの支払いから精算プランを算出"""

    def __init__(self, root):
        self.root = root
        self.root.title("旅行費用分割計算")
        self.root.geometry("700x600")
        self.root.configure(bg="#f8f9fc")
        # 支払い記録: [(name, amount), ...]
        self.payments = []
        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 = tk.Frame(self.root, bg="#f8f9fc", padx=15, pady=15)
        main.pack(fill=tk.BOTH, expand=True)

        # 支払い登録フォーム
        form = ttk.LabelFrame(main, text="支払いを登録", padding=10)
        form.pack(fill=tk.X)
        ttk.Label(form, text="名前").grid(row=0, column=0, sticky="w")
        self.name_var = tk.StringVar()
        ttk.Entry(form, textvariable=self.name_var, width=15).grid(row=0, column=1, padx=8)
        ttk.Label(form, text="支払額(円)").grid(row=0, column=2, sticky="w")
        self.amount_var = tk.StringVar()
        ttk.Entry(form, textvariable=self.amount_var, width=12).grid(row=0, column=3, padx=8)
        ttk.Button(form, text="追加", command=self.add_payment).grid(row=0, column=4, padx=4)
        ttk.Button(form, text="選択削除", command=self.remove_selected).grid(row=0, column=5, padx=4)

        # 支払いリスト
        list_frame = ttk.LabelFrame(main, text="支払い一覧", padding=6)
        list_frame.pack(fill=tk.BOTH, expand=True, pady=8)
        cols = ("名前", "支払額")
        self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=8)
        for c in cols:
            self.tree.heading(c, text=c)
        self.tree.column("名前", width=200)
        self.tree.column("支払額", width=150, anchor="e")
        self.tree.pack(fill=tk.BOTH, expand=True)

        # 集計ボタン
        btn = tk.Frame(main, bg="#f8f9fc")
        btn.pack(pady=4)
        ttk.Button(btn, text="精算プランを計算", command=self.calculate).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="全クリア", command=self.clear_all).pack(side=tk.LEFT, padx=4)

        # 結果表示
        result_frame = ttk.LabelFrame(main, text="精算プラン", padding=6)
        result_frame.pack(fill=tk.BOTH, expand=True)
        self.result_text = tk.Text(result_frame, height=8, font=("Noto Sans JP", 11), bg="white")
        self.result_text.pack(fill=tk.BOTH, expand=True)

    def add_payment(self):
        """支払いを追加する"""
        name = self.name_var.get().strip()
        if not name:
            messagebox.showwarning("入力エラー", "名前を入力してください")
            return
        try:
            amount = float(self.amount_var.get())
            if amount < 0:
                raise ValueError
        except ValueError:
            messagebox.showwarning("入力エラー", "支払額には正の数値を入力してください")
            return
        self.payments.append((name, amount))
        self.tree.insert("", tk.END, values=(name, f"{amount:,.0f} 円"))
        self.name_var.set("")
        self.amount_var.set("")

    def remove_selected(self):
        """選択行を削除する"""
        selected = self.tree.selection()
        if not selected:
            return
        for item in selected:
            idx = self.tree.index(item)
            self.tree.delete(item)
            if 0 <= idx < len(self.payments):
                del self.payments[idx]

    def clear_all(self):
        """全データをクリアする"""
        self.payments.clear()
        for item in self.tree.get_children():
            self.tree.delete(item)
        self.result_text.delete("1.0", tk.END)

    def calculate(self):
        """精算プランを計算する: 各人の収支から最小取引数で誰が誰に支払うかを算出"""
        if not self.payments:
            messagebox.showwarning("警告", "支払いを1件以上登録してください")
            return
        # 各人の合計支払い額を集計
        totals = {}
        for name, amount in self.payments:
            totals[name] = totals.get(name, 0) + amount
        people = list(totals.keys())
        n = len(people)
        if n < 2:
            messagebox.showwarning("警告", "メンバーが2人以上必要です")
            return
        total_sum = sum(totals.values())
        avg = total_sum / n
        # 各人の収支(支払額 - 平均)。プラスは多く払った=受取、マイナスは支払う側
        balances = {p: totals[p] - avg for p in people}

        # グリーディに精算: 受取側と支払側をペアリング
        creditors = sorted(((p, b) for p, b in balances.items() if b > 0.005), key=lambda x: -x[1])
        debtors = sorted(((p, -b) for p, b in balances.items() if b < -0.005), key=lambda x: -x[1])

        transactions = []
        i = j = 0
        # リストをミュータブルにコピー
        creds = [list(c) for c in creditors]
        debs = [list(d) for d in debtors]
        while i < len(debs) and j < len(creds):
            pay = min(debs[i][1], creds[j][1])
            transactions.append((debs[i][0], creds[j][0], pay))
            debs[i][1] -= pay
            creds[j][1] -= pay
            if debs[i][1] < 0.01:
                i += 1
            if creds[j][1] < 0.01:
                j += 1

        # 結果出力
        self.result_text.delete("1.0", tk.END)
        out = []
        out.append(f"参加者: {n} 名")
        out.append(f"合計支出: {total_sum:,.0f} 円")
        out.append(f"1人あたり負担: {avg:,.0f} 円")
        out.append("")
        out.append("【各メンバーの収支】")
        for p in people:
            sign = "+" if balances[p] >= 0 else ""
            out.append(f"  {p}: 支払 {totals[p]:,.0f} 円 ({sign}{balances[p]:,.0f} 円)")
        out.append("")
        out.append("【精算プラン】")
        if not transactions:
            out.append("  全員ぴったり同額です。精算不要!")
        else:
            for fr, to, amt in transactions:
                out.append(f"  {fr} → {to}: {amt:,.0f} 円")
        self.result_text.insert("1.0", "\n".join(out))


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

5. コード解説

旅行費用分割計算のコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

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

App100クラスにアプリの全機能をまとめています。__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
    ファイルを作成する

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

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

    App100クラスを定義し、__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:保存機能の追加

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

🚀
次に挑戦するアプリ

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