通貨換算アプリ

1. アプリ概要

円・ドル・ユーロ等を換算する通貨計算ツール。Comboboxと換算レートの辞書管理を学びます。

このアプリは変換カテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter（標準ライブラリ） で、難易度は ★☆☆ です。

このアプリは「変換ツール」カテゴリです。形式変換ツールは入力・処理・出力の三層を明示的に書く好材料で、エラー入力の扱いやバリデーションの基本を体験できます。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

動かしながら読むことが理解の最短経路です。まずはコードをコピーして実行し、想定どおりに動くことを確認したうえで解説と照らし合わせてください。

カスタマイズでは「機能追加」「UI 改善」「エラー耐性」の三方向で考えると視野が広がります。練習問題にもそれぞれの方向の具体例を用意しています。

2. 機能一覧

• 「換算する」ボタン（process()）で操作
• キー <Return> から process() を実行
• messagebox.showerror()・messagebox.showwarning() によるダイアログ通知
• ウィンドウはタイトル「通貨換算アプリ」・サイズ 460x814 で起動

3. 事前準備・環境

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

• Python 3.10 以上
• OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

4. 完全なソースコード

import tkinter as tk
from tkinter import ttk, messagebox


class App12:
    """通貨換算アプリ"""

    # 対円レート（固定レートのサンプル）
    RATES = {
        "JPY 🇯🇵": 1.0,
        "USD 🇺🇸": 149.5,
        "EUR 🇪🇺": 162.0,
        "GBP 🇬🇧": 189.0,
        "CNY 🇨🇳": 20.6,
        "KRW 🇰🇷": 0.112,
        "AUD 🇦🇺": 97.0,
        "CAD 🇨🇦": 109.0,
    }

    def __init__(self, root):
        self.root = root
        self.root.title("通貨換算アプリ")
        self.root.geometry("460x814")
        self.root.minsize(460, 814)
        self.root.configure(bg="#f8f9fc")
        self._build_ui()

    def _build_ui(self):
        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=24, pady=16)
        main_frame.pack(fill=tk.BOTH, expand=True)

        currencies = list(self.RATES.keys())

        input_frame = ttk.LabelFrame(main_frame, text="入力", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))

        tk.Label(input_frame, text="金額:").grid(row=0, column=0, sticky="w", pady=4)
        self.entry = ttk.Entry(input_frame, width=16, font=("Arial", 13))
        self.entry.grid(row=0, column=1, padx=8, sticky="ew")
        self.entry.bind("<Return>", lambda e: self.process())

        tk.Label(input_frame, text="通貨:").grid(row=1, column=0, sticky="w", pady=4)
        self.from_var = tk.StringVar(value=currencies[1])  # USD
        self.from_combo = ttk.Combobox(input_frame, textvariable=self.from_var,
                                       values=currencies, state="readonly", width=14)
        self.from_combo.grid(row=1, column=1, padx=8, sticky="w")
        input_frame.columnconfigure(1, weight=1)

        ttk.Button(main_frame, text="換算する", command=self.process).pack(pady=8)

        result_frame = ttk.LabelFrame(main_frame, text="換算結果", padding=10)
        result_frame.pack(fill=tk.BOTH, expand=True)

        self.result_text = tk.Text(result_frame, font=("Noto Sans JP", 11),
                                   bg="white", relief=tk.FLAT, state=tk.DISABLED)
        self.result_text.pack(fill=tk.BOTH, expand=True)

        tk.Label(main_frame, text="※レートは固定サンプル値です",
                 bg="#f8f9fc", fg="#aaa", font=("Noto Sans JP", 9)).pack(anchor="e", pady=(4, 0))

    def process(self):
        text = self.entry.get().strip()
        if not text:
            messagebox.showwarning("警告", "金額を入力してください")
            return
        try:
            amount = float(text)
        except ValueError:
            messagebox.showerror("エラー", "数値を入力してください")
            return
        if amount < 0:
            messagebox.showerror("エラー", "正の数を入力してください")
            return

        from_cur = self.from_var.get()
        rate_to_jpy = self.RATES[from_cur]
        jpy_amount = amount * rate_to_jpy

        lines = [f"【{amount:,.2f} {from_cur} の換算結果】\n"]
        for cur, rate in self.RATES.items():
            converted = jpy_amount / rate
            lines.append(f"  {cur:<12}  {converted:>14,.2f}")

        self._show_result("\n".join(lines))

    def _show_result(self, text):
        self.result_text.config(state=tk.NORMAL)
        self.result_text.delete("1.0", tk.END)
        self.result_text.insert("1.0", text)
        self.result_text.config(state=tk.DISABLED)


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

5. コード解説

