Class FileWatchManager

core/background.py:244–369

Manages file system watches using watchdog. Features: - Watch files/directories for changes - Callback on file events - Debouncing to avoid excessive triggers

class FileWatchManager:
    """
    Manages file system watches using watchdog.
    
    Features:
    - Watch files/directories for changes
    - Callback on file events
    - Debouncing to avoid excessive triggers
    """
    def __init__(self):
        self._watches: Dict[str, dict] = {}
        self._observer = None
        self._running = False
    
    def start(self):
        """Start the file watch observer."""
        try:
            from watchdog.observers import Observer
            self._observer = Observer()
            self._observer.start()
            self._running = True
            info("FileWatch: observer started")
        except ImportError:
            warning("FileWatch: watchdog not installed, file watches disabled")
        except Exception as e:
            error(f"FileWatch: failed to start observer: {e}")
    
    def stop(self):
        """Stop the file watch observer."""
        if self._observer and self._running:
            self._observer.stop()
            self._observer.join()
            self._running = False
            info("FileWatch: observer stopped")
    
    def add_watch(self, path: str, callback: Callable, 
                  patterns: List[str] = None,
                  recursive: bool = True) -> str:
        """
        Add a file watch.
        
        Args:
            path: Path to watch
            callback: Function to call on events
            patterns: File patterns to watch (e.g., ['*.py'])
            recursive: Watch subdirectories
            
        Returns:
            Watch ID
        """
        watch_id = f"watch_{path}_{int(time.time())}"
        
        self._watches[watch_id] = {
            "path": path,
            "callback": callback,
            "patterns": patterns,
            "recursive": recursive,
        }