Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Guard::Passenger automatically restarts passenger when needed

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .travis.yml
Octocat-spinner-32 CHANGELOG.rdoc
Octocat-spinner-32 Gemfile
Octocat-spinner-32 Guardfile
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 Rakefile
Octocat-spinner-32 guard-passenger.gemspec
README.rdoc

Guard::Passenger

Guard::Passenger is the useful development server solution. The guard automatically starts Passenger and intelligently restarts the server when needed.

Install

Please be sure to have guard installed before continue.

Install the gem:

gem install guard-passenger

Add it to your Gemfile (inside test group):

gem 'guard-passenger'

Add guard definition to your Guardfile by running this command:

guard init passenger

Usage

Please read guard usage doc

Guardfile

Passenger guard can be really be adapted to all kind of rack project with Passenger. Please read guard doc for more info about Guardfile DSL.

Standard rails app

guard 'passenger' do
  watch(%|lib/.*\.rb|)
  watch(%|config/.*\.rb|)
end

Passenger standalone

Passenger standalone is used as default. You can pass options to the guard to disable or configure it. Guard::Passenger will start Passenger on startup and take it down on exit. By default Passenger standalone is activated and port is set to 3000.

Ping

You can choose to ping localhost:port(/path) after Passenger has been restarted, it's done asynchronously so it won't block other guards execution. If you set :ping to true, it will ping localhost:3000/, it you set :ping to a String, it will append the path to localhost:3000/ for the ping. If the ping responds with a non-5XX response, Passenger is considered as running, otherwise, there is probably a problem with Passenger.

Guard options

Guard::Passenger accepts some options for configuration.

# :standalone    boolean            run Passenger standalone                (default: true)
# :cli           string             options to pass to passenger command    (default: '--daemonize')
# :notification  boolean            Notifications enabled                   (default: true)
# :ping          boolean or string  ping localhost after Passenger restart  (default: false)
# :sudo          boolean or string  start Passenger under sudo              (default: false)

guard 'passenger', :standalone => false, :cli => '--daemonize --port 3001 --address my_app.local --environment production', :ping => '/foo', :sudo => 'rvmsudo' do
end

Development

Pull requests are very welcome! Make sure your patches are well tested. Please create a topic branch for every separate change you make.

Authors

Fabio Kuhn

Contributors Forks

Something went wrong with that request. Please try again.