Installation

System Requirements

• Bash shell and a unix system environment.

Installation

No packaging exists for rerun. For now, simply "git clone" it.

cd /tmp
git clone git://github.com/dtolabs/rerun.git
cd rerun

After it is downloaded, invoke the rerun -help to see usage and version:

$ ./rerun -help
 _ __ ___ _ __ _   _ _ __
| '__/ _ \ '__| | | | '_ \ 
| | |  __/ |  | |_| | | | |
|_|  \___|_|   \__,_|_| |_|
Version: v0.1. License: Apache 2.0.

Usage: rerun [-h][-v][-V] [-M <dir>] [-L <dir>] [--checklog <file>] [module:[command [command_args]]]

Examples:
| $ rerun 
| => List all modules.
| $ rerun freddy
| => List all freddy commands.
| $ rerun freddy:dance -jumps 3
| => Execute the freddy dance command.

Run it without arguments to see a list of installed modules.

$ ./rerun 
[modules]
  stubbs: "Simple rerun module builder"

Successful installation results in a module listing (stubbs module is included by default).

If you care about system packaging (e.g. RPM, DEB), feel free to contribute your ideas. We're also thinking of building rerun modules distribution around git (ala homebrew).

Environment

Update your Bash profile (e.g., .bash_profile, .bashrc) to set the following environment variables.

PATH

Add the path to your rerun executable to your $PATH.

RERUN_MODULES

Rerun checks for an environment variable called $RERUN_MODULES that specifies a directory of rerun modules. If $RERUN_MODULES is not set, rerun checks the current working directory for a subdirectory called "modules".

RERUN_LOGS

Path to directory where rerun will write log files

RERUN_COLOR

Set 'true' if you want ANSI text effects

Example:

export PATH=$PATH:$HOME/.rerun/rerun
export RERUN_MODULES=$HOME/.rerun/modules
export RERUN_LOGS=$HOME/.rerun/logs
[ -t 0 ] && export RERUN_COLOR=true

Bash completion

Rerun's listing feature is available through Bash command completion. To enable it, update your .bash_profile with a line like so:

[ -r /path/to/rerun/bash_completion ] && { . /path/to/rerun/bash_completion ; }

Next steps

See README.md for general usage information.

The stubbs module is included and you'll find it useful to create your own modules.