• Stars
    star
    458
  • Rank 95,591 (Top 2 %)
  • Language
    C
  • Created almost 13 years ago
  • Updated almost 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

watch(1) periodically executes the given command - useful for auto-testing, auto-building, auto-anything

Watch

A tiny C program used to periodically execute a command.

Usage


Usage: watch [options] <cmd>

Options:

  -q, --quiet           only output stderr
  -x, --halt            halt on failure
  -i, --interval <n>    interval in seconds or ms defaulting to 1
  -c, --clear           clear the screen between iterations
  -v, --version         output version number
  -h, --help            output this help information

Installation

$ make install

Or in your local bin (~/bin)

$ PREFIX=~ make install

About

This project is very similar to original watch(1) implemented in 1991, differences include:

  • ansi escape sequences (colors etc)
  • terminal is not cleared (unless --clear is provided)
  • lower default interval of 1s
  • millisecond interval resolution

Milliseconds resolution

This version of watch(1) support millisecond resolution with the ms suffix:

$ watch -i 300ms echo hey

whereas 300 would be seconds:

$ watch -i 300 echo hey

Examples

Watch is pretty handy, here are a few use-cases:

Running tests

Ad-hoc mtime watchers are annoying to construct, and have relatively no purpose when you can simply execute your tests at a regular interval. For example run watch(1) as a job, running tests each second (or a second after the program exits):

$ watch make test &
[1] 3794
✔ bifs.components
✔ bifs.dark
✔ bifs.darken
✔ bifs.image-size
...

Your tests will happily chug away, when you want to stop watch simply foreground the job and ^C:

$ fg

Auto-build CSS / JS etc

Need to build CSS or JavaScript dependencies? use a Makefile. With the large quantity of copy-cats (Rake,Jake,Sake,Cake...) people seem to be forgetting that Make is awesome, if you take a little bit of time to learn it you'll love it (or at least most of it). Make will utilize mtime and only build what's necessary, this is great.

Let's say we had some Jade templates, even some nested in sub-directories, we could list them in a Makefile quite easily.

Below JADE is a list constructed by the shell command find templates -name "*.jade", which is usually a lot easier to manage than listing these files manually, which is also valid, and sometimes important of ordering is relevant. Following that we have HTML which simply substitutes ".jade" with ".html", giving us our HTML targets.

JADE = $(shell find templates -name "*.jade")
HTML = $(JADE:.jade=.html)

Our first target is all, becoming the default target for make. On the right-hand side of this we specify the dependencies, which in this case is a list of all of our HTML files, not yet built. Make will see this and execute the %.html targets, which allows use to use the jade(1) executable to translate the dependency on the right of :, to the target on the left.

JADE = $(shell find templates -name "*.jade")
HTML = $(JADE:.jade=.html)

all: $(HTML)

%.html: %.jade
	jade < $< > $@

Now we can build all of these files with a single command make:

$ make
jade < templates/bar.jade > templates/bar.html
jade < templates/baz/raz.jade > templates/baz/raz.html
jade < templates/foo.jade > templates/foo.html

We can also add a clean pseudo-target to remove the compiled files with make clean. Here it's listed to the right of .PHONY:, telling make that it does not expect a file named ./clean on the fs, so it wont compare mtimes etc. Make is smart about re-executing these actions, if you make again you'll notice that since none of the dependencies have changed it'll simply tell you "make: Nothing to be done for `all'.".

JADE = $(shell find templates -name "*.jade")
HTML = $(JADE:.jade=.html)

all: $(HTML)

%.html: %.jade
	jade < $< > $@

clean:
	rm -f $(HTML)

.PHONY: clean

The one missing component is periodical action, which is where watch(1) or similar utilities come in, this functionality coupled with Make as a build system creates a powerful duo.

More Repositories

1

commander.js

node.js command-line interfaces made easy
JavaScript
26,707
star
2

n

Node version management
Shell
18,855
star
3

git-extras

GIT utilities -- repo summary, repl, changelog population, author commit percentages and more
Shell
17,295
star
4

co

The ultimate generator based flow-control goodness for nodejs (supports thunks, promises, etc)
JavaScript
11,853
star
5

ejs

Embedded JavaScript templates for node
JavaScript
4,450
star
6

