Webページ監視ツール

1. アプリ概要

URLを登録して定期的にアクセスしページの変化をハッシュ比較で検出してアプリ内ログに記録するモニタリングツール。

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

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

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

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

2. 機能一覧

• 「▶ 監視開始」ボタン（_add_job()）・「⏹ 選択停止」ボタン（_stop_job()）・「🗑 削除」ボタン（_remove_job()）で操作
• ttk.Treeview による表形式の一覧表示
• messagebox.showerror()・messagebox.showinfo() によるダイアログ通知
• ウィンドウはタイトル「Webページ監視ツール」・サイズ 920x664 で起動

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
import urllib.request
import hashlib
import threading
import time
from datetime import datetime


class App063:
    """Webページ監視ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("Webページ監視ツール")
        self.root.geometry("920x664")
        self.root.minsize(920, 664)
        self.root.configure(bg="#1e1e1e")
        self._jobs = {}   # url -> {"interval", "last_hash", "after_id", ...}
        self._log = []
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🌐 Webページ監視ツール",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # URL追加
        add_f = tk.Frame(self.root, bg="#1e1e1e", pady=4)
        add_f.pack(fill=tk.X, padx=8)
        tk.Label(add_f, text="URL:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT)
        self.url_var = tk.StringVar(value="https://www.python.org/")
        ttk.Entry(add_f, textvariable=self.url_var,
                  width=40).pack(side=tk.LEFT, padx=4)
        tk.Label(add_f, text="間隔(秒):", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(8, 2))
        self.interval_var = tk.IntVar(value=60)
        ttk.Spinbox(add_f, from_=10, to=3600, textvariable=self.interval_var,
                    width=6).pack(side=tk.LEFT)
        ttk.Button(add_f, text="▶ 監視開始",
                   command=self._add_job).pack(side=tk.LEFT, padx=8)
        ttk.Button(add_f, text="⏹ 選択停止",
                   command=self._stop_job).pack(side=tk.LEFT)
        ttk.Button(add_f, text="🗑 削除",
                   command=self._remove_job).pack(side=tk.LEFT, padx=4)

        # 監視リスト
        jobs_f = tk.Frame(self.root, bg="#1e1e1e")
        jobs_f.pack(fill=tk.X, padx=8, pady=4)
        tk.Label(jobs_f, text="監視中のURL", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w")
        cols = ("url", "interval", "last_check", "status", "changes")
        self.job_tree = ttk.Treeview(jobs_f, columns=cols, show="headings",
                                      height=6, selectmode="browse")
        self.job_tree.heading("url",        text="URL")
        self.job_tree.heading("interval",   text="間隔")
        self.job_tree.heading("last_check", text="最終確認")
        self.job_tree.heading("status",     text="状態")
        self.job_tree.heading("changes",    text="変化回数")
        self.job_tree.column("url",        width=300, anchor="w")
        self.job_tree.column("interval",   width=60,  anchor="center")
        self.job_tree.column("last_check", width=140, anchor="w")
        self.job_tree.column("status",     width=80,  anchor="center")
        self.job_tree.column("changes",    width=70,  anchor="center")
        jsb = ttk.Scrollbar(jobs_f, command=self.job_tree.yview)
        self.job_tree.configure(yscrollcommand=jsb.set)
        jsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.job_tree.pack(fill=tk.X)
        self.job_tree.tag_configure("changed", foreground="#f48771")
        self.job_tree.tag_configure("ok",      foreground="#4ec9b0")
        self.job_tree.tag_configure("error",   foreground="#ffd700")

        # 変化ログ
        log_f = tk.Frame(self.root, bg="#1e1e1e")
        log_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)
        tk.Label(log_f, text="変化ログ", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w")
        self.log_text = tk.Text(log_f, bg="#0d1117", fg="#d4d4d4",
                                 font=("Courier New", 9), relief=tk.FLAT,
                                 state=tk.DISABLED, wrap=tk.WORD)
        lsb = ttk.Scrollbar(log_f, command=self.log_text.yview)
        self.log_text.configure(yscrollcommand=lsb.set)
        lsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.log_text.pack(fill=tk.BOTH, expand=True)
        self.log_text.tag_configure("changed",  foreground="#f48771")
        self.log_text.tag_configure("ok",       foreground="#4ec9b0")
        self.log_text.tag_configure("error",    foreground="#ffd700")
        self.log_text.tag_configure("info",     foreground="#4fc3f7")

        self.status_var = tk.StringVar(value="URLを追加して監視を開始してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _add_job(self):
        url = self.url_var.get().strip()
        if not url.startswith("http"):
            messagebox.showerror("エラー", "有効なURLを入力してください")
            return
        if url in self._jobs:
            messagebox.showinfo("情報", "既に監視中のURLです")
            return
        interval = max(10, self.interval_var.get())
        self._jobs[url] = {
            "interval": interval,
            "last_hash": None,
            "last_check": "",
            "changes": 0,
            "running": True,
            "after_id": None,
        }
        # Treeviewに追加
        self.job_tree.insert("", tk.END, iid=url,
                              values=(url, f"{interval}s", "-", "監視中", 0),
                              tags=("ok",))
        self._log_msg(f"監視開始: {url}", "info")
        self._schedule_check(url)

    def _schedule_check(self, url):
        job = self._jobs.get(url)
        if not job or not job["running"]:
            return
        threading.Thread(target=self._check, args=(url,), daemon=True).start()

    def _check(self, url):
        job = self._jobs.get(url)
        if not job:
            return
        try:
            req = urllib.request.Request(
                url, headers={"User-Agent": "Mozilla/5.0"})
            with urllib.request.urlopen(req, timeout=15) as resp:
                content = resp.read()
            h = hashlib.md5(content).hexdigest()
            now = datetime.now().strftime("%Y-%m-%d %H:%M:%S")

            if job["last_hash"] is None:
                job["last_hash"] = h
                job["last_check"] = now
                self.root.after(0, self._update_job_row, url, "初回取得", "ok")
            elif h != job["last_hash"]:
                job["last_hash"] = h
                job["last_check"] = now
                job["changes"] += 1
                self.root.after(0, self._update_job_row, url, "変化あり!", "changed")
                self.root.after(0, self._log_msg,
                                f"⚠ 変化検出: {url} ({now})", "changed")
            else:
                job["last_check"] = now
                self.root.after(0, self._update_job_row, url, "変化なし", "ok")

        except Exception as e:
            self.root.after(0, self._update_job_row, url, "エラー", "error")
            self.root.after(0, self._log_msg, f"✖ エラー: {url}: {e}", "error")

        # 次回スケジュール
        if job["running"]:
            after_id = self.root.after(
                job["interval"] * 1000,
                lambda u=url: self._schedule_check(u))
            job["after_id"] = after_id

    def _update_job_row(self, url, status, tag):
        job = self._jobs.get(url)
        if not job:
            return
        try:
            self.job_tree.item(url, values=(
                url, f"{job['interval']}s",
                job["last_check"], status, job["changes"]),
                tags=(tag,))
        except Exception:
            pass

    def _log_msg(self, text, tag=""):
        self.log_text.configure(state=tk.NORMAL)
        ts = datetime.now().strftime("%H:%M:%S")
        self.log_text.insert(tk.END, f"[{ts}] {text}\n", tag)
        self.log_text.see(tk.END)
        self.log_text.configure(state=tk.DISABLED)

    def _stop_job(self):
        sel = self.job_tree.selection()
        if not sel:
            return
        url = sel[0]
        job = self._jobs.get(url)
        if job:
            job["running"] = False
            if job["after_id"]:
                self.root.after_cancel(job["after_id"])
            self.job_tree.item(url, values=(
                url, f"{job['interval']}s",
                job["last_check"], "停止中", job["changes"]))
            self._log_msg(f"監視停止: {url}", "info")

    def _remove_job(self):
        sel = self.job_tree.selection()
        if not sel:
            return
        url = sel[0]
        self._stop_job()
        del self._jobs[url]
        self.job_tree.delete(url)
        self._log_msg(f"削除: {url}", "info")


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

5. コード解説

Webページ監視ツールのコードを、実際に書かれている実装に沿って解説します。

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

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

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

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

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

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

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

   title("Webページ監視ツール")・geometry("920x664")・configure(bg="#1e1e1e")・minsize(920, 664) をコンストラクタで設定します。

4. 4
   画面部品を並べる

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

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

   「2. 機能一覧」で挙げた各ボタンを command= で対応するメソッド（_add_job()・_stop_job()・_remove_job()）につなぎます。

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

   アプリの本体である _schedule_check()（5行）・_update_job_row()（11行）・_log_msg()（6行）など を実装します。

7. 7
   動作確認する

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

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

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

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

9. 練習問題

アプリの理解を深めるための練習問題です。

1. 課題1：機能拡張

   Webページ監視ツールに新しい機能を1つ追加してみましょう。

2. 課題2：UIの改善

   色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。

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

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