Summary

Small and simple standalone router, meant for use with Rack applications.

Features

• Familiar Sinatra-like DSL for defining actions
• Modular architecture (see ROUTING ENGINES section)
• No magic
• Low level / Highly flexible
• Simple code

Examples

class App include SimpleRouter::DSL

get '/' do
  'home'
end

get '/archives/:year/:month/:day' do |year, month, day|
  Article.archived.find_by_date(year, month, day)
end

def call(env)
  verb, path  = ENV['REQUEST_METHOD'], ENV['PATH_INFO']
  route = self.class.routes.match(verb, path)
  route.nil? ?
    [404, {'Content-Type' => 'text/html'}, '404 page not found'] :
    [200, {'Content-Type' => 'text/html'}, route.action.call(*route.values)]
end

end

The SimpleRouter::DSL mixin provides 5 class methods:

#get, #post, #put, #delete and #routes

The four verb methods allow you to define actions that will match a request for the verb and route signature it defines.

The #routes method responds to #match and will return the first matching route (in order they were defined), and the values of the variables defined in the route signature if any (:year, :month, ...).

Finally, the route returned is a simple object: for the second route in the example above:

route.verb #=> :get route.path #=> '/archives/:year/:month/:day' route.action #=> lambda {|year, month, day| Article.archived.find_by_date(year, month, day) } route.values #=> ['2008', '07', '01'] # after being matched with path '/archives/2008/07/01'

See examples/ directory for executable code examples.

Routing Engines

By design, the code is seperated in two main components:

o DSL for defining routes/actions and retrieving requested action block. o Routing engine

Different engines can be used by assigning them to the router:

SimpleRouter.engine = UltraFastEngine

This allows, for instance, a new faster engine to be used by an app without changes in the top level DSL.

Engines can also allow route definitions to include more (or less!) features. For example, the built-in SimpleEngine allows route variables and extension handling. Others could add variable conditions ( :id => Integer ), mime-type restrictions, etc.

Engine Writers

Engines only need to conform to a simple interface. See lib/simple_router/engines/simple_engine.rb for details.