# Guard-rails is watching on your railses!

[![Gem Version](https://badge.fury.io/rb/guard-rails.png)](http://badge.fury.io/rb/guard-rails)
[![Build Status](https://travis-ci.org/ranmocy/guard-rails.png)](https://travis-ci.org/ranmocy/guard-rails)
[![Dependency Status](https://gemnasium.com/ranmocy/guard-rails.png)](https://gemnasium.com/ranmocy/guard-rails)
[![Code Climate](https://codeclimate.com/github/ranmocy/guard-rails.png)](https://codeclimate.com/github/ranmocy/guard-rails)

## Main repository
Currently, the official fork repository is at [ranmocy/guard-rails](http://github.com/ranmocy/guard-rails).
Please, come here and communicate with me.

## Install

Please make sure to have [Guard](https://github.com/guard/guard) installed before continue.

Add Guard::Rails to your `Gemfile`:

```ruby
group :development do
  gem 'guard-rails'
end
```

Add the default Guard::Rails template to your `Guardfile` by running:

```bash
$ guard init rails
```

Now I can automatically restart your Rails development server as your files changed!

## Lots of fun options growing!

* `:daemon` runs the server as a daemon, without any output to the terminal that ran `guard` (**default `false`**)
* `:debugger` enable the debugger in server. Required ruby-debug gem. (**default `false`**)
* `:environment` is the server environment (**default `development`**)
* `:force_run` kills any process that's holding the listen port before attempting to (re)start Rails (**default `false`**)
* `:pid_file` specify your pid\_file (**default `tmp/pids/[RAILS_ENV].pid`**)
* `:port` is the server port number (**default `3000`**)
* `:root` lets you specify the Rails root, i.e. for using guard-rails to run a dummy app within an engine (try `:root => '/spec/dummy'`).
* `:server` the webserver engine to use (**try `:server => :thin`**)
* `:start_on_start` will start the server when starting Guard (**default `true`**)
* `:timeout` waits when restarting the Rails server, in seconds (**default `30`**).
* `:zeus_plan` the [custom plan](https://github.com/burke/zeus/blob/master/docs/ruby/modifying.md) in zeus, only works when `zeus` option is `true` (**default `server`**)
* `:zeus` support [zeus](https://github.com/burke/zeus) to boost rails init speed (**default `false`**).
* `:CLI` construct the runner command as your willing! Will omit all options above except `pid_file`! (**default `rails server --pid tmp/pids/[RAILS_ENV].pid`**)

## How-to

* **Multiple instances** use `pid_file` option to run multiple instances with same rails\_env

## Philosophy

* **All Platforms** MRI is the main test case. But will be tested under REE and JRuby.
* **Live in edge** Ruby 1.8.7 has been deprecated. Guard-Rails will be tested under Ruby 1.9.3, 2.0.0 with newest gems. Will be rewrited with features of Ruby 2.0.0 as version 1.0.0.
* [Semantic Version](http://semver.org/)

## Contribute

The best choise to contact me is the Issues and Pull Request system on GitHub.
Currently the official fork repository is at [ranmocy/guard-rails](http://github.com/ranmocy/guard-rails).

Please, post your issue or pull request there.
And I will be there as your call.

## Contributor

* Ranmocy Sheng
* John Bintz
* Joel Moss
* Sidney Burks
* Paul Schyska
* Tim Preston
* Nathan Broadbent
* Adam Michel
* Benjamin Sullivan
* Everard Brown
* Darrin Holst
* Grant Hutchins and Jonathan Mukai-Heidt
* Michel Pavan Macedo
* cablegram