中級者向け No.39

FTPクライアント

FTPサーバーに接続してファイルをアップロード・ダウンロード・管理できるGUIクライアント。ftplibの活用を学びます。

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

1. アプリ概要

FTPサーバーに接続してファイルをアップロード・ダウンロード・管理できるGUIクライアント。ftplibの活用を学びます。

このアプリは中級カテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter(標準ライブラリ) で、難易度は ★★★ です。

このアプリは「ネットワーク」カテゴリです。ネットワーク連携は Python の代表的な活用領域で、I/O 待ちと UI 更新の関係や非同期処理の考え方が他の Web API 連携にも直接活きます。tkinter(標準ライブラリ) を活かして実装するこの構造は、他のアプリにも応用が効きます。

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

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

FTPクライアント 実行画面(Windows)
実行画面(Windows)
FTPクライアント 実行画面(Linux Mint)
実行画面(Linux Mint)

2. 機能一覧

  • ループで生成するボタン群(それぞれ _upload()_download()_delete_remote()_mkdir_remote() を実行)
  • 「🔌 接続」ボタン(_toggle_connect())・「📂」ボタン(lambda: (self.local_path_var.set(filedialog.askdirectory() or self.local_path_var.get()), self._refresh_local()))・「🔄」ボタン(_refresh_local())・「移動」ボタン(_remote_navigate_to())・「🔄」ボタン(_refresh_remote())・「作成」ボタンで操作
  • マウス操作 <Double-1> から _local_navigate() を実行
  • マウス操作 <Double-1> から _remote_navigate() を実行
  • ttk.Treeview による表形式の一覧表示
  • filedialog.askdirectory() によるファイル選択ダイアログ
  • messagebox.askyesno()messagebox.showerror()messagebox.showwarning() によるダイアログ通知
  • ウィンドウはタイトル「FTPクライアント」・サイズ 960x660 で起動

3. 事前準備・環境

ℹ️
動作確認環境

Python 3.10 以上 / Windows 11(実機)で起動・基本操作を確認 / Linux Mint 22.3(仮想マシン)で起動・画面表示を確認(macOS は未検証)

Windows 11(実機)で起動と基本操作を確認しています(全機能の網羅テストではありません)。Linux Mint 22.3(仮想マシン)では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

  • Python 3.10 以上
  • OS: Windows 11(実機で起動・基本操作を確認)・Linux Mint 22.3(仮想マシンで起動・画面表示を確認)

4. 完全なソースコード

💡
コードのコピー方法

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

追加インストール不要(標準ライブラリのみ使用)
app39.py
import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import ftplib
import os
import threading
from datetime import datetime


