This CLI tool watches a specified file or directory for changes and executes a given command whenever a change is detected. It uses the fsnotify package to monitor file system events and supports debouncing to prevent multiple rapid executions of the command.
To install the tool, you need to have Go installed on your system. Then, you can build the tool using the following commands:
git clone [email protected]/comfucios/file-watcher
cd file-watcher
go build -o file-watcherAlternatively, you can download the pre-built artifact from the latest release on GitHub that matches your OS and CPU architecture. Untar the downloaded file and use the extracted file-watcher file in the folder you extracted:
# Download the latest release artifact
curl -L -o file-watcher.tar.gz https://github.com/comfucios/file-watcher/releases/latest/download/file-watcher-darwin-amd64.tar.gz
# Extract the tar file
tar -xzf file-watcher.tar.gz
# Use the extracted file-watcher
./file-watcher --versionThe tool requires two flags: --source and --action.
--source: The source file or directory to watch.--action: The CLI command to execute when a change is detected.
Watch a directory and execute a command when a change is detected:
./file-watcher --source /path/to/directory --action "echo 'Directory changed!'"Watch a file and execute a command when a change is detected:
./file-watcher --source /path/to/file.txt --action "echo 'File changed!'"- The tool supports debouncing with a 500-millisecond delay to prevent multiple rapid executions of the command.
- The tool will monitor the specified directory and all its subdirectories.
This project is licensed under the MIT License - see the LICENSE file for details.