中級者向け No.054

フォルダ同期ツール

2フォルダの差分を検出して一方向・双方向に同期するツール。コピー前プレビュー確認付き。

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

1. アプリ概要

2フォルダの差分を検出して一方向・双方向に同期するツール。コピー前プレビュー確認付き。

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

Pythonの豊富なライブラリを活用することで、実用的なアプリを短いコードで実装できます。ソースコードをコピーして実行し、仕組みを理解したうえでカスタマイズに挑戦してみてください。

GUIアプリ開発はプログラミングの楽しさを実感できる最も効果的な学習方法のひとつです。変数・関数・クラス・イベント処理などの重要な概念が自然と身につきます。

2. 機能一覧

  • フォルダ同期ツールのメイン機能
  • 直感的なGUIインターフェース
  • 入力値のバリデーション
  • エラーハンドリング
  • 結果の見やすい表示
  • クリア機能付き

3. 事前準備・環境

ℹ️
動作確認環境

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

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

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

4. 完全なソースコード

💡
コードのコピー方法

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

app054.py
import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import os
import shutil
import threading
import hashlib
from datetime import datetime


class App054:
    """フォルダ同期ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("フォルダ同期ツール")
        self.root.geometry("920x600")
        self.root.configure(bg="#1e1e1e")
        self._diff = []
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔄 フォルダ同期ツール",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # フォルダ選択
        folders_f = tk.Frame(self.root, bg="#252526", pady=6)
        folders_f.pack(fill=tk.X, padx=8, pady=4)

        for i, (label, attr) in enumerate([
                ("ソース (コピー元):", "src_var"),
                ("ターゲット (同期先):", "dst_var")]):
            row = tk.Frame(folders_f, bg="#252526")
            row.pack(fill=tk.X, pady=2)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=20, anchor="e").pack(side=tk.LEFT)
            var = tk.StringVar()
            setattr(self, attr, var)
            ttk.Entry(row, textvariable=var, width=50).pack(side=tk.LEFT, padx=4)
            ttk.Button(row, text="参照",
                       command=lambda v=var: self._pick(v)).pack(side=tk.LEFT)

        # オプション
        opt = tk.Frame(self.root, bg="#1e1e1e", pady=2)
        opt.pack(fill=tk.X, padx=8)
        self.delete_var = tk.BooleanVar(value=False)
        tk.Checkbutton(opt, text="ターゲットの余分なファイルを削除",
                       variable=self.delete_var,
                       bg="#1e1e1e", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#1e1e1e").pack(side=tk.LEFT)
        self.compare_var = tk.StringVar(value="mtime")
        tk.Label(opt, text="比較方法:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        ttk.Combobox(opt, textvariable=self.compare_var,
                     values=["mtime", "md5", "サイズ"],
                     state="readonly", width=8).pack(side=tk.LEFT)
        ttk.Button(opt, text="🔍 差分確認",
                   command=self._analyze).pack(side=tk.LEFT, padx=12)
        ttk.Button(opt, text="▶ 同期実行",
                   command=self._sync).pack(side=tk.LEFT)

        # 差分ツリー
        tree_f = tk.Frame(self.root, bg="#1e1e1e")
        tree_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        cols = ("action", "relpath", "src_info", "dst_info")
        self.tree = ttk.Treeview(tree_f, columns=cols, show="headings")
        self.tree.heading("action",   text="操作")
        self.tree.heading("relpath",  text="相対パス")
        self.tree.heading("src_info", text="ソース情報")
        self.tree.heading("dst_info", text="ターゲット情報")
        self.tree.column("action",   width=70,  anchor="center")
        self.tree.column("relpath",  width=320, anchor="w")
        self.tree.column("src_info", width=200, anchor="w")
        self.tree.column("dst_info", width=200, anchor="w")
        sb = ttk.Scrollbar(tree_f, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.tag_configure("copy",   foreground="#4fc3f7")
        self.tree.tag_configure("update", foreground="#ffd700")
        self.tree.tag_configure("delete", foreground="#f48771")
        self.tree.tag_configure("same",   foreground="#555")

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)

        self.status_var = tk.StringVar(value="フォルダを選択して差分確認してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _pick(self, var):
        folder = filedialog.askdirectory()
        if folder:
            var.set(folder)

    def _analyze(self):
        src = self.src_var.get().strip()
        dst = self.dst_var.get().strip()
        if not src or not os.path.isdir(src):
            messagebox.showerror("エラー", "ソースフォルダが無効です")
            return
        if not dst:
            messagebox.showerror("エラー", "ターゲットフォルダを指定してください")
            return
        self.status_var.set("差分を分析中...")
        threading.Thread(target=self._do_analyze, args=(src, dst),
                          daemon=True).start()

    def _do_analyze(self, src, dst):
        try:
            diff = self._compute_diff(src, dst)
            self.root.after(0, self._show_diff, diff)
        except Exception as e:
            self.root.after(0, lambda: messagebox.showerror("エラー", str(e)))

    def _compute_diff(self, src, dst):
        diff = []
        src_files = self._walk_rel(src)
        dst_files = self._walk_rel(dst) if os.path.isdir(dst) else {}

        for rel, src_path in src_files.items():
            dst_path = os.path.join(dst, rel)
            if rel not in dst_files:
                diff.append(("COPY", rel, src_path, dst_path))
            elif self._needs_update(src_path, dst_path):
                diff.append(("UPDATE", rel, src_path, dst_path))
            else:
                diff.append(("SAME", rel, src_path, dst_path))

        if self.delete_var.get():
            for rel in dst_files:
                if rel not in src_files:
                    diff.append(("DELETE", rel, "", os.path.join(dst, rel)))

        return diff

    def _walk_rel(self, folder):
        result = {}
        for dirpath, _, filenames in os.walk(folder):
            for fn in filenames:
                full = os.path.join(dirpath, fn)
                rel = os.path.relpath(full, folder)
                result[rel] = full
        return result

    def _needs_update(self, src, dst):
        method = self.compare_var.get()
        try:
            if method == "mtime":
                return os.path.getmtime(src) > os.path.getmtime(dst)
            elif method == "サイズ":
                return os.path.getsize(src) != os.path.getsize(dst)
            elif method == "md5":
                return self._md5(src) != self._md5(dst)
        except Exception:
            return True
        return False

    def _md5(self, path):
        h = hashlib.md5()
        with open(path, "rb") as f:
            for chunk in iter(lambda: f.read(65536), b""):
                h.update(chunk)
        return h.hexdigest()

    def _fmt_file_info(self, path):
        try:
            stat = os.stat(path)
            mtime = datetime.fromtimestamp(stat.st_mtime).strftime("%Y-%m-%d %H:%M")
            size = stat.st_size
            if size < 1024:
                sstr = f"{size}B"
            elif size < 1024**2:
                sstr = f"{size/1024:.1f}KB"
            else:
                sstr = f"{size/1024**2:.1f}MB"
            return f"{mtime}  {sstr}"
        except Exception:
            return ""

    def _show_diff(self, diff):
        self._diff = diff
        self.tree.delete(*self.tree.get_children())
        counts = {"COPY": 0, "UPDATE": 0, "DELETE": 0, "SAME": 0}
        for action, rel, src_path, dst_path in diff:
            counts[action] = counts.get(action, 0) + 1
            src_info = self._fmt_file_info(src_path) if src_path else ""
            dst_info = self._fmt_file_info(dst_path) if os.path.exists(dst_path) else "-"
            tag = action.lower() if action != "UPDATE" else "update"
            self.tree.insert("", tk.END,
                              values=(action, rel, src_info, dst_info),
                              tags=(tag,))
        self.status_var.set(
            f"差分: COPY={counts['COPY']} UPDATE={counts['UPDATE']} "
            f"DELETE={counts['DELETE']} SAME={counts['SAME']}")

    def _sync(self):
        if not self._diff:
            messagebox.showinfo("情報", "先に差分確認を実行してください")
            return
        ops = [(a, r, s, d) for a, r, s, d in self._diff if a != "SAME"]
        if not ops:
            messagebox.showinfo("情報", "同期不要です(すべて最新状態)")
            return
        if not messagebox.askyesno("確認", f"{len(ops)} 件の操作を実行します。\nよろしいですか?"):
            return
        self.progress["maximum"] = len(ops)
        self.progress["value"] = 0
        threading.Thread(target=self._do_sync, args=(ops,),
                          daemon=True).start()

    def _do_sync(self, ops):
        ok = err = 0
        for i, (action, rel, src, dst) in enumerate(ops):
            try:
                if action in ("COPY", "UPDATE"):
                    os.makedirs(os.path.dirname(dst), exist_ok=True)
                    shutil.copy2(src, dst)
                elif action == "DELETE":
                    os.remove(dst)
                ok += 1
            except Exception:
                err += 1
            self.root.after(0, self.progress.configure,
                             {"value": i + 1})
        self.root.after(0, self._sync_done, ok, err)

    def _sync_done(self, ok, err):
        self.status_var.set(f"同期完了: {ok} 件成功 / {err} 件失敗")
        messagebox.showinfo("完了", f"同期が完了しました。\n成功: {ok}  失敗: {err}")
        self._analyze()


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

5. コード解説

フォルダ同期ツールのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

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

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import os
import shutil
import threading
import hashlib
from datetime import datetime


class App054:
    """フォルダ同期ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("フォルダ同期ツール")
        self.root.geometry("920x600")
        self.root.configure(bg="#1e1e1e")
        self._diff = []
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔄 フォルダ同期ツール",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # フォルダ選択
        folders_f = tk.Frame(self.root, bg="#252526", pady=6)
        folders_f.pack(fill=tk.X, padx=8, pady=4)

        for i, (label, attr) in enumerate([
                ("ソース (コピー元):", "src_var"),
                ("ターゲット (同期先):", "dst_var")]):
            row = tk.Frame(folders_f, bg="#252526")
            row.pack(fill=tk.X, pady=2)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=20, anchor="e").pack(side=tk.LEFT)
            var = tk.StringVar()
            setattr(self, attr, var)
            ttk.Entry(row, textvariable=var, width=50).pack(side=tk.LEFT, padx=4)
            ttk.Button(row, text="参照",
                       command=lambda v=var: self._pick(v)).pack(side=tk.LEFT)

        # オプション
        opt = tk.Frame(self.root, bg="#1e1e1e", pady=2)
        opt.pack(fill=tk.X, padx=8)
        self.delete_var = tk.BooleanVar(value=False)
        tk.Checkbutton(opt, text="ターゲットの余分なファイルを削除",
                       variable=self.delete_var,
                       bg="#1e1e1e", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#1e1e1e").pack(side=tk.LEFT)
        self.compare_var = tk.StringVar(value="mtime")
        tk.Label(opt, text="比較方法:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        ttk.Combobox(opt, textvariable=self.compare_var,
                     values=["mtime", "md5", "サイズ"],
                     state="readonly", width=8).pack(side=tk.LEFT)
        ttk.Button(opt, text="🔍 差分確認",
                   command=self._analyze).pack(side=tk.LEFT, padx=12)
        ttk.Button(opt, text="▶ 同期実行",
                   command=self._sync).pack(side=tk.LEFT)

        # 差分ツリー
        tree_f = tk.Frame(self.root, bg="#1e1e1e")
        tree_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        cols = ("action", "relpath", "src_info", "dst_info")
        self.tree = ttk.Treeview(tree_f, columns=cols, show="headings")
        self.tree.heading("action",   text="操作")
        self.tree.heading("relpath",  text="相対パス")
        self.tree.heading("src_info", text="ソース情報")
        self.tree.heading("dst_info", text="ターゲット情報")
        self.tree.column("action",   width=70,  anchor="center")
        self.tree.column("relpath",  width=320, anchor="w")
        self.tree.column("src_info", width=200, anchor="w")
        self.tree.column("dst_info", width=200, anchor="w")
        sb = ttk.Scrollbar(tree_f, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.tag_configure("copy",   foreground="#4fc3f7")
        self.tree.tag_configure("update", foreground="#ffd700")
        self.tree.tag_configure("delete", foreground="#f48771")
        self.tree.tag_configure("same",   foreground="#555")

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)

        self.status_var = tk.StringVar(value="フォルダを選択して差分確認してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _pick(self, var):
        folder = filedialog.askdirectory()
        if folder:
            var.set(folder)

    def _analyze(self):
        src = self.src_var.get().strip()
        dst = self.dst_var.get().strip()
        if not src or not os.path.isdir(src):
            messagebox.showerror("エラー", "ソースフォルダが無効です")
            return
        if not dst:
            messagebox.showerror("エラー", "ターゲットフォルダを指定してください")
            return
        self.status_var.set("差分を分析中...")
        threading.Thread(target=self._do_analyze, args=(src, dst),
                          daemon=True).start()

    def _do_analyze(self, src, dst):
        try:
            diff = self._compute_diff(src, dst)
            self.root.after(0, self._show_diff, diff)
        except Exception as e:
            self.root.after(0, lambda: messagebox.showerror("エラー", str(e)))

    def _compute_diff(self, src, dst):
        diff = []
        src_files = self._walk_rel(src)
        dst_files = self._walk_rel(dst) if os.path.isdir(dst) else {}

        for rel, src_path in src_files.items():
            dst_path = os.path.join(dst, rel)
            if rel not in dst_files:
                diff.append(("COPY", rel, src_path, dst_path))
            elif self._needs_update(src_path, dst_path):
                diff.append(("UPDATE", rel, src_path, dst_path))
            else:
                diff.append(("SAME", rel, src_path, dst_path))

        if self.delete_var.get():
            for rel in dst_files:
                if rel not in src_files:
                    diff.append(("DELETE", rel, "", os.path.join(dst, rel)))

        return diff

    def _walk_rel(self, folder):
        result = {}
        for dirpath, _, filenames in os.walk(folder):
            for fn in filenames:
                full = os.path.join(dirpath, fn)
                rel = os.path.relpath(full, folder)
                result[rel] = full
        return result

    def _needs_update(self, src, dst):
        method = self.compare_var.get()
        try:
            if method == "mtime":
                return os.path.getmtime(src) > os.path.getmtime(dst)
            elif method == "サイズ":
                return os.path.getsize(src) != os.path.getsize(dst)
            elif method == "md5":
                return self._md5(src) != self._md5(dst)
        except Exception:
            return True
        return False

    def _md5(self, path):
        h = hashlib.md5()
        with open(path, "rb") as f:
            for chunk in iter(lambda: f.read(65536), b""):
                h.update(chunk)
        return h.hexdigest()

    def _fmt_file_info(self, path):
        try:
            stat = os.stat(path)
            mtime = datetime.fromtimestamp(stat.st_mtime).strftime("%Y-%m-%d %H:%M")
            size = stat.st_size
            if size < 1024:
                sstr = f"{size}B"
            elif size < 1024**2:
                sstr = f"{size/1024:.1f}KB"
            else:
                sstr = f"{size/1024**2:.1f}MB"
            return f"{mtime}  {sstr}"
        except Exception:
            return ""

    def _show_diff(self, diff):
        self._diff = diff
        self.tree.delete(*self.tree.get_children())
        counts = {"COPY": 0, "UPDATE": 0, "DELETE": 0, "SAME": 0}
        for action, rel, src_path, dst_path in diff:
            counts[action] = counts.get(action, 0) + 1
            src_info = self._fmt_file_info(src_path) if src_path else ""
            dst_info = self._fmt_file_info(dst_path) if os.path.exists(dst_path) else "-"
            tag = action.lower() if action != "UPDATE" else "update"
            self.tree.insert("", tk.END,
                              values=(action, rel, src_info, dst_info),
                              tags=(tag,))
        self.status_var.set(
            f"差分: COPY={counts['COPY']} UPDATE={counts['UPDATE']} "
            f"DELETE={counts['DELETE']} SAME={counts['SAME']}")

    def _sync(self):
        if not self._diff:
            messagebox.showinfo("情報", "先に差分確認を実行してください")
            return
        ops = [(a, r, s, d) for a, r, s, d in self._diff if a != "SAME"]
        if not ops:
            messagebox.showinfo("情報", "同期不要です(すべて最新状態)")
            return
        if not messagebox.askyesno("確認", f"{len(ops)} 件の操作を実行します。\nよろしいですか?"):
            return
        self.progress["maximum"] = len(ops)
        self.progress["value"] = 0
        threading.Thread(target=self._do_sync, args=(ops,),
                          daemon=True).start()

    def _do_sync(self, ops):
        ok = err = 0
        for i, (action, rel, src, dst) in enumerate(ops):
            try:
                if action in ("COPY", "UPDATE"):
                    os.makedirs(os.path.dirname(dst), exist_ok=True)
                    shutil.copy2(src, dst)
                elif action == "DELETE":
                    os.remove(dst)
                ok += 1
            except Exception:
                err += 1
            self.root.after(0, self.progress.configure,
                             {"value": i + 1})
        self.root.after(0, self._sync_done, ok, err)

    def _sync_done(self, ok, err):
        self.status_var.set(f"同期完了: {ok} 件成功 / {err} 件失敗")
        messagebox.showinfo("完了", f"同期が完了しました。\n成功: {ok}  失敗: {err}")
        self._analyze()


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

UIレイアウトの構築

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import os
import shutil
import threading
import hashlib
from datetime import datetime


class App054:
    """フォルダ同期ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("フォルダ同期ツール")
        self.root.geometry("920x600")
        self.root.configure(bg="#1e1e1e")
        self._diff = []
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔄 フォルダ同期ツール",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # フォルダ選択
        folders_f = tk.Frame(self.root, bg="#252526", pady=6)
        folders_f.pack(fill=tk.X, padx=8, pady=4)

        for i, (label, attr) in enumerate([
                ("ソース (コピー元):", "src_var"),
                ("ターゲット (同期先):", "dst_var")]):
            row = tk.Frame(folders_f, bg="#252526")
            row.pack(fill=tk.X, pady=2)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=20, anchor="e").pack(side=tk.LEFT)
            var = tk.StringVar()
            setattr(self, attr, var)
            ttk.Entry(row, textvariable=var, width=50).pack(side=tk.LEFT, padx=4)
            ttk.Button(row, text="参照",
                       command=lambda v=var: self._pick(v)).pack(side=tk.LEFT)

        # オプション
        opt = tk.Frame(self.root, bg="#1e1e1e", pady=2)
        opt.pack(fill=tk.X, padx=8)
        self.delete_var = tk.BooleanVar(value=False)
        tk.Checkbutton(opt, text="ターゲットの余分なファイルを削除",
                       variable=self.delete_var,
                       bg="#1e1e1e", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#1e1e1e").pack(side=tk.LEFT)
        self.compare_var = tk.StringVar(value="mtime")
        tk.Label(opt, text="比較方法:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        ttk.Combobox(opt, textvariable=self.compare_var,
                     values=["mtime", "md5", "サイズ"],
                     state="readonly", width=8).pack(side=tk.LEFT)
        ttk.Button(opt, text="🔍 差分確認",
                   command=self._analyze).pack(side=tk.LEFT, padx=12)
        ttk.Button(opt, text="▶ 同期実行",
                   command=self._sync).pack(side=tk.LEFT)

        # 差分ツリー
        tree_f = tk.Frame(self.root, bg="#1e1e1e")
        tree_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        cols = ("action", "relpath", "src_info", "dst_info")
        self.tree = ttk.Treeview(tree_f, columns=cols, show="headings")
        self.tree.heading("action",   text="操作")
        self.tree.heading("relpath",  text="相対パス")
        self.tree.heading("src_info", text="ソース情報")
        self.tree.heading("dst_info", text="ターゲット情報")
        self.tree.column("action",   width=70,  anchor="center")
        self.tree.column("relpath",  width=320, anchor="w")
        self.tree.column("src_info", width=200, anchor="w")
        self.tree.column("dst_info", width=200, anchor="w")
        sb = ttk.Scrollbar(tree_f, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.tag_configure("copy",   foreground="#4fc3f7")
        self.tree.tag_configure("update", foreground="#ffd700")
        self.tree.tag_configure("delete", foreground="#f48771")
        self.tree.tag_configure("same",   foreground="#555")

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)

        self.status_var = tk.StringVar(value="フォルダを選択して差分確認してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _pick(self, var):
        folder = filedialog.askdirectory()
        if folder:
            var.set(folder)

    def _analyze(self):
        src = self.src_var.get().strip()
        dst = self.dst_var.get().strip()
        if not src or not os.path.isdir(src):
            messagebox.showerror("エラー", "ソースフォルダが無効です")
            return
        if not dst:
            messagebox.showerror("エラー", "ターゲットフォルダを指定してください")
            return
        self.status_var.set("差分を分析中...")
        threading.Thread(target=self._do_analyze, args=(src, dst),
                          daemon=True).start()

    def _do_analyze(self, src, dst):
        try:
            diff = self._compute_diff(src, dst)
            self.root.after(0, self._show_diff, diff)
        except Exception as e:
            self.root.after(0, lambda: messagebox.showerror("エラー", str(e)))

    def _compute_diff(self, src, dst):
        diff = []
        src_files = self._walk_rel(src)
        dst_files = self._walk_rel(dst) if os.path.isdir(dst) else {}

        for rel, src_path in src_files.items():
            dst_path = os.path.join(dst, rel)
            if rel not in dst_files:
                diff.append(("COPY", rel, src_path, dst_path))
            elif self._needs_update(src_path, dst_path):
                diff.append(("UPDATE", rel, src_path, dst_path))
            else:
                diff.append(("SAME", rel, src_path, dst_path))

        if self.delete_var.get():
            for rel in dst_files:
                if rel not in src_files:
                    diff.append(("DELETE", rel, "", os.path.join(dst, rel)))

        return diff

    def _walk_rel(self, folder):
        result = {}
        for dirpath, _, filenames in os.walk(folder):
            for fn in filenames:
                full = os.path.join(dirpath, fn)
                rel = os.path.relpath(full, folder)
                result[rel] = full
        return result

    def _needs_update(self, src, dst):
        method = self.compare_var.get()
        try:
            if method == "mtime":
                return os.path.getmtime(src) > os.path.getmtime(dst)
            elif method == "サイズ":
                return os.path.getsize(src) != os.path.getsize(dst)
            elif method == "md5":
                return self._md5(src) != self._md5(dst)
        except Exception:
            return True
        return False

    def _md5(self, path):
        h = hashlib.md5()
        with open(path, "rb") as f:
            for chunk in iter(lambda: f.read(65536), b""):
                h.update(chunk)
        return h.hexdigest()

    def _fmt_file_info(self, path):
        try:
            stat = os.stat(path)
            mtime = datetime.fromtimestamp(stat.st_mtime).strftime("%Y-%m-%d %H:%M")
            size = stat.st_size
            if size < 1024:
                sstr = f"{size}B"
            elif size < 1024**2:
                sstr = f"{size/1024:.1f}KB"
            else:
                sstr = f"{size/1024**2:.1f}MB"
            return f"{mtime}  {sstr}"
        except Exception:
            return ""

    def _show_diff(self, diff):
        self._diff = diff
        self.tree.delete(*self.tree.get_children())
        counts = {"COPY": 0, "UPDATE": 0, "DELETE": 0, "SAME": 0}
        for action, rel, src_path, dst_path in diff:
            counts[action] = counts.get(action, 0) + 1
            src_info = self._fmt_file_info(src_path) if src_path else ""
            dst_info = self._fmt_file_info(dst_path) if os.path.exists(dst_path) else "-"
            tag = action.lower() if action != "UPDATE" else "update"
            self.tree.insert("", tk.END,
                              values=(action, rel, src_info, dst_info),
                              tags=(tag,))
        self.status_var.set(
            f"差分: COPY={counts['COPY']} UPDATE={counts['UPDATE']} "
            f"DELETE={counts['DELETE']} SAME={counts['SAME']}")

    def _sync(self):
        if not self._diff:
            messagebox.showinfo("情報", "先に差分確認を実行してください")
            return
        ops = [(a, r, s, d) for a, r, s, d in self._diff if a != "SAME"]
        if not ops:
            messagebox.showinfo("情報", "同期不要です(すべて最新状態)")
            return
        if not messagebox.askyesno("確認", f"{len(ops)} 件の操作を実行します。\nよろしいですか?"):
            return
        self.progress["maximum"] = len(ops)
        self.progress["value"] = 0
        threading.Thread(target=self._do_sync, args=(ops,),
                          daemon=True).start()

    def _do_sync(self, ops):
        ok = err = 0
        for i, (action, rel, src, dst) in enumerate(ops):
            try:
                if action in ("COPY", "UPDATE"):
                    os.makedirs(os.path.dirname(dst), exist_ok=True)
                    shutil.copy2(src, dst)
                elif action == "DELETE":
                    os.remove(dst)
                ok += 1
            except Exception:
                err += 1
            self.root.after(0, self.progress.configure,
                             {"value": i + 1})
        self.root.after(0, self._sync_done, ok, err)

    def _sync_done(self, ok, err):
        self.status_var.set(f"同期完了: {ok} 件成功 / {err} 件失敗")
        messagebox.showinfo("完了", f"同期が完了しました。\n成功: {ok}  失敗: {err}")
        self._analyze()


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

イベント処理

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import os
import shutil
import threading
import hashlib
from datetime import datetime


class App054:
    """フォルダ同期ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("フォルダ同期ツール")
        self.root.geometry("920x600")
        self.root.configure(bg="#1e1e1e")
        self._diff = []
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔄 フォルダ同期ツール",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # フォルダ選択
        folders_f = tk.Frame(self.root, bg="#252526", pady=6)
        folders_f.pack(fill=tk.X, padx=8, pady=4)

        for i, (label, attr) in enumerate([
                ("ソース (コピー元):", "src_var"),
                ("ターゲット (同期先):", "dst_var")]):
            row = tk.Frame(folders_f, bg="#252526")
            row.pack(fill=tk.X, pady=2)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=20, anchor="e").pack(side=tk.LEFT)
            var = tk.StringVar()
            setattr(self, attr, var)
            ttk.Entry(row, textvariable=var, width=50).pack(side=tk.LEFT, padx=4)
            ttk.Button(row, text="参照",
                       command=lambda v=var: self._pick(v)).pack(side=tk.LEFT)

        # オプション
        opt = tk.Frame(self.root, bg="#1e1e1e", pady=2)
        opt.pack(fill=tk.X, padx=8)
        self.delete_var = tk.BooleanVar(value=False)
        tk.Checkbutton(opt, text="ターゲットの余分なファイルを削除",
                       variable=self.delete_var,
                       bg="#1e1e1e", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#1e1e1e").pack(side=tk.LEFT)
        self.compare_var = tk.StringVar(value="mtime")
        tk.Label(opt, text="比較方法:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        ttk.Combobox(opt, textvariable=self.compare_var,
                     values=["mtime", "md5", "サイズ"],
                     state="readonly", width=8).pack(side=tk.LEFT)
        ttk.Button(opt, text="🔍 差分確認",
                   command=self._analyze).pack(side=tk.LEFT, padx=12)
        ttk.Button(opt, text="▶ 同期実行",
                   command=self._sync).pack(side=tk.LEFT)

        # 差分ツリー
        tree_f = tk.Frame(self.root, bg="#1e1e1e")
        tree_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        cols = ("action", "relpath", "src_info", "dst_info")
        self.tree = ttk.Treeview(tree_f, columns=cols, show="headings")
        self.tree.heading("action",   text="操作")
        self.tree.heading("relpath",  text="相対パス")
        self.tree.heading("src_info", text="ソース情報")
        self.tree.heading("dst_info", text="ターゲット情報")
        self.tree.column("action",   width=70,  anchor="center")
        self.tree.column("relpath",  width=320, anchor="w")
        self.tree.column("src_info", width=200, anchor="w")
        self.tree.column("dst_info", width=200, anchor="w")
        sb = ttk.Scrollbar(tree_f, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.tag_configure("copy",   foreground="#4fc3f7")
        self.tree.tag_configure("update", foreground="#ffd700")
        self.tree.tag_configure("delete", foreground="#f48771")
        self.tree.tag_configure("same",   foreground="#555")

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)

        self.status_var = tk.StringVar(value="フォルダを選択して差分確認してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _pick(self, var):
        folder = filedialog.askdirectory()
        if folder:
            var.set(folder)

    def _analyze(self):
        src = self.src_var.get().strip()
        dst = self.dst_var.get().strip()
        if not src or not os.path.isdir(src):
            messagebox.showerror("エラー", "ソースフォルダが無効です")
            return
        if not dst:
            messagebox.showerror("エラー", "ターゲットフォルダを指定してください")
            return
        self.status_var.set("差分を分析中...")
        threading.Thread(target=self._do_analyze, args=(src, dst),
                          daemon=True).start()

    def _do_analyze(self, src, dst):
        try:
            diff = self._compute_diff(src, dst)
            self.root.after(0, self._show_diff, diff)
        except Exception as e:
            self.root.after(0, lambda: messagebox.showerror("エラー", str(e)))

    def _compute_diff(self, src, dst):
        diff = []
        src_files = self._walk_rel(src)
        dst_files = self._walk_rel(dst) if os.path.isdir(dst) else {}

        for rel, src_path in src_files.items():
            dst_path = os.path.join(dst, rel)
            if rel not in dst_files:
                diff.append(("COPY", rel, src_path, dst_path))
            elif self._needs_update(src_path, dst_path):
                diff.append(("UPDATE", rel, src_path, dst_path))
            else:
                diff.append(("SAME", rel, src_path, dst_path))

        if self.delete_var.get():
            for rel in dst_files:
                if rel not in src_files:
                    diff.append(("DELETE", rel, "", os.path.join(dst, rel)))

        return diff

    def _walk_rel(self, folder):
        result = {}
        for dirpath, _, filenames in os.walk(folder):
            for fn in filenames:
                full = os.path.join(dirpath, fn)
                rel = os.path.relpath(full, folder)
                result[rel] = full
        return result

    def _needs_update(self, src, dst):
        method = self.compare_var.get()
        try:
            if method == "mtime":
                return os.path.getmtime(src) > os.path.getmtime(dst)
            elif method == "サイズ":
                return os.path.getsize(src) != os.path.getsize(dst)
            elif method == "md5":
                return self._md5(src) != self._md5(dst)
        except Exception:
            return True
        return False

    def _md5(self, path):
        h = hashlib.md5()
        with open(path, "rb") as f:
            for chunk in iter(lambda: f.read(65536), b""):
                h.update(chunk)
        return h.hexdigest()

    def _fmt_file_info(self, path):
        try:
            stat = os.stat(path)
            mtime = datetime.fromtimestamp(stat.st_mtime).strftime("%Y-%m-%d %H:%M")
            size = stat.st_size
            if size < 1024:
                sstr = f"{size}B"
            elif size < 1024**2:
                sstr = f"{size/1024:.1f}KB"
            else:
                sstr = f"{size/1024**2:.1f}MB"
            return f"{mtime}  {sstr}"
        except Exception:
            return ""

    def _show_diff(self, diff):
        self._diff = diff
        self.tree.delete(*self.tree.get_children())
        counts = {"COPY": 0, "UPDATE": 0, "DELETE": 0, "SAME": 0}
        for action, rel, src_path, dst_path in diff:
            counts[action] = counts.get(action, 0) + 1
            src_info = self._fmt_file_info(src_path) if src_path else ""
            dst_info = self._fmt_file_info(dst_path) if os.path.exists(dst_path) else "-"
            tag = action.lower() if action != "UPDATE" else "update"
            self.tree.insert("", tk.END,
                              values=(action, rel, src_info, dst_info),
                              tags=(tag,))
        self.status_var.set(
            f"差分: COPY={counts['COPY']} UPDATE={counts['UPDATE']} "
            f"DELETE={counts['DELETE']} SAME={counts['SAME']}")

    def _sync(self):
        if not self._diff:
            messagebox.showinfo("情報", "先に差分確認を実行してください")
            return
        ops = [(a, r, s, d) for a, r, s, d in self._diff if a != "SAME"]
        if not ops:
            messagebox.showinfo("情報", "同期不要です(すべて最新状態)")
            return
        if not messagebox.askyesno("確認", f"{len(ops)} 件の操作を実行します。\nよろしいですか?"):
            return
        self.progress["maximum"] = len(ops)
        self.progress["value"] = 0
        threading.Thread(target=self._do_sync, args=(ops,),
                          daemon=True).start()

    def _do_sync(self, ops):
        ok = err = 0
        for i, (action, rel, src, dst) in enumerate(ops):
            try:
                if action in ("COPY", "UPDATE"):
                    os.makedirs(os.path.dirname(dst), exist_ok=True)
                    shutil.copy2(src, dst)
                elif action == "DELETE":
                    os.remove(dst)
                ok += 1
            except Exception:
                err += 1
            self.root.after(0, self.progress.configure,
                             {"value": i + 1})
        self.root.after(0, self._sync_done, ok, err)

    def _sync_done(self, ok, err):
        self.status_var.set(f"同期完了: {ok} 件成功 / {err} 件失敗")
        messagebox.showinfo("完了", f"同期が完了しました。\n成功: {ok}  失敗: {err}")
        self._analyze()


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

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

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import os
import shutil
import threading
import hashlib
from datetime import datetime


class App054:
    """フォルダ同期ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("フォルダ同期ツール")
        self.root.geometry("920x600")
        self.root.configure(bg="#1e1e1e")
        self._diff = []
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔄 フォルダ同期ツール",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # フォルダ選択
        folders_f = tk.Frame(self.root, bg="#252526", pady=6)
        folders_f.pack(fill=tk.X, padx=8, pady=4)

        for i, (label, attr) in enumerate([
                ("ソース (コピー元):", "src_var"),
                ("ターゲット (同期先):", "dst_var")]):
            row = tk.Frame(folders_f, bg="#252526")
            row.pack(fill=tk.X, pady=2)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=20, anchor="e").pack(side=tk.LEFT)
            var = tk.StringVar()
            setattr(self, attr, var)
            ttk.Entry(row, textvariable=var, width=50).pack(side=tk.LEFT, padx=4)
            ttk.Button(row, text="参照",
                       command=lambda v=var: self._pick(v)).pack(side=tk.LEFT)

        # オプション
        opt = tk.Frame(self.root, bg="#1e1e1e", pady=2)
        opt.pack(fill=tk.X, padx=8)
        self.delete_var = tk.BooleanVar(value=False)
        tk.Checkbutton(opt, text="ターゲットの余分なファイルを削除",
                       variable=self.delete_var,
                       bg="#1e1e1e", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#1e1e1e").pack(side=tk.LEFT)
        self.compare_var = tk.StringVar(value="mtime")
        tk.Label(opt, text="比較方法:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        ttk.Combobox(opt, textvariable=self.compare_var,
                     values=["mtime", "md5", "サイズ"],
                     state="readonly", width=8).pack(side=tk.LEFT)
        ttk.Button(opt, text="🔍 差分確認",
                   command=self._analyze).pack(side=tk.LEFT, padx=12)
        ttk.Button(opt, text="▶ 同期実行",
                   command=self._sync).pack(side=tk.LEFT)

        # 差分ツリー
        tree_f = tk.Frame(self.root, bg="#1e1e1e")
        tree_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        cols = ("action", "relpath", "src_info", "dst_info")
        self.tree = ttk.Treeview(tree_f, columns=cols, show="headings")
        self.tree.heading("action",   text="操作")
        self.tree.heading("relpath",  text="相対パス")
        self.tree.heading("src_info", text="ソース情報")
        self.tree.heading("dst_info", text="ターゲット情報")
        self.tree.column("action",   width=70,  anchor="center")
        self.tree.column("relpath",  width=320, anchor="w")
        self.tree.column("src_info", width=200, anchor="w")
        self.tree.column("dst_info", width=200, anchor="w")
        sb = ttk.Scrollbar(tree_f, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.tag_configure("copy",   foreground="#4fc3f7")
        self.tree.tag_configure("update", foreground="#ffd700")
        self.tree.tag_configure("delete", foreground="#f48771")
        self.tree.tag_configure("same",   foreground="#555")

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)

        self.status_var = tk.StringVar(value="フォルダを選択して差分確認してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _pick(self, var):
        folder = filedialog.askdirectory()
        if folder:
            var.set(folder)

    def _analyze(self):
        src = self.src_var.get().strip()
        dst = self.dst_var.get().strip()
        if not src or not os.path.isdir(src):
            messagebox.showerror("エラー", "ソースフォルダが無効です")
            return
        if not dst:
            messagebox.showerror("エラー", "ターゲットフォルダを指定してください")
            return
        self.status_var.set("差分を分析中...")
        threading.Thread(target=self._do_analyze, args=(src, dst),
                          daemon=True).start()

    def _do_analyze(self, src, dst):
        try:
            diff = self._compute_diff(src, dst)
            self.root.after(0, self._show_diff, diff)
        except Exception as e:
            self.root.after(0, lambda: messagebox.showerror("エラー", str(e)))

    def _compute_diff(self, src, dst):
        diff = []
        src_files = self._walk_rel(src)
        dst_files = self._walk_rel(dst) if os.path.isdir(dst) else {}

        for rel, src_path in src_files.items():
            dst_path = os.path.join(dst, rel)
            if rel not in dst_files:
                diff.append(("COPY", rel, src_path, dst_path))
            elif self._needs_update(src_path, dst_path):
                diff.append(("UPDATE", rel, src_path, dst_path))
            else:
                diff.append(("SAME", rel, src_path, dst_path))

        if self.delete_var.get():
            for rel in dst_files:
                if rel not in src_files:
                    diff.append(("DELETE", rel, "", os.path.join(dst, rel)))

        return diff

    def _walk_rel(self, folder):
        result = {}
        for dirpath, _, filenames in os.walk(folder):
            for fn in filenames:
                full = os.path.join(dirpath, fn)
                rel = os.path.relpath(full, folder)
                result[rel] = full
        return result

    def _needs_update(self, src, dst):
        method = self.compare_var.get()
        try:
            if method == "mtime":
                return os.path.getmtime(src) > os.path.getmtime(dst)
            elif method == "サイズ":
                return os.path.getsize(src) != os.path.getsize(dst)
            elif method == "md5":
                return self._md5(src) != self._md5(dst)
        except Exception:
            return True
        return False

    def _md5(self, path):
        h = hashlib.md5()
        with open(path, "rb") as f:
            for chunk in iter(lambda: f.read(65536), b""):
                h.update(chunk)
        return h.hexdigest()

    def _fmt_file_info(self, path):
        try:
            stat = os.stat(path)
            mtime = datetime.fromtimestamp(stat.st_mtime).strftime("%Y-%m-%d %H:%M")
            size = stat.st_size
            if size < 1024:
                sstr = f"{size}B"
            elif size < 1024**2:
                sstr = f"{size/1024:.1f}KB"
            else:
                sstr = f"{size/1024**2:.1f}MB"
            return f"{mtime}  {sstr}"
        except Exception:
            return ""

    def _show_diff(self, diff):
        self._diff = diff
        self.tree.delete(*self.tree.get_children())
        counts = {"COPY": 0, "UPDATE": 0, "DELETE": 0, "SAME": 0}
        for action, rel, src_path, dst_path in diff:
            counts[action] = counts.get(action, 0) + 1
            src_info = self._fmt_file_info(src_path) if src_path else ""
            dst_info = self._fmt_file_info(dst_path) if os.path.exists(dst_path) else "-"
            tag = action.lower() if action != "UPDATE" else "update"
            self.tree.insert("", tk.END,
                              values=(action, rel, src_info, dst_info),
                              tags=(tag,))
        self.status_var.set(
            f"差分: COPY={counts['COPY']} UPDATE={counts['UPDATE']} "
            f"DELETE={counts['DELETE']} SAME={counts['SAME']}")

    def _sync(self):
        if not self._diff:
            messagebox.showinfo("情報", "先に差分確認を実行してください")
            return
        ops = [(a, r, s, d) for a, r, s, d in self._diff if a != "SAME"]
        if not ops:
            messagebox.showinfo("情報", "同期不要です(すべて最新状態)")
            return
        if not messagebox.askyesno("確認", f"{len(ops)} 件の操作を実行します。\nよろしいですか?"):
            return
        self.progress["maximum"] = len(ops)
        self.progress["value"] = 0
        threading.Thread(target=self._do_sync, args=(ops,),
                          daemon=True).start()

    def _do_sync(self, ops):
        ok = err = 0
        for i, (action, rel, src, dst) in enumerate(ops):
            try:
                if action in ("COPY", "UPDATE"):
                    os.makedirs(os.path.dirname(dst), exist_ok=True)
                    shutil.copy2(src, dst)
                elif action == "DELETE":
                    os.remove(dst)
                ok += 1
            except Exception:
                err += 1
            self.root.after(0, self.progress.configure,
                             {"value": i + 1})
        self.root.after(0, self._sync_done, ok, err)

    def _sync_done(self, ok, err):
        self.status_var.set(f"同期完了: {ok} 件成功 / {err} 件失敗")
        messagebox.showinfo("完了", f"同期が完了しました。\n成功: {ok}  失敗: {err}")
        self._analyze()


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

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

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import os
import shutil
import threading
import hashlib
from datetime import datetime


class App054:
    """フォルダ同期ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("フォルダ同期ツール")
        self.root.geometry("920x600")
        self.root.configure(bg="#1e1e1e")
        self._diff = []
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔄 フォルダ同期ツール",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # フォルダ選択
        folders_f = tk.Frame(self.root, bg="#252526", pady=6)
        folders_f.pack(fill=tk.X, padx=8, pady=4)

        for i, (label, attr) in enumerate([
                ("ソース (コピー元):", "src_var"),
                ("ターゲット (同期先):", "dst_var")]):
            row = tk.Frame(folders_f, bg="#252526")
            row.pack(fill=tk.X, pady=2)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=20, anchor="e").pack(side=tk.LEFT)
            var = tk.StringVar()
            setattr(self, attr, var)
            ttk.Entry(row, textvariable=var, width=50).pack(side=tk.LEFT, padx=4)
            ttk.Button(row, text="参照",
                       command=lambda v=var: self._pick(v)).pack(side=tk.LEFT)

        # オプション
        opt = tk.Frame(self.root, bg="#1e1e1e", pady=2)
        opt.pack(fill=tk.X, padx=8)
        self.delete_var = tk.BooleanVar(value=False)
        tk.Checkbutton(opt, text="ターゲットの余分なファイルを削除",
                       variable=self.delete_var,
                       bg="#1e1e1e", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#1e1e1e").pack(side=tk.LEFT)
        self.compare_var = tk.StringVar(value="mtime")
        tk.Label(opt, text="比較方法:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        ttk.Combobox(opt, textvariable=self.compare_var,
                     values=["mtime", "md5", "サイズ"],
                     state="readonly", width=8).pack(side=tk.LEFT)
        ttk.Button(opt, text="🔍 差分確認",
                   command=self._analyze).pack(side=tk.LEFT, padx=12)
        ttk.Button(opt, text="▶ 同期実行",
                   command=self._sync).pack(side=tk.LEFT)

        # 差分ツリー
        tree_f = tk.Frame(self.root, bg="#1e1e1e")
        tree_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        cols = ("action", "relpath", "src_info", "dst_info")
        self.tree = ttk.Treeview(tree_f, columns=cols, show="headings")
        self.tree.heading("action",   text="操作")
        self.tree.heading("relpath",  text="相対パス")
        self.tree.heading("src_info", text="ソース情報")
        self.tree.heading("dst_info", text="ターゲット情報")
        self.tree.column("action",   width=70,  anchor="center")
        self.tree.column("relpath",  width=320, anchor="w")
        self.tree.column("src_info", width=200, anchor="w")
        self.tree.column("dst_info", width=200, anchor="w")
        sb = ttk.Scrollbar(tree_f, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.tag_configure("copy",   foreground="#4fc3f7")
        self.tree.tag_configure("update", foreground="#ffd700")
        self.tree.tag_configure("delete", foreground="#f48771")
        self.tree.tag_configure("same",   foreground="#555")

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)

        self.status_var = tk.StringVar(value="フォルダを選択して差分確認してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _pick(self, var):
        folder = filedialog.askdirectory()
        if folder:
            var.set(folder)

    def _analyze(self):
        src = self.src_var.get().strip()
        dst = self.dst_var.get().strip()
        if not src or not os.path.isdir(src):
            messagebox.showerror("エラー", "ソースフォルダが無効です")
            return
        if not dst:
            messagebox.showerror("エラー", "ターゲットフォルダを指定してください")
            return
        self.status_var.set("差分を分析中...")
        threading.Thread(target=self._do_analyze, args=(src, dst),
                          daemon=True).start()

    def _do_analyze(self, src, dst):
        try:
            diff = self._compute_diff(src, dst)
            self.root.after(0, self._show_diff, diff)
        except Exception as e:
            self.root.after(0, lambda: messagebox.showerror("エラー", str(e)))

    def _compute_diff(self, src, dst):
        diff = []
        src_files = self._walk_rel(src)
        dst_files = self._walk_rel(dst) if os.path.isdir(dst) else {}

        for rel, src_path in src_files.items():
            dst_path = os.path.join(dst, rel)
            if rel not in dst_files:
                diff.append(("COPY", rel, src_path, dst_path))
            elif self._needs_update(src_path, dst_path):
                diff.append(("UPDATE", rel, src_path, dst_path))
            else:
                diff.append(("SAME", rel, src_path, dst_path))

        if self.delete_var.get():
            for rel in dst_files:
                if rel not in src_files:
                    diff.append(("DELETE", rel, "", os.path.join(dst, rel)))

        return diff

    def _walk_rel(self, folder):
        result = {}
        for dirpath, _, filenames in os.walk(folder):
            for fn in filenames:
                full = os.path.join(dirpath, fn)
                rel = os.path.relpath(full, folder)
                result[rel] = full
        return result

    def _needs_update(self, src, dst):
        method = self.compare_var.get()
        try:
            if method == "mtime":
                return os.path.getmtime(src) > os.path.getmtime(dst)
            elif method == "サイズ":
                return os.path.getsize(src) != os.path.getsize(dst)
            elif method == "md5":
                return self._md5(src) != self._md5(dst)
        except Exception:
            return True
        return False

    def _md5(self, path):
        h = hashlib.md5()
        with open(path, "rb") as f:
            for chunk in iter(lambda: f.read(65536), b""):
                h.update(chunk)
        return h.hexdigest()

    def _fmt_file_info(self, path):
        try:
            stat = os.stat(path)
            mtime = datetime.fromtimestamp(stat.st_mtime).strftime("%Y-%m-%d %H:%M")
            size = stat.st_size
            if size < 1024:
                sstr = f"{size}B"
            elif size < 1024**2:
                sstr = f"{size/1024:.1f}KB"
            else:
                sstr = f"{size/1024**2:.1f}MB"
            return f"{mtime}  {sstr}"
        except Exception:
            return ""

    def _show_diff(self, diff):
        self._diff = diff
        self.tree.delete(*self.tree.get_children())
        counts = {"COPY": 0, "UPDATE": 0, "DELETE": 0, "SAME": 0}
        for action, rel, src_path, dst_path in diff:
            counts[action] = counts.get(action, 0) + 1
            src_info = self._fmt_file_info(src_path) if src_path else ""
            dst_info = self._fmt_file_info(dst_path) if os.path.exists(dst_path) else "-"
            tag = action.lower() if action != "UPDATE" else "update"
            self.tree.insert("", tk.END,
                              values=(action, rel, src_info, dst_info),
                              tags=(tag,))
        self.status_var.set(
            f"差分: COPY={counts['COPY']} UPDATE={counts['UPDATE']} "
            f"DELETE={counts['DELETE']} SAME={counts['SAME']}")

    def _sync(self):
        if not self._diff:
            messagebox.showinfo("情報", "先に差分確認を実行してください")
            return
        ops = [(a, r, s, d) for a, r, s, d in self._diff if a != "SAME"]
        if not ops:
            messagebox.showinfo("情報", "同期不要です(すべて最新状態)")
            return
        if not messagebox.askyesno("確認", f"{len(ops)} 件の操作を実行します。\nよろしいですか?"):
            return
        self.progress["maximum"] = len(ops)
        self.progress["value"] = 0
        threading.Thread(target=self._do_sync, args=(ops,),
                          daemon=True).start()

    def _do_sync(self, ops):
        ok = err = 0
        for i, (action, rel, src, dst) in enumerate(ops):
            try:
                if action in ("COPY", "UPDATE"):
                    os.makedirs(os.path.dirname(dst), exist_ok=True)
                    shutil.copy2(src, dst)
                elif action == "DELETE":
                    os.remove(dst)
                ok += 1
            except Exception:
                err += 1
            self.root.after(0, self.progress.configure,
                             {"value": i + 1})
        self.root.after(0, self._sync_done, ok, err)

    def _sync_done(self, ok, err):
        self.status_var.set(f"同期完了: {ok} 件成功 / {err} 件失敗")
        messagebox.showinfo("完了", f"同期が完了しました。\n成功: {ok}  失敗: {err}")
        self._analyze()


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

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

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

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

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

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

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

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

🚀
次に挑戦するアプリ

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