初心者向け No.089

テキスト整形ツール

文章を大文字/小文字変換・スペース除去・行番号付与・重複行削除などで整形するツール。文字列メソッドの実践的な活用を学ぶ。

🎯 難易度: ★☆☆ 易しい 📦 ライブラリ: tkinter ⏱️ 制作時間: 30〜90分

📋 目次

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

1. アプリ概要

文章を大文字/小文字変換・スペース除去・行番号付与・重複行削除などで整形するツール。文字列メソッドの実践的な活用を学ぶ。

このアプリは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. 完全なソースコード

💡

コードのコピー方法

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

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

app089.py

import tkinter as tk
from tkinter import ttk, messagebox


class App089:
    """テキスト整形ツール: 大小文字変換、空白除去、行番号付与など"""

    def __init__(self, root):
        self.root = root
        self.root.title("テキスト整形ツール")
        self.root.geometry("750x600")
        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 = ttk.LabelFrame(main, text="入力テキスト", padding=6)
        input_frame.pack(fill=tk.BOTH, expand=True)
        self.input_text = tk.Text(input_frame, height=8, font=("Consolas", 11))
        self.input_text.pack(fill=tk.BOTH, expand=True)

        # 操作ボタン (整形種別)
        op = ttk.LabelFrame(main, text="整形オプション", padding=8)
        op.pack(fill=tk.X, pady=8)
        ops = [
            ("大文字化", lambda s: s.upper()),
            ("小文字化", lambda s: s.lower()),
            ("先頭大文字", lambda s: s.title()),
            ("空白除去", lambda s: s.replace(" ", "").replace("　", "")),
            ("前後空白トリム", lambda s: "\n".join(line.strip() for line in s.splitlines())),
            ("行番号付与", self._add_line_numbers),
            ("重複行削除", self._remove_duplicates),
            ("空行削除", lambda s: "\n".join(line for line in s.splitlines() if line.strip())),
            ("行の昇順ソート", lambda s: "\n".join(sorted(s.splitlines()))),
            ("行を逆順", lambda s: "\n".join(reversed(s.splitlines()))),
        ]
        for i, (label, func) in enumerate(ops):
            ttk.Button(op, text=label, width=14, command=lambda f=func: self.apply(f)).grid(
                row=i // 5, column=i % 5, padx=4, pady=4, sticky="ew"
            )
        for c in range(5):
            op.columnconfigure(c, weight=1)

        # 結果エリア
        result_frame = ttk.LabelFrame(main, text="整形結果", padding=6)
        result_frame.pack(fill=tk.BOTH, expand=True)
        self.output_text = tk.Text(result_frame, height=8, font=("Consolas", 11), bg="#fafafa")
        self.output_text.pack(fill=tk.BOTH, expand=True)

        # フッターボタン
        btn = tk.Frame(main, bg="#f8f9fc")
        btn.pack(pady=4)
        ttk.Button(btn, text="結果を入力欄にコピー", command=self.copy_back).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="クリア", command=self.clear).pack(side=tk.LEFT, padx=4)

    def _add_line_numbers(self, s):
        """各行に行番号を付与する"""
        lines = s.splitlines()
        if not lines:
            return ""
        width = len(str(len(lines)))
        return "\n".join(f"{i+1:>{width}}: {line}" for i, line in enumerate(lines))

    def _remove_duplicates(self, s):
        """順序を保ったまま重複行を削除する"""
        seen = set()
        result = []
        for line in s.splitlines():
            if line not in seen:
                seen.add(line)
                result.append(line)
        return "\n".join(result)

    def apply(self, func):
        """指定された整形関数を入力テキストに適用する"""
        src = self.input_text.get("1.0", tk.END).rstrip("\n")
        if not src:
            messagebox.showwarning("警告", "整形するテキストを入力してください")
            return
        try:
            result = func(src)
        except Exception as e:
            messagebox.showerror("エラー", f"処理に失敗しました: {e}")
            return
        self.output_text.delete("1.0", tk.END)
        self.output_text.insert("1.0", result)

    def copy_back(self):
        """結果欄の内容を入力欄にコピーする"""
        result = self.output_text.get("1.0", tk.END).rstrip("\n")
        if not result:
            return
        self.input_text.delete("1.0", tk.END)
        self.input_text.insert("1.0", result)

    def clear(self):
        """両方のテキストエリアをクリアする"""
        self.input_text.delete("1.0", tk.END)
        self.output_text.delete("1.0", tk.END)


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

5. コード解説

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

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

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