0.04
No commit activity in last 3 years
No release in over 3 years
Rack middleware to run each request within a Fiber
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies
 Project Readme

rack-fiber_pool

Dependency Status Coverage Status Build Status Code Climate

A Rack middleware component which runs each request in a Fiber from a pool of Fibers.

Requirements

  • Ruby 1.9
  • EventMachine-based server (e.g. thin or rainbows)

Usage

Add a require and use statement to your Rack app. See example/app.rb for a simple Sinatra app which illustrates proper usage. In general, you want the FiberPool to be inserted as early as possible in the middleware pipeline.

Options

You may fix the pool size, otherwise it defaults to 100:

use Rack::FiberPool, :size => 25

All exceptions raised by request handled within a fiber are rescued, by default returning a 500 with no body content. You may customize exceptions rescuing by providing a Proc object conforming to Rack's API:

rescue_exception = Proc.new { |env, exception| [503, {}, exception.message] }
use Rack::FiberPool, :rescue_exception => rescue_exception

Rails

You can see your app's current pipeline of Rack middleware using:

rake middleware

Add Rack::FiberPool to your middleware in config/environment.rb:

require 'rack/fiber_pool'
Rails::Initializer.run do |config|
  config.middleware.use Rack::FiberPool
  config.threadsafe!
end

If you do experience odd issues, make sure it appears as early in the pipeline as possible. Anything that sets/gets thread local variables (like the Rails' session) or performs I/O should be later in the pipeline. For example, ActionController::Session::CookieStore does not work if it appears before Rack::FiberPool.

You can explicitly place the FiberPool like so:

ActionController::Dispatcher.middleware.insert_before ActionController::Session::CookieStore, Rack::FiberPool

Thanks to

Eric Wong - for adding explicit support for Rack::FiberPool to rainbows.

Changes

0.9.3 - fix incompatibility with sinatra streaming, new maintainer (alebsack) 1.0.0.beta.1 - Refactor, maintaining compatibility

Authors

Adam Lebsack, Github, alebsack AT gmail.com.

Mike Perham, Twitter, Github, mperham AT gmail.com.