Skip to content

Latest commit

 

History

History
55 lines (37 loc) · 1.86 KB

README.md

File metadata and controls

55 lines (37 loc) · 1.86 KB

m2r

A mongrel2 backend handler written in Ruby, based on Zed's Python backend handler.

Usage/Examples

  • examples/http_0mq.rb is a test little servlet thing (based on what comes with mongrel2).
  • examples/rack_handler.rb is a Mongrel2 ruby handler rack handler mouthful, whose variables are probably a little off.
  • examples/lobster.ru is a rackup file using the Rack handler that'll serve Rack's funny little lobster app.

Running Examples

With rails3: Add this to your Gemfile:

gem 'ffi'
gem 'ffi-rzmq'
gem 'json'

And this to your config.ru:

$: << location_to_m2r + '/example'
require 'rack_handler'

Rack::Handler::Mongrel2.run YourRailsAppName::Application

Then do all like bundle exec rackup

Installation

  • JRuby 1.5+ (don't use MRI - it will crash horribly, check the ISSUES file)
  • FFI, gem install ffi should be fine.
  • Zero MQ, you'll need to compile and install to get the headers and such for:
  • ffi-rzmq, which you'll have to build. The native zmq didn't work for me, but if you want to fix it, please do!
  • json, since the headers are returned in JSON, which is RAD. (Really Awesome, Dude)
  • Rack gem install rack if you want to run the rack example.

Contributing

Once you've made your great commits:

  1. Fork m2r
  2. Create a topic branch - git checkout -b my_branch
  3. Push to your branch - git push origin my_branch
  4. Send a pull request