File system watcherπŸ”—

A data source that outputs the path to a file or directory each time a change is detected.

InputsπŸ”—

  • path: The path to a file or directory to watch. The file or directory at path must exists. If it doesn’t, nothing will be emitted. If the file or directory is removed during execution, the file system watcher will stop sending signals.

  • delay: The number of milliseconds to wait before a change is reported. The output will only be sent when a file has not been changed for delay milliseconds. This is useful to avoid processing incomplete files. If delay is zero, every detected change will cause an output.

  • mode: Mode of operation.

OutputsπŸ”—

  • path: The name of a changed file. If the path input parameter points to a file, this value will always be the same. If a directory is being watched, either the path of the directory or the paths of all added files are sent, depending on mode.

  • time: The date and local time when the file or directory was last modified.

enum ModeπŸ”—

Operation modes.

Values:

enumerator WatchChangesToFileπŸ”—

Output the value of the path input parameter each time the watched file changes or it is removed/renamed.

enumerator WatchChangesToDirectoryπŸ”—

Output the value of the path input parameter each time the directory changes or it is removed/renamed.

A directory changes when a file is added to or removed from it.

enumerator WatchAddedFilesπŸ”—

Output the path to a new file each time a file is added to a watched directory.