This command-line tool watches one or more directories for files being created, renamed, modified or deleted, then optionally runs a script. It uses the directory change APIs of Linux, macOS and Windows, respectively, thanks to the fsnotify package.
Clone the repository and use "go build", and any ldflags etc. if you prefer. A task for Visual Studio Code is included.
Tested on Linux and macOS. Should work on Windows without modification.
In its simplest use, Sentinel merely watches a directory until an expected type of change occurs, then returns:
sentinel -c /tmpThe above example waits for a file to be created in /tmp, then exits.
You can also tell it to run a simple shell script:
sentinel -c -C /usr/local/bin/watcher.sh /tmpOr to keep running it again:
sentinel -c -C /usr/local/bin/watcher.sh /tmp -LThe specified script(s) will be given two environment variables, SENTINEL_ACTION and SENTINEL_PATH, to indicate what happened and to what.
The keyword in SENTINEL_ACTION will be create, write, delete, rename or chmod.
Any non-flag arguments found are taken as directories to watch, and any number you need is allowed. Multiple instances of Sentinel are required if you wish to run different scripts per folder.
The supported types of events to watch for are as follows:
- -c: Create. New files trigger this.
- -w: Write. Triggered when an existing file is written to.
- -d: Delete. Deleting a file from the watched directory will trigger this. Deleting the directory being watched has undetermined results (may vary per platform).
- -r: Rename.
- -m: Modification. Changing file permissions, date or attributes will trigger this.
Each event flag has a corresponding uppercase version to specify a script to run when triggered. The first argument passed to this script will be the name of the directory where something happened.
If you return exit code 1 from a script, Sentinel will quit even in loop mode.
You can get a bit more output by passing the -v flag, or see the current version of Sentinel by passing -V.
MIT.