通貨換算アプリのコードを、実際に書かれている実装に沿って解説します。

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

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

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

   新しいファイルを作成して app12.py と保存します。使うのは tkinter だけなので、追加インストールは不要です。

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

   App12 クラスを定義し、__init__ と、末尾の root = tk.Tk() ～ mainloop() の最小構成を書いて、まず空のウィンドウが出ることを確認します。

3. 3
   ウィンドウを設定する

   title("通貨換算アプリ")・geometry("460x814")・configure(bg="#f8f9fc")・minsize(460, 814) をコンストラクタで設定します。

4. 4
   画面部品を並べる

   _build_ui() の中で、tk.Frame×2・tk.Label×4・ttk.LabelFrame×2・ttk.Entry・ttk.Combobox・ttk.Button・tk.Text を作って配置します（掲載コードと同じ並び順で書くとレイアウトが一致します）。まず表示だけ確認しましょう。

5. 5
   イベントを接続する

   「2. 機能一覧」で挙げた各ボタンを command= で対応するメソッド（process()）につなぎます。bind("<Return>", ...) の登録も忘れずに。

6. 6
   中心になるメソッドを実装する

   アプリの本体である process()（24行）・_show_result()（5行） を実装します。

7. 7
   動作確認する

   python app12.py で起動し、各ボタンが反応すること・キー操作（<Return>）が効くことを確認します。

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

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。少しずつ機能を追加することで、Pythonのスキルが飛躍的に向上します。

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

9. 練習問題

アプリの理解を深めるための練習問題です。気になるものから挑戦してみてください（課題3は定型の発展課題です）。このアプリのレートは学習用に固定した見本の値で、実勢レートではありません。実際の両替や送金の判断には使わないでください。

1. 課題1：レートを rates.json から読み込む

   レートはクラス先頭の RATES に直接書いてあり、変えるたびにコードを触ることになります。同じ形の rates.json があれば、そちらを使うようにしましょう。

   期待結果：{"JPY 🇯🇵": 1.0, "USD 🇺🇸": 155.0} と書いた rates.json を置いて起動する。通貨のプルダウンが2つだけになり、1 USD を換算すると JPY の行が 155.00 になる。

   合格条件

   • rates.json があると、その中身のレートで換算される
   • ファイルが無いときはエラーを出さず、これまでの8通貨で動く
   • 「※レートは固定サンプル値です」の注意書きは残す（自分で書いた値も自動では更新されないため）

   ヒント①（どこを触るか）: 触るのは __init__() の1か所です。self._build_ui() の手前で self.RATES に読み込んだ辞書を入れます。_build_ui() も process() も self.RATES を見ているため、そのままで動きます。
   ヒント②（使うもの）: 先頭に import json と import os を足し、if os.path.exists("rates.json"): で確かめてから with open("rates.json", "r", encoding="utf-8") as f: と開いて self.RATES = json.load(f) とします。キーは "USD 🇺🇸" のように、いまのキーと同じ文字列にそろえます。
   つまずきやすい点: 通貨を1つしか書かないと、起動時に currencies[1] を読む行で IndexError: list index out of range になるので、2つ以上入れてください。読み込みを self._build_ui() より後ろに置くと、プルダウンの中身は古い8通貨のままです。

2. 課題2：小数点以下の桁数を通貨に合わせる

   結果はすべて小数第2位まで出ますが、円やウォンは日常的に小数を使いません。通貨ごとに桁数を切り替えて、読みやすい一覧にしましょう。

   期待結果：100 USD を換算すると、JPY の行が 14,950・KRW の行が 133,482 と整数で出る。USD の行は 100.00 のまま。

   合格条件

   • JPY と KRW の行に、小数点以下が出ない
   • 他の通貨は、これまでどおり小数第2位まで出る
   • 3桁ごとのカンマと右そろえが崩れない

   ヒント①（どこを触るか）: 触るのは process() の1か所です。for cur, rate in self.RATES.items(): の中の lines.append(...) を書き換えます。_show_result() は触りません。
   ヒント②（使うもの）: クラスの先頭に NO_DECIMAL = ("JPY 🇯🇵", "KRW 🇰🇷") を足し、digits = 0 if cur in self.NO_DECIMAL else 2 と決めます。書式は f" {cur:<12} {converted:>14,.{digits}f}" のように、桁数の部分を {digits} で差し込めます。
   つまずきやすい点: 1行目の見出しは入力した金額なので、そちらも整数にしたいなら lines = [...] の書式を別に直します。.0f は四捨五入ではなく偶数丸めで、0.5 は 0・1.5 は 2 になります。

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

   入力値や計算結果をファイルに保存する機能を追加しましょう。jsonやcsvモジュールを使います。