class App39:
    """FTPクライアント"""

    def __init__(self, root):
        self.root = root
        self.root.title("FTPクライアント")
        self.root.geometry("960x660")
        self.root.configure(bg="#f8f9fc")
        self._ftp = None
        self._connected = False
        self._current_remote = "/"
        self._current_local = os.path.expanduser("~")
        self._build_ui()

    def _build_ui(self):
        # ヘッダー
        header = tk.Frame(self.root, bg="#283593", pady=8)
        header.pack(fill=tk.X)
        tk.Label(header, text="📡 FTPクライアント",
                 font=("Noto Sans JP", 13, "bold"),
                 bg="#283593", fg="white").pack(side=tk.LEFT, padx=12)

        # 接続パネル
        conn_f = ttk.LabelFrame(self.root, text="サーバー接続", padding=8)
        conn_f.pack(fill=tk.X, padx=8, pady=6)
        lbl_s = {"bg": ttk.Style().lookup("TLabelframe", "background"), "font": ("Arial", 9)}

        row1 = tk.Frame(conn_f, bg=ttk.Style().lookup("TLabelframe", "background"))
        row1.pack(fill=tk.X)
        for lbl, attr, width, show in [
            ("ホスト:", "host_var", 22, ""),
            ("ポート:", "port_var", 6, ""),
            ("ユーザー:", "user_var", 14, ""),
            ("パスワード:", "pass_var", 14, "*"),
        ]:
            tk.Label(row1, text=lbl, **lbl_s).pack(side=tk.LEFT)
            var = tk.StringVar()
            if lbl == "ポート:":
                var.set("21")
            setattr(self, attr, var)
            entry = ttk.Entry(row1, textvariable=var, width=width, show=show)
            entry.pack(side=tk.LEFT, padx=4)

        self.connect_btn = ttk.Button(row1, text="🔌 接続",
                                       command=self._toggle_connect)
        self.connect_btn.pack(side=tk.LEFT, padx=8)

        self.conn_status_var = tk.StringVar(value="未接続")
        tk.Label(row1, textvariable=self.conn_status_var,
                 **lbl_s, fg="#c62828").pack(side=tk.LEFT, padx=8)

        # パッシブモード
        self.passive_var = tk.BooleanVar(value=True)
        ttk.Checkbutton(row1, text="パッシブモード",
                         variable=self.passive_var).pack(side=tk.LEFT)

        # メインエリア
        main_paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        main_paned.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # 左: ローカル
        local_f = ttk.LabelFrame(main_paned, text="ローカル", padding=4)
        main_paned.add(local_f, weight=1)
        self._build_local_panel(local_f)

        # 中央: 転送ボタン
        mid_f = tk.Frame(main_paned, bg="#f8f9fc", width=80)
        main_paned.add(mid_f, weight=0)
        self._build_transfer_buttons(mid_f)

        # 右: リモート
        remote_f = ttk.LabelFrame(main_paned, text="リモート", padding=4)
        main_paned.add(remote_f, weight=1)
        self._build_remote_panel(remote_f)

        # ログ
        log_f = ttk.LabelFrame(self.root, text="転送ログ", padding=4)
        log_f.pack(fill=tk.X, padx=8, pady=4)
        self.log_text = tk.Text(log_f, height=5, bg="#0d1117", fg="#c9d1d9",
                                 font=("Courier New", 9), state=tk.DISABLED)
        self.log_text.pack(fill=tk.X)

        # プログレス
        self.progress = ttk.Progressbar(self.root, mode="indeterminate")
        self.progress.pack(fill=tk.X, padx=8, pady=2)

        self.status_var = tk.StringVar(value="接続待機中")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#dde", font=("Arial", 9), anchor="w", padx=8
                 ).pack(fill=tk.X, side=tk.BOTTOM)

        self._refresh_local()

    def _build_local_panel(self, parent):
        addr_f = tk.Frame(parent, bg=ttk.Style().lookup("TLabelframe", "background"))
        addr_f.pack(fill=tk.X, pady=2)
        self.local_path_var = tk.StringVar(value=self._current_local)
        ttk.Entry(addr_f, textvariable=self.local_path_var,
                  width=28).pack(side=tk.LEFT, fill=tk.X, expand=True)
        ttk.Button(addr_f, text="📂",
                   command=lambda: (
                       self.local_path_var.set(
                           filedialog.askdirectory() or self.local_path_var.get()),
                       self._refresh_local()
                   )).pack(side=tk.LEFT, padx=2)
        ttk.Button(addr_f, text="🔄",
                   command=self._refresh_local).pack(side=tk.LEFT, padx=2)

        cols = ("icon", "name", "size", "date")
        self.local_tree = ttk.Treeview(parent, columns=cols,
                                        show="headings", height=14)
        for c, h, w in [("icon", "", 26), ("name", "名前", 180),
                         ("size", "サイズ", 70), ("date", "更新日", 110)]:
            self.local_tree.heading(c, text=h)
            self.local_tree.column(c, width=w, minwidth=20)
        sb = ttk.Scrollbar(parent, command=self.local_tree.yview)
        self.local_tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.local_tree.pack(fill=tk.BOTH, expand=True)
        self.local_tree.bind("<Double-1>", self._local_navigate)

    def _build_remote_panel(self, parent):
        addr_f = tk.Frame(parent, bg=ttk.Style().lookup("TLabelframe", "background"))
        addr_f.pack(fill=tk.X, pady=2)
        self.remote_path_var = tk.StringVar(value="/")
        ttk.Entry(addr_f, textvariable=self.remote_path_var,
                  width=28).pack(side=tk.LEFT, fill=tk.X, expand=True)
        ttk.Button(addr_f, text="移動",
                   command=lambda: self._remote_navigate_to(
                       self.remote_path_var.get())
                   ).pack(side=tk.LEFT, padx=2)
        ttk.Button(addr_f, text="🔄",
                   command=self._refresh_remote).pack(side=tk.LEFT, padx=2)

        cols = ("icon", "name", "size", "date")
        self.remote_tree = ttk.Treeview(parent, columns=cols,
                                         show="headings", height=14)
        for c, h, w in [("icon", "", 26), ("name", "名前", 180),
                         ("size", "サイズ", 70), ("date", "更新日", 110)]:
            self.remote_tree.heading(c, text=h)
            self.remote_tree.column(c, width=w, minwidth=20)
        sb = ttk.Scrollbar(parent, command=self.remote_tree.yview)
        self.remote_tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.remote_tree.pack(fill=tk.BOTH, expand=True)
        self.remote_tree.bind("<Double-1>", self._remote_navigate)

    def _build_transfer_buttons(self, parent):
        tk.Frame(parent, bg="#f8f9fc").pack(expand=True, fill=tk.BOTH)
        for text, cmd in [("→\nアップロード", self._upload),
                           ("←\nダウンロード", self._download),
                           ("🗑\n削除", self._delete_remote),
                           ("📁\n新フォルダ", self._mkdir_remote)]:
            tk.Button(parent, text=text, command=cmd,
                      bg="#e3f2fd", fg="#0d47a1", relief=tk.FLAT,
                      font=("Arial", 8), width=8, pady=6,
                      activebackground="#bbdefb").pack(pady=4)
        tk.Frame(parent, bg="#f8f9fc").pack(expand=True, fill=tk.BOTH)

    # ── ローカルパネル ────────────────────────────────────────────

    def _refresh_local(self):
        path = self.local_path_var.get().strip()
        if not os.path.isdir(path):
            path = os.path.expanduser("~")
            self.local_path_var.set(path)
        self._current_local = path
        self.local_tree.delete(*self.local_tree.get_children())
        # 親フォルダ
        parent = os.path.dirname(path)
        if parent != path:
            self.local_tree.insert("", "end", iid="__up__",
                                   values=("📁", "..", "", ""))
        try:
            entries = sorted(os.scandir(path),
                             key=lambda e: (not e.is_dir(), e.name.lower()))
            for entry in entries:
                try:
                    stat = entry.stat()
                    icon = "📁" if entry.is_dir() else "📄"
                    size = self._fmt_size(stat.st_size) if not entry.is_dir() else ""
                    date = datetime.fromtimestamp(
                        stat.st_mtime).strftime("%Y/%m/%d")
                    self.local_tree.insert("", "end", iid=entry.path,
                                           values=(icon, entry.name, size, date))
                except Exception:
                    pass
        except PermissionError:
            pass

    def _local_navigate(self, event):
        sel = self.local_tree.selection()
        if not sel:
            return
        iid = sel[0]
        if iid == "__up__":
            parent = os.path.dirname(self._current_local)
            self.local_path_var.set(parent)
            self._refresh_local()
        elif os.path.isdir(iid):
            self.local_path_var.set(iid)
            self._refresh_local()

    # ── 接続 ─────────────────────────────────────────────────────

    def _toggle_connect(self):
        if self._connected:
            self._disconnect()
        else:
            self._connect()

    def _connect(self):
        host = self.host_var.get().strip()
        if not host:
            messagebox.showwarning("警告", "ホスト名を入力してください")
            return
        self.connect_btn.config(state=tk.DISABLED)
        self.progress.start(10)
        threading.Thread(target=self._do_connect, daemon=True).start()

    def _do_connect(self):
        host = self.host_var.get().strip()
        port = int(self.port_var.get() or 21)
        user = self.user_var.get().strip() or "anonymous"
        passwd = self.pass_var.get()
        passive = self.passive_var.get()
        try:
            ftp = ftplib.FTP()
            ftp.connect(host, port, timeout=15)
            ftp.login(user, passwd)
            ftp.set_pasv(passive)
            self._ftp = ftp
            self._connected = True
            self._current_remote = ftp.pwd()
            self.root.after(0, self._on_connected)
        except Exception as e:
            self.root.after(0, self._on_connect_error, str(e))

    def _on_connected(self):
        self.progress.stop()
        self.connect_btn.config(state=tk.NORMAL, text="🔌 切断")
        self.conn_status_var.set(f"接続済み: {self.host_var.get()}")
        self.remote_path_var.set(self._current_remote)
        self._log(f"接続しました: {self.host_var.get()}")
        self._refresh_remote()

    def _on_connect_error(self, msg):
        self.progress.stop()
        self.connect_btn.config(state=tk.NORMAL)
        self.conn_status_var.set("接続失敗")
        messagebox.showerror("接続エラー", msg)

    def _disconnect(self):
        if self._ftp:
            try:
                self._ftp.quit()
            except Exception:
                pass
            self._ftp = None
        self._connected = False
        self.connect_btn.config(text="🔌 接続")
        self.conn_status_var.set("未接続")
        self.remote_tree.delete(*self.remote_tree.get_children())
        self._log("切断しました")

    # ── リモートパネル ────────────────────────────────────────────

    def _refresh_remote(self):
        if not self._connected:
            return
        threading.Thread(target=self._do_refresh_remote, daemon=True).start()

    def _do_refresh_remote(self):
        try:
            items = []
            self._ftp.cwd(self._current_remote)
            self._ftp.retrlines("LIST", lambda line: items.append(line))
            self.root.after(0, self._show_remote_list, items)
        except Exception as e:
            self.root.after(0, self._log, f"エラー: {e}")

    def _show_remote_list(self, items):
        self.remote_tree.delete(*self.remote_tree.get_children())
        parent_path = os.path.dirname(self._current_remote.rstrip("/"))
        if parent_path and parent_path != self._current_remote:
            self.remote_tree.insert("", "end", iid="__up__",
                                    values=("📁", "..", "", ""))
        for line in items:
            parts = line.split()
            if len(parts) < 9:
                continue
            perms = parts[0]
            size = parts[4]
            name = " ".join(parts[8:])
            date = f"{parts[5]} {parts[6]} {parts[7]}"
            is_dir = perms.startswith("d")
            icon = "📁" if is_dir else "📄"
            self.remote_tree.insert("", "end",
                                    iid=name,
                                    values=(icon, name,
                                            self._fmt_size(int(size)) if not is_dir else "",
                                            date))
        self.remote_path_var.set(self._current_remote)

    def _remote_navigate(self, event):
        sel = self.remote_tree.selection()
        if not sel:
            return
        name = sel[0]
        if name == "__up__":
            parent = os.path.dirname(self._current_remote.rstrip("/"))
            self._remote_navigate_to(parent or "/")
        else:
            icon = self.remote_tree.set(name, "icon")
            if icon == "📁":
                path = self._current_remote.rstrip("/") + "/" + name
                self._remote_navigate_to(path)

    def _remote_navigate_to(self, path):
        if not self._connected:
            return
        self._current_remote = path
        self._refresh_remote()

    # ── 転送操作 ─────────────────────────────────────────────────

    def _upload(self):
        if not self._connected:
            messagebox.showwarning("警告", "先に接続してください")
            return
        sel = self.local_tree.selection()
        if not sel:
            messagebox.showwarning("警告", "ローカルファイルを選択してください")
            return
        paths = [s for s in sel if s != "__up__" and os.path.isfile(s)]
        if not paths:
            return
        self.progress.start(10)
        threading.Thread(target=self._do_upload,
                         args=(paths,), daemon=True).start()

    def _do_upload(self, paths):
        for local_path in paths:
            name = os.path.basename(local_path)
            try:
                with open(local_path, "rb") as f:
                    remote_path = self._current_remote.rstrip("/") + "/" + name
                    self._ftp.storbinary(f"STOR {name}", f)
                self.root.after(0, self._log, f"↑ アップロード: {name}")
            except Exception as e:
                self.root.after(0, self._log, f"エラー: {name} - {e}")
        self.root.after(0, self.progress.stop)
        self.root.after(0, self._refresh_remote)

    def _download(self):
        if not self._connected:
            messagebox.showwarning("警告", "先に接続してください")
            return
        sel = self.remote_tree.selection()
        if not sel:
            messagebox.showwarning("警告", "リモートファイルを選択してください")
            return
        files = [s for s in sel if s != "__up__" and
                 self.remote_tree.set(s, "icon") == "📄"]
        if not files:
            return
        self.progress.start(10)
        threading.Thread(target=self._do_download,
                         args=(files,), daemon=True).start()

    def _do_download(self, files):
        for name in files:
            local_path = os.path.join(self._current_local, name)
            try:
                with open(local_path, "wb") as f:
                    self._ftp.retrbinary(f"RETR {name}", f.write)
                self.root.after(0, self._log, f"↓ ダウンロード: {name}")
            except Exception as e:
                self.root.after(0, self._log, f"エラー: {name} - {e}")
        self.root.after(0, self.progress.stop)
        self.root.after(0, self._refresh_local)

    def _delete_remote(self):
        if not self._connected:
            return
        sel = self.remote_tree.selection()
        if not sel or not messagebox.askyesno("確認", "選択ファイルを削除しますか?"):
            return
        for name in sel:
            if name == "__up__":
                continue
            try:
                icon = self.remote_tree.set(name, "icon")
                if icon == "📁":
                    self._ftp.rmd(name)
                else:
                    self._ftp.delete(name)
                self._log(f"削除: {name}")
            except Exception as e:
                self._log(f"削除エラー: {name} - {e}")
        self._refresh_remote()

    def _mkdir_remote(self):
        if not self._connected:
            return
        win = tk.Toplevel(self.root)
        win.title("新規フォルダ")
        win.geometry("260x100")
        tk.Label(win, text="フォルダ名:").pack(pady=8)
        var = tk.StringVar()
        ttk.Entry(win, textvariable=var, width=24).pack()

        def create():
            name = var.get().strip()
            if name:
                try:
                    self._ftp.mkd(self._current_remote.rstrip("/") + "/" + name)
                    self._log(f"フォルダ作成: {name}")
                    self._refresh_remote()
                except Exception as e:
                    messagebox.showerror("エラー", str(e))
            win.destroy()

        ttk.Button(win, text="作成", command=create).pack(pady=6)

    def _log(self, message):
        now = datetime.now().strftime("%H:%M:%S")
        self.log_text.config(state=tk.NORMAL)
        self.log_text.insert(tk.END, f"[{now}] {message}\n")
        self.log_text.see(tk.END)
        self.log_text.config(state=tk.DISABLED)

    def _fmt_size(self, size):
        for unit in ["B", "KB", "MB", "GB"]:
            if size < 1024:
                return f"{size:.0f}{unit}"
            size /= 1024
        return f"{size:.1f}TB"


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

