テキスト整形ツール

1. アプリ概要

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

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

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

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

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

2. 機能一覧

• ループで生成するボタン群を apply() に接続
• 「結果を入力欄にコピー」ボタン（copy_back()）・「クリア」ボタン（clear()）で操作
• messagebox.showerror()・messagebox.showwarning() によるダイアログ通知
• ウィンドウはタイトル「テキスト整形ツール」・サイズ 750x600 で起動

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 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. コード解説

テキスト整形ツール: 大小文字変換、空白除去、行番号付与などのコードを、実際に書かれている実装に沿って解説します。

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

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

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

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

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

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

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

   title("テキスト整形ツール")・geometry("750x600")・configure(bg="#f8f9fc") をコンストラクタで設定します。

4. 4
   画面部品を並べる

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

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

   「2. 機能一覧」で挙げた各ボタンを command= で対応するメソッド（copy_back()・clear()）につなぎます。ループ生成のボタンは command=lambda f=func: self.apply(f) の形で接続します。

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

   アプリの本体である apply()（13行）・copy_back()（7行）・clear()（4行） を実装します。

7. 7
   動作確認する

   python app089.py で起動し、各ボタンが反応することを確認します。

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

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。

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

9. 練習問題

アプリの理解を深めるための練習問題です。気になるものから挑戦してみてください（課題3は定型の発展課題です）。どちらの課題も、入力欄に3〜4行の文字を打って整形ボタンを押すだけで確かめられます。

1. 課題1：重複行削除で大文字と小文字の違いを無視する

   いまの「重複行削除」は、文字がぴったり同じ行しかまとめません。Apple と apple のように大小の違いしかない行も1行にまとめましょう。

   期待結果：入力欄に Apple・apple・APPLE・banana の4行を入れて「重複行削除」を押すと、結果欄が Apple と banana の2行になる。いまは4行がそのまま残る

   合格条件

   • 残るのは最初に出てきた行の見た目のまま（Apple が小文字にならない）
   • 行の並び順は変わらない
   • まったく違う行（banana）は今までどおり残る

   ヒント①（どこを触るか）: 触るのは1か所です。_remove_duplicates() の for ループの中です。
   ヒント②（使うもの）: 比べる用の値を key = line.lower() として作り、if key not in seen: と seen.add(key) の2行で使います。result.append(line) のほうは元の line のままにして、見た目を残します。
   つまずきやすい点: result.append(line.lower()) にすると、残った行まで小文字になって元の表記が失われます。また if key not in seen: だけ直して seen.add(line) を元のままにすると、集合に入るのは Apple と apple の2つになります。消えるのは APPLE だけという中途半端な結果になり、エラーも出ません。

2. 課題2：整形メニューに「空白をまとめる」を追加する

   いまのボタンは10個あり、空白は「全部消す」か「行の前後を削る」しか選べません。続いた空白を1つにまとめるボタンを足しましょう。

   期待結果：新しいボタンを押すと、a　　b c（全角の空白2つと半角の空白3つが混ざった行）が a b c になる。ボタンは3段目の左端に増える

   合格条件

   • いまある10個のボタンの動きは変わらない
   • 半角の空白が1つだけの場所は変わらない（全角の空白1つは半角に置き換わる）
   • 空白を含まない行はそのまま残る

   ヒント①（どこを触るか）: 触るのは2か所です。ファイル冒頭の import 行と、_build_ui() の ops = [ のリストです。
   ヒント②（使うもの）: 正規表現を使うので、2行目の from tkinter import ttk, messagebox の下に import re を1行足します。リストにはボタン名と関数のタプルが並んでいるので、いちばん下の「行を逆順」の次に ("空白をまとめる", lambda s: re.sub(r"[ 　]+", " ", s)), を足します。位置は row=i // 5, column=i % 5 で自動的に決まるため、指定は要りません。
   つまずきやすい点: ボタンを作っている command=lambda f=func: self.apply(f) の f=func は、その時点の関数を覚えさせるための書き方です。ここを command=lambda: self.apply(func) に変えると、どのボタンを押しても最後に登録した関数だけが動きます（エラーは出ません）。なお [ 　] は半角と全角の空白を並べたもので、全角側を消すと全角の空白はまとまりません。

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

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