Routing for Raxx applications.

Routes are defined as a match and an action module. Standard Elixir pattern matching is used to apply the match to an incoming request. An action module another implementation of Raxx.Server

Sections group routes that all have the same middleware. Middleware in a section maybe defined as a list, this is useful when all configuration is known at compile-time. Alternativly an arity 1 function can be used. This can be used when middleware require runtime configuration. The argument passed to this function is server initial state.

Examples

defmodule MyRouter do
  use Raxx.Router

  section [{Raxx.Logger, level: :debug}], [
    {%{method: :GET, path: ["ping"]}, Ping},
  ]

  section &web/1, [
    {%{method: :GET, path: []}, HomePage},
    {%{method: :GET, path: ["users"]}, UsersPage},
    {%{method: :GET, path: ["users", _id]}, UserPage},
    {%{method: :POST, path: ["users"]}, CreateUser},
    {_, NotFoundPage}
  ]

  def web(state) do
    [
      {Raxx.Logger, level: state.log_level},
      {MyMiddleware, foo: state.foo}
    ]
  end
end

The original API is kept for backwards compatibility. See previous docs for details.

If the sections DSL does not work for an application it is possible to instead just implement a route/2 function.