5. コード解説

FTPクライアントのコードを、実際に書かれている実装に沿って解説します。

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

App39 クラスにアプリの全機能をまとめています(メソッド26個・全452行)。__init__ ではタイトル「FTPクライアント」とウィンドウサイズ 960x660 を設定します。あわせて状態を保持する変数(self._ftpself._connectedself._current_remote)を初期化し、最後に _build_ui() で画面を組み立てます。

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

ウィジェット構成

画面は tk.Frame×7・tk.Label×4(ほかにループでも生成)・ttk.LabelFrame×4・ttk.Style×4・ttk.Entry×3(ほかにループでも生成)・ttk.Button×6・ttk.Checkbuttonttk.PanedWindowtk.Textttk.Progressbarttk.Treeview×2・ttk.Scrollbar×2・tk.Button(ループで生成)・tk.Toplevel で構成しています。見出し付きの枠(LabelFrame)は「サーバー接続」「ローカル」「リモート」「転送ログ」のラベルでエリアを区切っています。PanedWindow を使っているので、ペインの境界をマウスでドラッグして幅を変えられます。

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

イベント処理とボタンの接続

「🔌 接続」ボタン(_toggle_connect())・「📂」ボタン(lambda: (self.local_path_var.set(filedialog.askdirectory() or self.local_path_var.get()), self._refresh_local()))・「🔄」ボタン(_refresh_local())・「移動」ボタン(_remote_navigate_to())・「🔄」ボタン(_refresh_remote())・「作成」ボタンを command= で接続しています。ボタンはラベルと処理をペアで並べたデータをループで回して生成し、それぞれ _upload()_download()_delete_remote()_mkdir_remote()command= に渡しています。ボタンを増やしたいときはこのペアを1行足すだけで済みます。また bind("<Double-1>", ...) から _local_navigate()bind("<Double-1>", ...) から _remote_navigate() を呼べるようにイベントも登録しています。

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

