Unicorn family Rack handlers for you. Mostly for `rails s`
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config
lib
script
task @ abca6ed
test
.gitignore
.gitmodules
.travis.yml
CHANGES.md
Gemfile
README.md
Rakefile
config.ru
rack-handlers.gemspec

README.md

rack-handlers Build Status Coverage Status

by Lin Jen-Shin (godfat)

LINKS:

DESCRIPTION:

Unicorn family Rack handlers for you. Mostly for rails s.

REQUIREMENTS:

  • Rack
  • The web server you want to use (e.g. unicorn, yahns, rainbows, zbatery, etc)

INSTALLATION:

gem install rack-handlers

SYNOPSIS:

For rails s, put this into your Gemfile:

group :development do
  gem 'rack-handlers', :require => 'rack/handler/rails-server'
end

gem 'unicorn'

And don't forget your favourite unicorns, then you could do the following:

rails s # a sensible default
rails s unicorn
rails s yahns
rails s rainbows
rails s zbatery

Because requiring 'rack-handlers' would make Rack::Handler.default pick the server with the following order:

  • yahns
  • zbatery
  • rainbows
  • unicorn
  • torquebox (for jruby)
  • trinidad (for jruby)
  • puma
  • thin
  • webrick

Thus if you have rainbows installed, rails s would launch the server with rainbows instead of webrick (the original behaviour).

Additionally, it would also try to load the config via config/yahns.rb, or config/unicorn.rb depending on which server is picked.

For people who likes to run rails s!

What if my config file is not located in config/unicorn.rb?

Then you could use the newly added option -C, or --CONFIG:

rails s -C config/twilight.rb
rails s --CONFIG config/rarity.rb

So that it would overwrite the default config path.

CONTRIBUTORS:

  • John Goulah (@jgoulah)
  • Lin Jen-Shin (@godfat)

LICENSE:

Apache License 2.0

Copyright (c) 2012-2016, Lin Jen-Shin (godfat)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.