Sha256: 48390869bc3cb0e079b9c42ac2ac7bb3a2c9d2f3bb570d28a626cfe347705d90

Contents?: true

Size: 1.92 KB

Versions: 26

Compression:

Stored size: 1.92 KB

Contents

module Rack
  # 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 Builder
    def self.parse_file(config, opts = Server::Options.new)
      options = {}
      if config =~ /\.ru$/
        cfgfile = ::File.read(config)
        if cfgfile[/^#\\(.*)/] && opts
          options = opts.parse! $1.split(/\s+/)
        end
        cfgfile.sub!(/^__END__\n.*/, '')
        app = eval "Rack::Builder.new {( " + cfgfile + "\n )}.to_app",
          TOPLEVEL_BINDING, config
      else
        require config
        app = Object.const_get(::File.basename(config, '.rb').capitalize)
      end
      return app, options
    end

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

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

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

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

    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

    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

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

Version data entries

26 entries across 25 versions & 7 rubygems

Version Path
rack-1.2.8 lib/rack/builder.rb
rack-1.1.6 lib/rack/builder.rb
rack-1.2.7 lib/rack/builder.rb
rack-1.1.5 lib/rack/builder.rb
rack-1.2.6 lib/rack/builder.rb
rack-1.1.4 lib/rack/builder.rb
radiant-1.0.0 ruby-debug/ruby/1.8/gems/rack-1.1.3/lib/rack/builder.rb
rack-1.2.5 lib/rack/builder.rb
rack-1.1.3 lib/rack/builder.rb
vanity-1.7.1 vendor/ruby/1.9.1/gems/rack-1.1.2/lib/rack/builder.rb
rack-1.2.4 lib/rack/builder.rb
rack-1.2.3 lib/rack/builder.rb
rack-1.2.2 lib/rack/builder.rb
rack-1.1.2 lib/rack/builder.rb
rack-1.1.1 lib/rack/builder.rb
rack-1.1.1.pre lib/rack/builder.rb
edgar-rack-1.2.1 lib/rack/builder.rb
eac-rack-1.1.1 lib/rack/builder.rb
rack-1.2.1 lib/rack/builder.rb
rack-1.2.0 lib/rack/builder.rb