例外処理

try-except で ExceptionPermissionError を捕捉しています。あわせて messagebox.askyesno()messagebox.showerror()messagebox.showwarning() のダイアログで、ユーザーへの通知・確認を行います。

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

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

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

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

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

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

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

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

    title("FTPクライアント")geometry("960x660")configure(bg="#f8f9fc") をコンストラクタで設定します。

  4. 4
    画面部品を並べる

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

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

    「2. 機能一覧」で挙げた各ボタンを command= で対応するメソッド(_toggle_connect()lambda: (self.local_path_var.set(filedialog.askdirectory() or self.local_path_var.get()), self._refresh_local())_refresh_local()_remote_navigate_to()_refresh_remote()create)につなぎます。ループ生成のボタンは、ラベルと処理(_upload()_download()_delete_remote()_mkdir_remote())をペアで並べたデータをループで回し、command= に渡して接続します。bind("<Double-1>", ...)bind("<Double-1>", ...) の登録も忘れずに。

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

    アプリの本体である _refresh_local()(28行)・_on_connected()(7行)・_on_connect_error()(5行)など を実装します。

  7. 7
    動作確認する

    python app39.py で起動し、各ボタンが反応すること・マウス操作(クリック・ホイールなど)が効くことを確認します。

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

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。少しずつ機能を追加することで、Pythonのスキルが飛躍的に向上します。

