QGCFileWatcher.h

Go to the documentation of this file.

#pragma once
 
 
#include <QtCore/QFileSystemWatcher>
#include <QtCore/QObject>
#include <QtCore/QSet>
#include <QtCore/QString>
#include <QtCore/QTimer>
 
#include <functional>
 
class QGCFileWatcher : public QObject
{
    Q_OBJECT
 
public:
    using ChangeCallback = std::function<void(const QString &path)>;
 
    explicit QGCFileWatcher(QObject *parent = nullptr);
 
    ~QGCFileWatcher() override;
 
    void setDebounceDelay(int milliseconds);
 
    int debounceDelay() const { return _debounceDelay; }
 
    // ========================================================================
    // File Watching
    // ========================================================================
 
    bool watchFile(const QString &filePath, ChangeCallback callback);
 
    bool unwatchFile(const QString &filePath);
 
    bool isWatchingFile(const QString &filePath) const;
 
    QStringList watchedFiles() const;
 
    // ========================================================================
    // Directory Watching
    // ========================================================================
 
    bool watchDirectory(const QString &directoryPath, ChangeCallback callback);
 
    bool unwatchDirectory(const QString &directoryPath);
 
    bool isWatchingDirectory(const QString &directoryPath) const;
 
    QStringList watchedDirectories() const;
 
    // ========================================================================
    // Bulk Operations
    // ========================================================================
 
    int watchFiles(const QStringList &filePaths, ChangeCallback callback);
 
    int watchDirectories(const QStringList &directoryPaths, ChangeCallback callback);
 
    void clear();
 
    // ========================================================================
    // Convenience Methods
    // ========================================================================
 
    bool watchFilePersistent(const QString &filePath, ChangeCallback callback);
 
signals:
    void fileChanged(const QString &path);
 
    void directoryChanged(const QString &path);
 
private slots:
    void _onFileChanged(const QString &path);
    void _onDirectoryChanged(const QString &path);
    void _processPendingChanges();
 
private:
    void _scheduleCallback(const QString &path, bool isDirectory);
 
    QFileSystemWatcher *_watcher = nullptr;
 
    // Callbacks per path
    QHash<QString, ChangeCallback> _fileCallbacks;
    QHash<QString, ChangeCallback> _directoryCallbacks;
 
    // Persistent watch tracking
    QSet<QString> _persistentFiles;
 
    // Debouncing
    int _debounceDelay = 100;  // milliseconds
    QTimer *_debounceTimer = nullptr;
    QSet<QString> _pendingFileChanges;
    QSet<QString> _pendingDirectoryChanges;
    bool _processingPendingChanges = false;
};