node-prune

Remove unnecessary files from node_modules (.md, .ts, ...)
Go
4,297
star
7

consolidate.js

Template engine consolidation library for node.js
JavaScript
3,476
star
8

frontend-boilerplate

webpack-react-redux-babel-autoprefixer-hmr-postcss-css-modules-rucksack-boilerplate (unmaintained, I don't use it anymore)
JavaScript
2,939
star
9

connect-redis

Redis session store for Connect
TypeScript
2,788
star
10

should.js

BDD style assertions for node.js -- test framework agnostic
JavaScript
2,757
star
11

luna

luna programming language - a small, elegant VM implemented in C
C
2,446
star
12

dox

JavaScript documentation generator for node using markdown and jsdoc
JavaScript
2,159
star
13

mmake

Modern Make
Go
1,717
star
14

terminal-table

Ruby ASCII Table Generator, simple and feature rich.
Ruby
1,522
star
15

node-migrate

Abstract migration framework for node
JavaScript
1,522
star
16

axon

message-oriented socket library for node.js heavily inspired by zeromq
JavaScript
1,495
star
17

react-enroute

React router with a small footprint for modern browsers
JavaScript
1,490
star
18

commander

The complete solution for Ruby command-line executables
Ruby
1,089
star
19

mon

mon(1) - Simple single-process process monitoring program written in C
C
1,065
star
20

reds

light-weight, insanely simple full text search module for node.js - backed by Redis
JavaScript
891
star
21

node-thunkify

Turn a regular node function into one which returns a thunk
JavaScript
858
star
22

robo

Simple Go / YAML-based task runner for the team.
Go
786
star
23

react-click-outside

ClickOutside component for React.
JavaScript
775
star
24

gobinaries

Golang binaries compiled on-demand for your system
Go
770
star
25

node-blocked

Check if the event loop is blocked
JavaScript
722
star
26

node-ratelimiter

Abstract rate limiter for nodejs
JavaScript
719
star
27

staticgen

Static website generator that lets you use HTTP servers and frameworks you already know
Go
712
star
28

histo

beautiful charts in the terminal for static or streaming data
C
697
star
29

serve

Simple command-line file / directory server built with connect - supports stylus, jade, etc
JavaScript
563
star
30

styl

Flexible and fast modular CSS preprocessor built on top of Rework
JavaScript
525
star
31

pomo

Ruby Pomodoro app for the command-line (time / task management)
Ruby
525
star
32

go-spin

Terminal spinner package for Golang
Go
521
star
33

mdconf

Markdown driven configuration!
JavaScript
507
star
34

node-growl

growl unobtrusive notification system for nodejs
JavaScript
484
star
35

node-querystring

querystring parser for node and the browser - supporting nesting (used by Express, Connect, etc)
JavaScript
452
star
36

node-delegates

Nodejs method and accessor delegation utility
JavaScript
418
star
37

haml.js

Faster Haml JavaScript implementation for nodejs
JavaScript
409
star
38

triage

Interactive command-line GitHub issue & notification triaging tool.
Go
399
star
39

log.js

super light-weight nodejs logging + streaming log reader
HTML
368
star
40

go-tea

Tea provides an Elm inspired functional framework for interactive command-line programs.
Go
364
star
41

punt

Elegant UDP messaging for nodejs
JavaScript
341
star
42

react-fatigue-dev

Module of modules for making modules
Makefile
312
star
43

php-selector

PHP DOM parser / queries with CSS selectors
PHP
300
star
44

node-gify

Convert videos to gifs using ffmpeg and gifsicle
JavaScript
296
star
45

palette

Node.js image color palette extraction with node-canvas
JavaScript
292
star
46

better-assert

c-style assert() for nodejs, reporting the expression string as the error message
JavaScript
285
star
47

js-yaml

CommonJS YAML Parser -- fast, elegant and tiny yaml parser for javascript
JavaScript
275
star
48

go-naturaldate

Natural date/time parsing for Go.
Go
272
star
49

lingo

Linguistics module for Node - inflection, transformation, i18n and more
JavaScript
270
star
50

react-batch

Batch component for performant frequent updates (flush on count or interval)
JavaScript
251
star
51

sponsors-api

GitHub Sponsor avatar listings in your Readme.md
Go
244
star
52

mad

mad(1) is a markdown manual page viewer
Shell
244
star
53

d3-heatmap

D3 heatmap
JavaScript
243
star
54

go-update

Go package for auto-updating system-specific binaries via GitHub releases.
Go
241
star
55

callsite

node.js access to v8's "raw" CallSites -- useful for custom traces, c-style assertions, getting the line number in execution etc
JavaScript
239
star
56

bm

CLI bookmarks -- dropbox persisted bookmarks in your terminal - view screenshots in your browser
Shell
229
star
57

term-canvas

javascript canvas api for your terminal!
JavaScript
226
star
58

go-termd

Package termd provides terminal markdown rendering, with code block syntax highlighting support.
Go
224
star
59

parse-curl.js

Parse curl commands, returning an object representing the request.
JavaScript
217
star
60

go-progress

Another Go progress bar
Go
216
star
61

es

Go DSL for Elasticsearch queries
Go
206
star
62

co-prompt

sane terminal user-input for node.js using thunks / generators
JavaScript
192
star
63

node-cookie-signature

cookie signing
JavaScript
183
star
64

co-views

Higher-level template rendering for node.js using generators
JavaScript
175
star
65

d3-bar

D3 bar chart
JavaScript
173
star
66

node-only

return whitelisted properties of an object
JavaScript
170
star
67

ngen

nodejs project generator
JavaScript
168
star
68

react-hooks

Fire off actions in stateless components.
JavaScript
167
star
69

letterbox

Go program to batch-process letter-boxing of photographs.
Go
164
star
70

go-search

Search Godoc.org via the command-line.
Go
159
star
71

co-monk

MongoDB generator goodness for node.js
JavaScript
155
star
72

eson

Extended (pluggable) JSON for node - great for configuration files and JSON transformations
JavaScript
150
star
73

growl

Ruby growlnotify 'bindings' (unobtrusive notification system)
Ruby
146
star
74

go

Go packages
Go
140
star
75

d3-series

D3 line series chart used for error reporting on Apex Ping
JavaScript
139
star
76

node-amp

Abstract message protocol for nodejs
JavaScript
135
star
77

channel.js

Go-style channel implementation for JavaScript
JavaScript
135
star
78

burl

better curl(1) through augmentation
Shell
134
star
79

node-pwd

Hash and compare passwords with pbkdf2
JavaScript
132
star
80

jog

JSON document logging & filtering inspired by loggly for node.js
JavaScript
132
star
81

nedis

Redis server implementation written with nodejs
JavaScript
131
star
82

d3-circle

D3 circle chart
JavaScript
130
star
83

d3-dot

D3 dot chart
JavaScript
129
star
84

node-term-list

Interactive terminal list for nodejs
JavaScript
126
star
85

node-comment-macros

JavaScript comment macros useful for injecting logging, tracing, debugging, or stats related code.
JavaScript
126
star
86

d3-line

D3 line chart
JavaScript
125
star
87

asset

little asset manager for lazy people (think bundler/homebrew/npm for assets). written with node
JavaScript
122
star
88

go-dropbox

Dropbox v2 client for Go.
Go
120
star
89

node-term-css

style terminal output using CSS
JavaScript
116
star
90

go-terminput

Package terminput provides terminal keyboard input for interactive command-line tools.
Go
114
star
91

vscode-snippets

Personal VSCode snippets for Go, JS, Elm, etc.
114
star
92

nshell

scriptable command-line shell written with node.js
JavaScript
109
star
93

node-actorify

Turn any node.js duplex stream into an actor
JavaScript
108
star
94

co-parallel

Execute thunks in parallel with concurrency support
JavaScript
108
star
95

node-monquery

mongodb query language for humans
JavaScript
106
star
96

co-fs

nodejs core fs module thunk wrappers for "co"
JavaScript
105
star
97

axon-rpc

Axon RPC client / server
JavaScript
103
star
98

s3.js

S3 uploads from the browser.
JavaScript
100
star
99

spa

Tiny Single Page Application server for Go with `spa` command-line tool.
Go
94
star
100

d3-tipy

D3 tooltip
JavaScript
94
star