💡 ダークモードを追加する

bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。

💡 配色をまとめて管理する

背景色 #f8f9fc をはじめ、色コードが各所に直書きされています。色を1つの辞書にまとめると、テーマの切り替えが1か所の変更で済むようになります。

💡 入力履歴機能

以前の入力値を覚えておいてComboboxのドロップダウンで再選択できる履歴機能を追加しましょう。

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

❌ 文字のフォントが崩れる・見た目が違う

原因:このコードは font=("Noto Sans JP", ...) のようにフォント名を直接指定しています。環境にこのフォントが入っていないと、OS が代わりのフォントで表示するため、見本と見た目が変わることがあります。

解決法:動作には支障ありません。気になる場合は font 引数の名前を自分の OS に入っているフォントへ書き換えるか、font 引数を省略してください。

❌ ウィンドウの大きさが画面に合わない

原因:geometry("960x660") の固定サイズで起動するためです。

解決法:この数値を書き換えて起動サイズを調整してください。なお、このコードにはウィンドウサイズを固定する設定(resizable の指定)が無いため、ウィンドウの端をドラッグしたサイズ変更は既定どおり可能です。

9. 練習問題

アプリの理解を深めるための練習問題です。気になるものから挑戦してみてください(課題3は定型の発展課題です)。FTP は、ユーザー名もパスワードもファイルの中身も暗号化せずに送ります。練習は自分が管理しているサーバー(手元のPCに立てたテスト用のFTPサーバーなど)だけにして、他人のサーバーや公開サーバーへ試しに接続しないでください。入力した接続情報はファイルに保存されず、起動のたびに入力する作りです。パスワードをコードへ書き込む改造は足さないでください。「🗑 削除」はサーバー上のファイルを消し、元には戻せません。追加のライブラリは要りません。

  1. 課題1:パスワードが平文のまま流れる

    _do_connect()ftplib.FTP() でつなぎます。この方式は、ユーザー名もパスワードもファイルの中身も暗号化しません。FTPS(FTP over TLS)を選べるようにしてください。

    期待結果:いまのコードは、どのサーバーに対しても平文で接続する。転送ログに出るのは、時刻に続く 接続しました: ホスト名 の1行だけ。暗号化されたかどうかは分からない。直したあとは、チェックを入れたときだけ TLS でつなぎ、ログでそれが分かる。TLS に対応していないサーバーでは AUTH TLS が拒否され、接続エラーのダイアログが出る。

    合格条件

    • チェックを外したときは、これまでどおり ftplib.FTP でつながる
    • つないだあとの一覧・アップロード・ダウンロードがそのまま動く
    • ユーザー名とパスワードは、これまでどおりコードにもファイルにも残さない

    ヒント①(どこを触るか): 触るのは2か所です。_build_ui() の「パッシブモード」チェックボックスの並びと、_do_connect()ftp = ftplib.FTP() です。
    ヒント②(使うもの): チェックは既存の self.passive_var と同じく、tk.BooleanVar(value=False) で作れます。ftplib.FTP_TLSFTP の子クラスです。login() を呼ぶと自動で AUTH TLS を実行します(ftplib のソースで確かめられます)。
    つまずきやすい点: FTP_TLS にしただけでは、暗号化されるのはコマンドとパスワードだけです。ファイルの中身も暗号化するには、login() のあとに prot_p() を呼びます。順番は connect()login()prot_p() で、既存の ftp.set_pasv(passive) はそのあとで構いません。サーバーが TLS に対応していないときは、平文へ戻すのではなく、そのサーバーへ大事なファイルを送らない判断をしてください。

  2. 課題2:ダウンロードが同じ名前のファイルを黙って上書きする

    _do_download()open(local_path, "wb") で保存します。手元に同じ名前のファイルがあると、確認なしで置き換わってしまいます。上書きになるときは確認してください。

    期待結果:左のローカル側にも右のリモート側にも memo.txt がある状態にする。リモートの memo.txt を選んで「←ダウンロード」を押す。何も聞かれずに手元の memo.txt が置き換わり、転送ログに残るのは ↓ ダウンロード: memo.txt の1行だけ。直したあとは確認が出て、「いいえ」を選べば手元のファイルは変わらない。

    合格条件

    • 同じ名前が無いときは、これまでどおり確認なしで保存される
    • 「いいえ」を選んだファイルは、中身も更新日時も変わらない
    • 複数選んだとき、どのファイルが上書きになるのか名前で分かる

    ヒント①(どこを触るか): 触るのは _download() の1か所です。files = [...] を作った直後、self.progress.start(10) の手前になります。
    ヒント②(使うもの): 保存先は os.path.join(self._current_local, name) です(_do_download() と同じ組み立て)。os.path.exists() で重なる名前を集め、messagebox.askyesno() で確認します。
    つまずきやすい点: 確認は _download() の中で出してください。_do_download()threading.Thread の中で動くため、そこから messagebox を呼ぶと画面が固まることがあります。open(local_path, "wb") は開いた瞬間に中身を空にするので、途中で通信が切れると元のファイルも戻せません。ログの ↓ ダウンロード: は成功したときだけ出ます。

  3. 課題3:新しいボタンを追加する

    既存のボタンと同じ書き方で新しいボタンを1つ足し、押されたときに動くメソッドを自作してみましょう。ボタンの作成と command= の接続がセットで身に付きます。

🚀
次に挑戦するアプリ

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

🐛
エラーが出て動かないときは

写経中に赤いエラー文が出たら、Pythonエラー一覧&解決法(英語メッセージ逆引き)で原因と直し方をすぐ確認できます。

📖
次のレベルへ進む参考書

このレベルのアプリが作れたら、入門書の次の「作るための本」へ進む時期です。実践におすすめのPython本(当サイトの参考書ランキング総合3〜4位)で自動化とコードの書き方の2冊を、その直後の用途別専門書の節でデータ分析・Web・AIの本を比較しています。