Watch for changes to a directory, and yield the file paths downstream. Typical usage would be:

sourceFileChanges (setRelative False $ mkFileChangeSettings dir)

Since: 0.1.0.0

Settings for watching for file changes, to be passed in to sourceFileChanges. Should be created with mkFileChangeSettings.

Since: 0.1.0.0

Create a FileChangeSettings from a directory to watch. Provides defaults which can be overridden by the setter functions in this module, such as setRelative.

Since: 0.1.0.0

Override the WatchConfig when creating the WatchManager.

Default: defaultConfig

Since: 0.1.0.0

Whether to provide paths relative to the root directory (True) or absolute paths (False).

Default: True (relative paths)

Since: 0.1.0.0

Recursively watch a directory tree?

Default: True

Since: 0.1.0.0

Predicate used to filter events.

Default: const True (allow all events)

Since: 0.1.0.0

A file event reported by a file watcher. Each event contains the canonical path for the file and a timestamp guaranteed to be after the event occurred (timestamps represent current time when FSEvents receives it from the OS and/or platform-specific Haskell modules).

Helper for extracting the time associated with an event.

Helper for extracting the path associated with an event.

Watch configuration

This specifies whether multiple events from the same file should be collapsed together, and how close is close enough.

This is performed by ignoring any event that occurs to the same file until the specified time interval has elapsed.

Note that the current debouncing logic may fail to report certain changes to a file, potentially leaving your program in a state that is not consistent with the filesystem.

Make sure that if you are using this feature, all changes you make as a result of an Event notification are both non-essential and idempotent.