DirWatcher

DirWatcher is a header-only c++ library for watching changes in folder using WinAPI. Process will run in background thread.

Dependencies:

1. <thread> for threading
2. <windows.h> for WinAPI calls
3. <function> (optional, see below) for callback function

Copyright:

(c) 2017 by CIWH

License

Public domain

Usage:

1. (Optional) You can define some actions before including:

• DIRWATCHER_FAILED_WATCH_DIR_ACTION will be called if setting handle is failed,
• DIRWATCHER_FAILED_CLOSE_HANDLE_ACTION will be called if closing handle failed,
• DIRWATCHER_DEFAULT_CALLBACK_MESSAGE will be inserted as code for default callback,
• DIRWATCHER_MESSAGE_BUFFER_SIZE is message buffer size (default is 1024 bytes)
• DIRWATCHER_USE_STD_FUNCTION if defined - will use std::function instead of function pointer for callback

1. #include "path/to/this/file/dirwatcher.hpp"
2. Create object: ciwh::DirWatcher watcher;

• Defaults: dir is ., non-recursive (dont watch subfolders)

1. Set callback:

   watcher.setCallback([](ciwh::FileActionType type, const char* filename){
       /* your code here */
   })
   

2. Run: watcher.start();

3. (Optional, will be called in destructor) Stop: watcher.stop();

You can chande dir via setDir(const char* path) method, set recursive mode via setRecursive(bool b) method. If watcher was running, it will restart.

Getters are: bool isRecursive(), bool isRunning(), const char* const getDir()