watcher.h

Go to the documentation of this file.

#ifndef FS_WATCHER_H
#define FS_WATCHER_H
 
#include <chrono>
#include <functional>
#include <string>
#include <vector>
#include <cstdint>
 
#include "filesystem.h"
#include "pattern_filter.h"
 
namespace fs
{
 
 
 
class watcher
{
public:
    enum entry_status
    {
        created,
        modified,
        removed,
        renamed,
        unmodified,
    };
 
    struct entry
    {
        fs::path path;
        fs::path last_path;
        entry_status status = unmodified;
        fs::file_time_type last_mod_time;
        std::chrono::system_clock::time_point event_time{};
        std::uintmax_t size = 0;
        fs::file_type type;
    };
 
    using notify_callback = std::function<void(const std::vector<entry>&, bool)>;
    using clock_t = std::chrono::steady_clock;
    //-----------------------------------------------------------------------------
    //  Name : watch ()
    //-----------------------------------------------------------------------------
    static auto watch(const fs::path& path,
                      const pattern_filter& filter,
                      bool recursive,
                      bool initial_list,
                      clock_t::duration poll_interval,
                      notify_callback callback,
                      const std::string& watcher_name = "") -> std::uint64_t;
 
    //-----------------------------------------------------------------------------
    //  Name : unwatch ()
    //-----------------------------------------------------------------------------
    static void unwatch(std::uint64_t key);
 
    //-----------------------------------------------------------------------------
    //  Name : unwatch_all ()
    //-----------------------------------------------------------------------------
    static void unwatch_all();
 
    //-----------------------------------------------------------------------------
    //  Name : touch ()
    //-----------------------------------------------------------------------------
    static void touch(const fs::path& path, bool recursive, fs::file_time_type time = fs::now());
 
    //-----------------------------------------------------------------------------
    //  Name : pause ()
    //-----------------------------------------------------------------------------
    static void pause();
 
    //-----------------------------------------------------------------------------
    //  Name : resume ()
    //-----------------------------------------------------------------------------
    static void resume();
 
};
 
auto to_string(const watcher::entry& e) -> std::string;
 
 
inline auto filetime_to_system_clock(fs::file_time_type ft) -> std::chrono::system_clock::time_point
{
    using namespace std::chrono;
 
    const auto now_file = fs::file_time_type::clock::now();
    const auto now_sys  = system_clock::now();
 
    return now_sys + (ft - now_file);
}
 
} // namespace fs
 
#endif