初心者向け No.094

フォルダ整理提案

フォルダのファイルを拡張子別に分類し整理先構成を提案・実行するアプリ。os/shutilモジュール活用。

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

📋 目次

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

1. アプリ概要

フォルダのファイルを拡張子別に分類し整理先構成を提案・実行するアプリ。os/shutilモジュール活用。

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

このアプリは「整理ツール」カテゴリです。整理・分類系のツールはデータ構造とユーザー操作を結びつける書き方を学ぶ好機です。設計次第で書きやすさが大きく変わります。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

完成形を見てから細部の解説に進む流れが効果的です。実行→気になる箇所を解説で確認→自分の手で改造、というサイクルで定着が早まります。

カスタマイズ章では具体的な拡張アイデアを示しています。一つ実装するごとに動作確認することで、変更が予期せぬ副作用を起こさないかも体感できます。

2. 機能一覧

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

3. 事前準備・環境

ℹ️

動作確認環境

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

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

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

4. 完全なソースコード

💡

コードのコピー方法

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

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

app094.py

import os
import shutil
import tkinter as tk
from collections import defaultdict
from tkinter import filedialog, messagebox, ttk


# 拡張子からカテゴリへのマッピング
CATEGORY_MAP = {
    "画像": {".jpg", ".jpeg", ".png", ".gif", ".bmp", ".webp", ".svg", ".tiff"},
    "動画": {".mp4", ".mov", ".avi", ".mkv", ".wmv", ".flv", ".webm"},
    "音声": {".mp3", ".wav", ".flac", ".aac", ".ogg", ".m4a"},
    "文書": {".pdf", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx", ".txt", ".md", ".rtf"},
    "アーカイブ": {".zip", ".rar", ".7z", ".tar", ".gz", ".bz2"},
    "コード": {".py", ".js", ".ts", ".html", ".css", ".java", ".c", ".cpp", ".rb", ".go", ".rs"},
    "実行ファイル": {".exe", ".msi", ".dmg", ".app", ".sh", ".bat"},
}


def categorize(ext: str) -> str:
    """拡張子をカテゴリ名に変換する"""
    ext = ext.lower()
    for cat, exts in CATEGORY_MAP.items():
        if ext in exts:
            return cat
    return "その他"


class App094:
    """フォルダ整理提案"""

    def __init__(self, root):
        self.root = root
        self.root.title("フォルダ整理提案")
        self.root.geometry("680x520")
        self.root.configure(bg="#f8f9fc")
        self.target_dir = ""
        self.plan = {}
        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_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=20)
        main_frame.pack(fill=tk.BOTH, expand=True)

        ctrl_frame = ttk.LabelFrame(main_frame, text="操作パネル", padding=10)
        ctrl_frame.pack(fill=tk.X, pady=(0, 10))

        tk.Label(ctrl_frame, text="対象フォルダ:").grid(row=0, column=0, sticky="w")
        self.path_var = tk.StringVar()
        ttk.Entry(ctrl_frame, textvariable=self.path_var, width=50).grid(row=0, column=1, padx=8, sticky="ew")
        ttk.Button(ctrl_frame, text="参照...", command=self._choose_dir).grid(row=0, column=2, padx=4)
        ctrl_frame.columnconfigure(1, weight=1)

        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(pady=8)
        ttk.Button(btn_frame, text="整理プランを提案", command=self.propose).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn_frame, text="プランを実行", command=self.execute_plan).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn_frame, text="クリア", command=self.clear).pack(side=tk.LEFT, padx=4)

        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)
        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)

    def _choose_dir(self):
        """フォルダ選択ダイアログを開く"""
        path = filedialog.askdirectory(title="整理したいフォルダを選択")
        if path:
            self.path_var.set(path)

    def propose(self):
        """整理プランを作成する"""
        path = self.path_var.get().strip()
        if not path:
            messagebox.showwarning("警告", "フォルダを選択してください")
            return
        if not os.path.isdir(path):
            messagebox.showerror("エラー", "指定パスはフォルダではありません")
            return
        try:
            self.target_dir = path
            self.plan = self._build_plan(path)
            self._show_plan()
        except PermissionError as e:
            messagebox.showerror("エラー", f"アクセス権限がありません: {e}")
        except Exception as e:
            messagebox.showerror("エラー", f"予期しないエラー: {e}")

    def _build_plan(self, path):
        """カテゴリごとに移動元ファイルを収集する"""
        plan = defaultdict(list)
        for name in os.listdir(path):
            full = os.path.join(path, name)
            if os.path.isdir(full):
                continue
            ext = os.path.splitext(name)[1]
            cat = categorize(ext)
            plan[cat].append(name)
        return dict(plan)

    def _show_plan(self):
        """プラン内容をテキスト欄に表示する"""
        lines = [f"対象: {self.target_dir}", ""]
        if not self.plan:
            lines.append("整理対象のファイルが見つかりませんでした。")
        else:
            for cat in sorted(self.plan):
                lines.append(f"[{cat}] -> {cat}/  ({len(self.plan[cat])} 件)")
                for name in self.plan[cat][:20]:
                    lines.append(f"    {name}")
                if len(self.plan[cat]) > 20:
                    lines.append(f"    ... 他 {len(self.plan[cat]) - 20} 件")
                lines.append("")
            lines.append("「プランを実行」を押すと上記の通りフォルダを作成して移動します。")
        self._set_text("\n".join(lines))

    def execute_plan(self):
        """プランに従ってファイルを移動する"""
        if not self.plan or not self.target_dir:
            messagebox.showwarning("警告", "先に整理プランを提案してください")
            return
        if not messagebox.askyesno("確認", "プランの内容で実際にファイルを移動しますか？"):
            return
        moved, errors = 0, []
        for cat, files in self.plan.items():
            sub = os.path.join(self.target_dir, cat)
            try:
                os.makedirs(sub, exist_ok=True)
            except OSError as e:
                errors.append(f"{cat}: {e}")
                continue
            for name in files:
                src = os.path.join(self.target_dir, name)
                dst = os.path.join(sub, name)
                try:
                    shutil.move(src, dst)
                    moved += 1
                except (OSError, shutil.Error) as e:
                    errors.append(f"{name}: {e}")
        msg = f"{moved} 件のファイルを移動しました。"
        if errors:
            msg += "\n\nエラー:\n" + "\n".join(errors[:10])
        self._set_text(msg)
        self.plan = {}

    def clear(self):
        """状態をクリアする"""
        self.path_var.set("")
        self.plan = {}
        self.target_dir = ""
        self._set_text("")

    def _set_text(self, text):
        """結果テキストを差し替える"""
        self.result_text.delete("1.0", tk.END)
        self.result_text.insert("1.0", text)


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

5. コード解説

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

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

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