Robot
/
watchexec
mirror of https://github.com/watchexec/watchexec.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Executes commands in response to file modifications
1,128 Commits 11 Branches 262 Tags 13 MiB
Rust 99.6%
Shell 0.3%
Go to file
Félix Saparelli 6d65c05e35
Add openSUSE and MINGW packages (#453) 		2022-12-02 23:16:56 +00:00
.cargo Learn some build optimisations from binstall (#416) 2022-09-07 06:00:08 +00:00
.github Bump mathieudutour/github-tag-action from 6.0 to 6.1 (#435) 2022-11-25 12:04:04 +13:00
bin Remove obsolete bin/ scripts (#322) 2022-06-16 15:46:32 +00:00
completions Fix zsh autocomplete after using --shell=bash (#417) 2022-09-15 03:17:35 +00:00
crates Add apt.cli.rs to install methods (#451) 2022-12-02 22:44:04 +00:00
doc Add openSUSE and MINGW packages (#453) 2022-12-02 23:16:56 +00:00
test Remask received signal after re-raising it 2016-12-15 09:41:10 -05:00
.editorconfig Fix cli tests 2021-08-24 22:53:44 +12:00
.gitattributes Mark Cargo.lock as binary for merging (#305) 2022-06-11 07:38:31 +00:00
.gitignore Add rpm support with cargo-generate-rpm 2021-07-10 03:48:12 +12:00
.rustfmt.toml Apply tabs project-wide 2021-08-24 20:22:25 +12:00
CITATION.cff release: watchexec-cli v1.20.6 (#415) 2022-09-07 05:30:28 +00:00
CONTRIBUTING.md Update contrib guide (#452) 2022-12-02 23:07:36 +00:00
Cargo.lock Add option to exit when stdin ends (#449) 2022-12-01 23:19:04 +00:00
Cargo.toml Learn some build optimisations from binstall (#416) 2022-09-07 06:00:08 +00:00
LICENSE Create LICENSE 2016-09-18 16:43:26 -04:00
README.md Add apt.cli.rs to install methods (#451) 2022-12-02 22:44:04 +00:00
release.toml Setup cargo-release 2022-02-10 01:40:32 +13:00

README.md

CI status on main branch

Watchexec

Software development often involves running the same commands over and over. Boring!

watchexec is a simple, standalone tool that watches a path and runs a command whenever it detects modifications.

Example use cases:

  • Automatically run unit tests
  • Run linters/syntax checkers

Features

  • Simple invocation and use, does not require a cryptic command line involving xargs
  • Runs on OS X, Linux, and Windows
  • Monitors current directory and all subdirectories for changes
  • Coalesces multiple filesystem events into one, for editors that use swap/backup files during saving
  • Loads .gitignore and .ignore files
  • Uses process groups to keep hold of forking programs
  • Provides the paths that changed in environment variables
  • Does not require a language runtime, not tied to any particular language or ecosystem
  • And more!

Quick start

Watch all JavaScript, CSS and HTML files in the current directory and all subdirectories for changes, running npm run build when a change is detected:

$ watchexec -e js,css,html npm run build

Call/restart python server.py when any Python file in the current directory (and all subdirectories) changes:

$ watchexec -r -e py -- python server.py

More usage examples: in the CLI README!

Install

Packaging status

All options in detail: in the CLI README and in the manual page.

Augment

Watchexec pairs well with:

  • checkexec: to run only when source files are newer than a target file
  • just: a modern alternative to make
  • systemfd: socket-passing in development

Extend