初心者向け No.099

ランダムパスワード生成

文字種・桁数・個数を指定してセキュアなパスワードを生成するツール。secretsモジュールで安全な乱数生成。

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

1. アプリ概要

文字種・桁数・個数を指定してセキュアなパスワードを生成するツール。secretsモジュールで安全な乱数生成。

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

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

コピー&実行で動作確認 → コード解説で構造理解 → カスタマイズで応用、の 3 ステップで進めると、短時間で本質を押さえられます。

アプリを完成させた後は、自分の使い方に合わせて改造するのが学びを定着させる近道です。カスタマイズ章のアイデアを足がかりに、独自機能を一つ追加してみてください。

2. 機能一覧

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

3. 事前準備・環境

ℹ️
動作確認環境

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

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

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

4. 完全なソースコード

💡
コードのコピー方法

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

追加インストール不要(標準ライブラリのみ使用)
app099.py
import tkinter as tk
from tkinter import ttk, messagebox
import secrets
import string


class App099:
    """ランダムパスワード生成(secretsモジュールでセキュア)"""

    def __init__(self, root):
        self.root = root
        self.root.title("ランダムパスワード生成")
        self.root.geometry("620x520")
        self.root.configure(bg="#f8f9fc")
        self._build_ui()

    def _build_ui(self):
        """UIを構築する"""
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=10)
        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)

        opt_frame = ttk.LabelFrame(main_frame, text="オプション", padding=10)
        opt_frame.pack(fill=tk.X, pady=(0, 10))

        # 文字種チェック
        self.use_lower = tk.BooleanVar(value=True)
        self.use_upper = tk.BooleanVar(value=True)
        self.use_digit = tk.BooleanVar(value=True)
        self.use_symbol = tk.BooleanVar(value=False)
        self.exclude_ambiguous = tk.BooleanVar(value=True)

        ttk.Checkbutton(opt_frame, text="小文字 (a-z)", variable=self.use_lower).grid(row=0, column=0, sticky="w")
        ttk.Checkbutton(opt_frame, text="大文字 (A-Z)", variable=self.use_upper).grid(row=0, column=1, sticky="w")
        ttk.Checkbutton(opt_frame, text="数字 (0-9)", variable=self.use_digit).grid(row=0, column=2, sticky="w")
        ttk.Checkbutton(opt_frame, text="記号 (!@#$...)", variable=self.use_symbol).grid(row=0, column=3, sticky="w")
        ttk.Checkbutton(opt_frame, text="紛らわしい文字を除外 (0,O,1,l,I)", variable=self.exclude_ambiguous).grid(row=1, column=0, columnspan=3, sticky="w", pady=(6, 0))

        tk.Label(opt_frame, text="桁数:").grid(row=2, column=0, sticky="w", pady=(8, 0))
        self.length_var = tk.IntVar(value=12)
        ttk.Spinbox(opt_frame, from_=4, to=64, textvariable=self.length_var, width=6).grid(row=2, column=1, sticky="w", pady=(8, 0))

        tk.Label(opt_frame, text="個数:").grid(row=2, column=2, sticky="w", pady=(8, 0))
        self.count_var = tk.IntVar(value=5)
        ttk.Spinbox(opt_frame, from_=1, to=50, textvariable=self.count_var, width=6).grid(row=2, column=3, sticky="w", pady=(8, 0))

        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(pady=4)
        ttk.Button(btn_frame, text="生成する", command=self.generate).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn_frame, text="クリア", command=self.clear).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn_frame, text="コピー", command=self.copy_all).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=("Consolas", 12), bg="white", state=tk.DISABLED)
        self.result_text.pack(fill=tk.BOTH, expand=True, side=tk.LEFT)
        sb = ttk.Scrollbar(result_frame, command=self.result_text.yview)
        self.result_text.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)

    def generate(self):
        """指定条件でパスワードを生成"""
        # 文字種を組み立て
        pools = []
        if self.use_lower.get():
            pools.append(string.ascii_lowercase)
        if self.use_upper.get():
            pools.append(string.ascii_uppercase)
        if self.use_digit.get():
            pools.append(string.digits)
        if self.use_symbol.get():
            pools.append("!@#$%^&*()-_=+[]{};:,.?/")
        if not pools:
            messagebox.showwarning("警告", "少なくとも1つの文字種を選んでください")
            return

        # 紛らわしい文字を除外
        ambiguous = set("0O1lI|`'\"")
        if self.exclude_ambiguous.get():
            pools = ["".join(c for c in p if c not in ambiguous) for p in pools]
            pools = [p for p in pools if p]
            if not pools:
                messagebox.showwarning("警告", "除外条件で文字が無くなりました")
                return

        try:
            length = int(self.length_var.get())
            count = int(self.count_var.get())
            if length < 4:
                raise ValueError("桁数は4以上にしてください")
            if not (1 <= count <= 50):
                raise ValueError("個数は1〜50で指定してください")
        except (tk.TclError, ValueError) as e:
            messagebox.showerror("エラー", str(e))
            return

        results = [self._make_one(pools, length) for _ in range(count)]
        self._show("\n".join(results))

    def _make_one(self, pools, length):
        """各文字種を最低1文字含むよう生成"""
        all_chars = "".join(pools)
        # 各プールから1文字ずつ確保
        pw_chars = [secrets.choice(p) for p in pools]
        # 残りをランダム
        for _ in range(length - len(pools)):
            pw_chars.append(secrets.choice(all_chars))
        # シャッフル(secretsベース)
        for i in range(len(pw_chars) - 1, 0, -1):
            j = secrets.randbelow(i + 1)
            pw_chars[i], pw_chars[j] = pw_chars[j], pw_chars[i]
        return "".join(pw_chars[:length])

    def clear(self):
        """結果欄クリア"""
        self._show("")

    def copy_all(self):
        """結果をクリップボードにコピー"""
        text = self.result_text.get("1.0", tk.END).strip()
        if not text:
            return
        self.root.clipboard_clear()
        self.root.clipboard_append(text)
        messagebox.showinfo("完了", "クリップボードにコピーしました")

    def _show(self, text):
        """結果テキストを更新"""
        self.result_text.config(state=tk.NORMAL)
        self.result_text.delete("1.0", tk.END)
        self.result_text.insert("1.0", text)
        self.result_text.config(state=tk.DISABLED)


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

5. コード解説

ランダムパスワード生成のコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

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

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

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

UIレイアウトの構築

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

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

イベント処理

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

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

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

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

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

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

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

※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください(重複表示を避けるため再掲を省略しています)。

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

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

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

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

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

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

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

🚀
次に挑戦するアプリ

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