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
}

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.

Instance Method Summary collapse

Constructor Details

#initialize(&block) ⇒ Builder

Returns a new instance of Builder.



20
21
22
23
 
# File 'lib/rack/builder.rb', line 20

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

Instance Method Details

#call(env) ⇒ Object 



52
53
54
 
# File 'lib/rack/builder.rb', line 52

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

#map(path, &block) ⇒ Object 



37
38
39
40
41
42
43
44
 
# File 'lib/rack/builder.rb', line 37

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

#run(app) ⇒ Object 



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

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

#to_app ⇒ Object 



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

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 



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

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