Class: Rack::Builder

Inherits:
Object
  • Object
show all
Defined in:
lib/rack/builder.rb

Overview

Rack::Builder implements a small DSL to iteratively construct Rack applications.

Example:

app = Rack::Builder.new {
  use Rack::CommonLogger
  use Rack::ShowExceptions
  map "/lobster" do
    use Rack::Lint
    run Rack::Lobster.new
  end
}

Or

app = Rack::Builder.app do
  use Rack::CommonLogger
  lambda { |env| [200, {'Content-Type' => 'text/plain'}, 'OK'] }
end

use adds a middleware to the stack, run dispatches to an application. You can use map to construct a Rack::URLMap in a convenient way.

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(&block) ⇒ Builder

Returns a new instance of Builder.



27
28
29
30
# File 'lib/rack/builder.rb', line 27

def initialize(&block)
  @ins = []
  instance_eval(&block) if block_given?
end

Class Method Details

.app(&block) ⇒ Object



32
33
34
# File 'lib/rack/builder.rb', line 32

def self.app(&block)
  self.new(&block).to_app
end

Instance Method Details

#call(env) ⇒ Object



59
60
61
# File 'lib/rack/builder.rb', line 59

def call(env)
  to_app.call(env)
end

#map(path, &block) ⇒ Object



44
45
46
47
48
49
50
51
# File 'lib/rack/builder.rb', line 44

def map(path, &block)
  if @ins.last.kind_of? Hash
    @ins.last[path] = self.class.new(&block).to_app
  else
    @ins << {}
    map(path, &block)
  end
end

#run(app) ⇒ Object



40
41
42
# File 'lib/rack/builder.rb', line 40

def run(app)
  @ins << app #lambda { |nothing| app }
end

#to_appObject



53
54
55
56
57
# File 'lib/rack/builder.rb', line 53

def to_app
  @ins[-1] = Rack::URLMap.new(@ins.last)  if Hash === @ins.last
  inner_app = @ins.last
  @ins[0...-1].reverse.inject(inner_app) { |a, e| e.call(a) }
end

#use(middleware, *args, &block) ⇒ Object



36
37
38
# File 'lib/rack/builder.rb', line 36

def use(middleware, *args, &block)
  @ins << lambda { |app| middleware.new(app, *args, &block) }
end