# rswatch
A program for monitoring files and directories and executing command on change
## Use cases
* Print modified, added, or removed files from directory structure
* Execute command for changed files
## Examples
`rswatch src -e cat {}` Checks for changes in `src` directory and run `cat` with the changed files
`rswatch src -p` Print changed files to stdout
`rswatch src -ke compile_and_run.sh` Run `compile_and_run.sh` on any change to `src` directory. If the process is still running, e.g; program is in a loop, kill instead of wait (`-k --kill` flag)
This is useful if you're making an interactive application that runs in a loop or waits for used input. -k flag will kill the process and restart it rather than waiting for it to complete.
Setting up this script in a terminal can be used to automatically rebuild and run tests on save
# Exiting
Using Ctrl-C (SIGINT) in terminal will terminate child process if running, if child process isn't running, it will prompt to confirm exit, simply enter y or `enter` to exit
This is to prevent accidental exit from rswatch when terminating child process
## Usage
### Accessible with `rswatch --help`
-, --(unnamed) [required]
Specify which files and/or directories to watch
-h, --help
Show usage
-p, --print
Print modified files and directories to stdout
-v, --verbose
Verbose output
-i, --interval
Time in milliseconds between checks (default 100)
-k, --kill
Specifies to kill the child process `exec` rather than wait for it
-c, --clear
Clears the screen before restarting childprocess `exec`
-s, --start
Start the process `exec` on startup instead of waiting for a file to change before doing so
-e, --exec
Command to execute when files change
All following arguments are given to the specified command
{} is to be replaced by the changed files, to run command for each changed file separately
Watch is not blocked during execution when process is spawned but will wait until previous finished before rerunning next check
To kill and restart process rather than waiting, use option --kill