FSWatch

A cross platform library simplifying watching for file changes using a non-blocking interface using the Win32 API, inotify or std.file.dirEntries as fallback.

Comparison between implementations

To force usage of the std.file polling implementation you can just add version = FSWForcePoll;

Don't do this unless you have a specific reason as you will lose speed and accuracy!

Example

void main()
{
    // Initializes a FileWatch instance to watch on `project1/` (first argument) recursively (second argument)
    auto watcher = FileWatch("project1/", true);
    while (true)
    {
        // This will fetch all queued events or an empty array if there are none
        foreach (event; watcher.getEvents())
        {
            // paths are relative to the watched directory in most cases
            if (event.path == "dub.json" || event.path == "dub.sdl")
            {
                if (event.type == FileChangeEventType.create)
                {
                    // dub.json or dub.sdl got created
                }
                else if (event.type == FileChangeEventType.modify)
                {
                    // dub.json or dub.sdl got modified
                }
                else if (event.type == FileChangeEventType.remove)
                {
                    // dub.json or dub.sdl got deleted
                }
            }
            if (event.type == FileChangeEventType.rename)
            {
                // The file `event.path` has been removed to `event.newPath`
            }
            else if (event.type == FileChangeEventType.createSelf)
            {
                // the folder we are watching has been created
            }
            else if (event.type == FileChangeEventType.removeSelf)
            {
                // the folder we are watching has been deleted or renamed
            }
        }
        // ...
        myapp.handleInput();
        myapp.update();
        myapp.draw();
    }
}