Highlights

• Test C++20 on BeagleBoard-x15 (2023)
• Requires C++20 and std::filesystem
• MIT License
• Cross Tool:

source: https://developer.arm.com/downloads/-/gnu-a/10-2-2020-11

https://developer.arm.com/-/media/Files/downloads/gnu-a/10.2-2020.11/binrel/gcc-arm-10.2-2020.11-x86_64-arm-none-linux-gnueabihf.tar.xz?revision=d0b90559-3960-4e4b-9297-7ddbc3e52783&rev=d0b9055939604e4b92977ddbc3e52783&hash=C3D4D1D828D6F933760715F509D3762118AA1D84

gcc-arm-10.2-2020.11-x86_64-arm-none-linux-gnueabihf/
gcc-arm-10.2-gnueabihf -> gcc-arm-10.2-2020.11-x86_64-arm-none-linux-gnueabihf/
gnu_bbx15 -> gcc-arm-10.2-2020.11-x86_64-arm-none-linux-gnueabihf/

Quick Start

Simply include fswatch.hpp and you're good to go.

#include <fswatch.hpp>

To start watching files, create an fswatch object and provide a variadic list of directories to watch.

The constructor takes variadic arguments - Simply provide a list of directories to watch. This watcher will observe your home directory, /opt, /tmp and the current working directory.

auto watcher = fswatch("~", "/opt", "/tmp", ".");

try {
  watcher.start();
} catch (const std::runtime_error& error) {
  std::cout << error.what() << std::endl;
}

Register callbacks to events

To add callbacks to events, use the watcher.on(...) method like so:

watcher.on(fswatch::TaskEvent::FILE_CREATED, [](auto &event) {
  std::cout << "File created: " << event.path << std::endl;
});

You can register a single callback for multiple events like this:

watcher.on({ fswatch::TaskEvent::FILE_OPENED, fswatch::TaskEvent::FILE_CLOSED },
  [](auto &event) {
    if (event.type == fswatch::TaskEvent::FILE_OPENED)
      std::cout << "File opened: " << event.path << std::endl;
    else
      std::cout << "File closed: " << event.path << std::endl;
});

Here are the list of events that fswatch can handle:

File Events

TaskEvent	Description
FILE_CREATED	File created in watched directory
FILE_OPENED	File opened in watched directory
FILE_MODIFIED	File modified in watched directory (e.g., write, truncate)
FILE_CLOSED	File closed in watched directory
FILE_DELETED	File deleted from watched directory

Directory Events

TaskEvent	Description
DIR_CREATED	Directory created in watched directory
DIR_OPENED	Directory opened in watched directory (e.g., when running ls)
DIR_MODIFIED	Directory modified in watched directory
DIR_CLOSED	Directory closed in watched directory
DIR_DELETED	Directory deleted from watched directory