README.md

Path: README.md
Last Update: Fri Oct 01 08:56:42 +0000 2010

# Rerun

<github.com/alexch/rerun>

Launches your app, then watches the filesystem. If a relevant file changes, then it restarts your app.

Currently only *.rb files are watched. This is pretty lame so it will change soon.

If you‘re on Mac OS X, it uses the built-in facilities for monitoring the filesystem, so CPU use is very light. And if you have "growlnotify" available on the PATH, it sends notifications to growl in addition to the console. Here‘s how to install [growlnotify](growl.info/documentation/growlnotify.php):

> In your shell, cd to the directory on the Growl disk image > containing growlnotify, and type ./install.sh. That script > will install growlnotify to /usr/local/bin and the manpage > to /usr/local/man.

Rerun does not work on Windows. Sorry, but you can‘t do much relaunching without "fork".

# Installation:

        sudo gem install rerun

If you want to use the latest version, grab it off Github:

        gem sources -a http://gems.github.com/
        sudo gem install alexch-rerun

I‘ll bump the version on Github for release candidates, and deploy to Rubyforge only when it‘s had some time to bake.

# Usage:

        rerun [options] cmd

For example, if you‘re running a Sinatra app whose main file is app.rb:

        rerun "ruby app.rb"

Or if you‘re running a Rack app that‘s configured in config.ru but you want it on port 4000 and in debug mode:

        rerun "thin start --debug --port=4000 -R config.ru"

# Options:

[Validate]