Beholder

Under development

A simple CLI tool that watches files and runs commands based on it.

Installation

Check the releases page to get the correct URL for your platform and install with:

export BEHOLDER_VERSION="0.0.8"
export BEHOLDER_PLATFORM="linux_amd64"
curl -LO https://github.com/lucaschain/beholder/releases/download/${BEHOLDER_VERSION}/beholder_${BEHOLDER_VERSION}_${BEHOLDER_PLATFORM}.tar.gz

tar -xvzf beholder_${BEHOLDER_VERSION}_${BEHOLDER_PLATFORM}.tar.gz

sudo mv beholder /usr/local/bin

Usage

# this will start watching the files
beholder /tmp -- echo "I see that {file} was changed"

# Whenever a file in /tmp is changed, with a command like:
echo "hello" > /tmp/beholder_test.txt

# this will be printed:
# I see that /tmp/beholder_test.txt was changed

All WRITE operation events will trigger the command, but this can be changed with the --type flag:

beholder . --type CREATE --type WRITE -- cat {file}

Event types come from fsnotify, and you can check them all here. Here's a list with the ones that existed at the moment of writing this:

• CHMOD
• CREATE
• REMOVE
• RENAME
• WRITE

Watching for specific extensions:

beholder . --extension ".go" -- go test ./...

By default, non-zero exit codes doesn't stop the watch process. This can be changed through the allow-failing flag:

beholder . --allow-failing=false -- diff /my/old/file {file}