pyinotify 封裝 Linux inotify 核心子系統,提供跨平台、事件驅動、非輪詢的文件系統監控。
pip install pyinotify
#!/usr/bin/env python
# coding=utf-8
import os
from pyinotify import WatchManager, Notifier, ProcessEvent, IN_DELETE, IN_CREATE, IN_MODIFY
wm = WatchManager()
mask = IN_DELETE | IN_CREATE | IN_MODIFY # 關注事件掩碼
class MyEventHandler(ProcessEvent):
def process_IN_CREATE(self, event):
print("Create file: %s" % os.path.join(event.path, event.name))
def process_IN_DELETE(self, event):
print("Delete file: %s" % os.path.join(event.path, event.name))
def process_IN_MODIFY(self, event):
print("Modify file: %s" % os.path.join(event.path, event.name))
if __name__ == "__main__":
notifier = Notifier(wm, MyEventHandler())
wdd = wm.add_watch('.', mask, rec=True, auto_add=True) # 遞歸監控當前目錄
print("Watching", os.getcwd(), "... (Ctrl+C to stop)")
try:
while True:
notifier.process_events()
if notifier.check_events():
notifier.read_events()
except KeyboardInterrupt:
notifier.stop()
print("\nStopped.")
| 組件 | 角色 |
|---|---|
WatchManager | 管理監控描述符與路徑映射 |
mask | 位元組合指定關注事件類型 |
ProcessEvent | 子類化實現具體事件處理邏輯 |
Notifier | 事件循環:read_events() → 內核通知 → process_events() 分發 |
IN_ACCESS # 文件被讀取
IN_MODIFY # 文件被修改
IN_ATTRIB # 元數據變更
IN_CLOSE_WRITE # 以寫模式關閉
IN_CLOSE_NOWRITE # 以讀模式關閉
IN_OPEN # 文件被打開
IN_MOVED_FROM # 文件移出監控目錄
IN_MOVED_TO # 文件移入監控目錄
IN_CREATE # 文件/目錄創建
IN_DELETE # 文件/目錄刪除
IN_DELETE_SELF # 監控目錄本身被刪除
IN_MOVE_SELF # 監控目錄本身被移動
IN_ALL_EVENTS # 以上所有
def process_IN_MODIFY(self, event):
print("path:", event.path) # 監控根目錄
print("name:", event.name) # 相對文件名
print("pathname:", event.pathname) # 完整路徑
print("mask:", event.mask) # 原始掩碼
print("cookie:", event.cookie) # 移動事件配對 ID
| 方案 | 優點 | 缺點 |
|---|---|---|
| pyinotify | 成熟、功能全、支援遞歸/自動添加 | 純 Python,極高頻事件可能有 GIL 瓶頸 |
| watchdog | 跨平台、API 現代、支援輪詢回退 | Linux 下仍呼叫 inotify,間接層較厚 |
| inotify-tools (C CLI) | 極輕量、無 Python 依賴 | 需解析文本輸出,整合麻煩 |
| systemd.path | 系統級、無需常駐進程 | 功能較弱、調試困難 |
pyinotify 以 ProcessEvent 子類 + Notifier 循環構成極簡監控框架。生產環境建議:異常捕獲防止循環崩潰、日誌輪轉、事件去抖(如 IN_MODIFY 連續觸發合併)、systemd 服務化 實現開機自啟與守護。