初心者向け No.097

テキスト差分ハイライト

2つのテキストを比較して追加・削除・変更箇所を色付きでハイライト表示するdiffツール。difflib活用。

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

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

2つのテキストを比較して追加・削除・変更箇所を色付きでハイライト表示するdiffツール。difflib活用。

このアプリはtoolsカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★★☆ です。

このアプリは「ツール」カテゴリです。日々の作業を自動化する実用ツールは Python が最も得意とする領域です。短いコードで実用性のある成果物が作れる点が魅力です。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

コードを読む前に実行することをおすすめします。動いている挙動を先に把握しておくと、解説で出てくる関数や処理がどこに対応するかが頭に入りやすくなります。

応用のヒントは、機能を 1 つ増やす・見た目を整える・例外を一つでも丁寧に扱う、のいずれかから始めるのがおすすめです。

2. 機能一覧

テキスト差分ハイライトのメイン機能
直感的なGUIインターフェース
入力値のバリデーション
エラーハンドリング
結果の見やすい表示
クリア機能付き

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows・Mac・Linux すべて対応

以下の環境で動作確認しています。

Python 3.10 以上
OS: Windows 10/11・macOS 12+・Ubuntu 20.04+

4. 完全なソースコード

💡

コードのコピー方法

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

✅ 追加インストール不要（標準ライブラリのみ使用）

app097.py

import tkinter as tk
from tkinter import ttk, messagebox
import difflib


class App097:
    """テキスト差分ハイライト: 2つのテキストを比較して色付き表示"""

    def __init__(self, root):
        self.root = root
        self.root.title("テキスト差分ハイライト")
        self.root.geometry("900x600")
        self.root.configure(bg="#f8f9fc")
        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)

        # 入力エリア(左右)
        input_frame = tk.Frame(main, bg="#f8f9fc")
        input_frame.pack(fill=tk.BOTH, expand=True)

        left = ttk.LabelFrame(input_frame, text="テキスト A (変更前)", padding=6)
        left.grid(row=0, column=0, sticky="nsew", padx=(0, 6))
        self.text_a = tk.Text(left, height=10, font=("Consolas", 10), wrap=tk.NONE)
        self.text_a.pack(fill=tk.BOTH, expand=True)

        right = ttk.LabelFrame(input_frame, text="テキスト B (変更後)", padding=6)
        right.grid(row=0, column=1, sticky="nsew", padx=(6, 0))
        self.text_b = tk.Text(right, height=10, font=("Consolas", 10), wrap=tk.NONE)
        self.text_b.pack(fill=tk.BOTH, expand=True)

        input_frame.columnconfigure(0, weight=1)
        input_frame.columnconfigure(1, weight=1)
        input_frame.rowconfigure(0, weight=1)

        # 操作ボタン
        btn = tk.Frame(main, bg="#f8f9fc")
        btn.pack(pady=8)
        ttk.Button(btn, text="差分を比較", command=self.compare).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="クリア", command=self.clear).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="サンプル投入", command=self.load_sample).pack(side=tk.LEFT, padx=4)

        # 結果(色付き diff)
        result_frame = ttk.LabelFrame(main, text="差分結果 (緑=追加 / 赤=削除 / 黄=変更)", padding=6)
        result_frame.pack(fill=tk.BOTH, expand=True)
        self.result_text = tk.Text(result_frame, font=("Consolas", 10), wrap=tk.NONE)
        self.result_text.pack(fill=tk.BOTH, expand=True, side=tk.LEFT)
        scrollbar = ttk.Scrollbar(result_frame, command=self.result_text.yview)
        self.result_text.configure(yscrollcommand=scrollbar.set)
        scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

        # ハイライト用のタグ定義
        self.result_text.tag_configure("add", background="#d4edda", foreground="#155724")
        self.result_text.tag_configure("del", background="#f8d7da", foreground="#721c24")
        self.result_text.tag_configure("chg", background="#fff3cd", foreground="#856404")
        self.result_text.tag_configure("info", foreground="#666")

    def compare(self):
        """差分を計算して色付き表示する"""
        a = self.text_a.get("1.0", tk.END).splitlines()
        b = self.text_b.get("1.0", tk.END).splitlines()
        if not any(a) and not any(b):
            messagebox.showwarning("警告", "比較するテキストを入力してください")
            return
        self.result_text.delete("1.0", tk.END)
        diff = list(difflib.ndiff(a, b))
        added = removed = changed = 0
        for line in diff:
            if not line:
                continue
            tag = None
            prefix = line[:2]
            if prefix == "+ ":
                tag = "add"
                added += 1
            elif prefix == "- ":
                tag = "del"
                removed += 1
            elif prefix == "? ":
                tag = "chg"
                changed += 1
            elif prefix == "  ":
                tag = None  # 変化なし
            self.result_text.insert(tk.END, line + "\n", tag)
        # サマリ
        summary = f"\n--- サマリ: 追加 {added} / 削除 {removed} / 変更ヒント {changed} ---\n"
        self.result_text.insert(tk.END, summary, "info")

    def clear(self):
        """全テキストをクリアする"""
        self.text_a.delete("1.0", tk.END)
        self.text_b.delete("1.0", tk.END)
        self.result_text.delete("1.0", tk.END)

    def load_sample(self):
        """動作確認用サンプルを投入する"""
        sample_a = "りんご\nバナナ\nぶどう\nみかん"
        sample_b = "りんご\nオレンジ\nぶどう\nみかん\nメロン"
        self.text_a.delete("1.0", tk.END)
        self.text_a.insert("1.0", sample_a)
        self.text_b.delete("1.0", tk.END)
        self.text_b.insert("1.0", sample_b)


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

5. コード解説

テキスト差分ハイライトのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

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

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