Python API library and shell utilities to monitor file system events.
启动线程,监控操作系统事件,可以启动多个线程监控不同的事件。
监控的事件有:moved/deleted/created/modified,分别针对directory、file,共八种事件。
Quickstart:
1. Create an instance of the watchdog.observers.Observer thread class.
2. Implement a subclass of watchdog.events.FileSystemEventHandler
3. Schedule monitoring a few paths with the observer instance attaching the event handler.
4. Start the observer thread and wait for it generate events without blocking our main thread.
import sys
import time
import logging
from watchdog.observers import Observer
from watchdog.events import LoggingEventHandler
###lib中LoggingEventHandler的实现
class LoggingEventHandler(FileSystemEventHandler):
"""Logs all the events captured."""
def on_moved(self, event):
super(LoggingEventHandler, self).on_moved(event)
what = 'directory' if event.is_directory else 'file'
logging.info("Moved %s: from %s to %s", what, event.src_path,
event.dest_path)
def on_created(self, event):
super(LoggingEventHandler, self).on_created(event)
what = 'directory' if event.is_directory else 'file'
logging.info("Created %s: %s", what, event.src_path)
def on_deleted(self, event):
super(LoggingEventHandler, self).on_deleted(event)
what = 'directory' if event.is_directory else 'file'
logging.info("Deleted %s: %s", what, event.src_path)
def on_modified(self, event):
super(LoggingEventHandler, self).on_modified(event)
what = 'directory' if event.is_directory else 'file'
logging.info("Modified %s: %s", what, event.src_path)
###
if __name__ == "__main__":
logging.basicConfig(level=logging.INFO,
format='%(asctime)s - %(message)s',
datefmt='%Y-%m-%d %H:%M:%S')
path = sys.argv[1] if len(sys.argv) > 1 else '.'
event_handler = LoggingEventHandler()
observer = Observer()
observer.schedule(event_handler, path, recursive=True)
observer.start()
try:
while True:
time.sleep(1)
except KeyboardInterrupt:
observer.stop()
observer.join()
以上例子中的LoggingEventHandler继承Handler基类FileSystemEventHandler。
Handler基类:FileSystemEventHandler
lib中实现了一些Handler,例如:LoggingEventHandler
Event基类:FileSystemEvent
捕捉事件之后的逻辑写在FileSystemEventHandler的事件处理函数中。
(on_moved、on_deleted、on_created、on_modified)