Bandit

Documentation

Bandit is a pure Elixir HTTP server for Plug apps. It is currently very much a WiP but is maturing quickly (see Development Plan below for more information).

Bandit is built atop Thousand Island and as a result can provide scalable and performant HTTP services out of the box. By being the simplest thing that can get from HTTP requests to a Plug interface it is also simple and easy to understand. Bandit is written entirely in Elixir and has no runtime dependencies other than Thousand Island and Plug.

Project Goals

• Implement comprehensive support for HTTP/1.0 through HTTP/2.0 (and eventually beyond) backed by obsessive RFC literacy and automated conformance testing
• Aim for minimal internal policy and HTTP-level configuration. Delegate to Plug as much as possible, and only interpret requests to the extent necessary to safely manage a connection & fulfill the requirements of supporting Plug
• Define & provide a public API for WebSockets in the same vein as Plug to allow for Phoenix to support servers other than Cowboy
• Prioritize (in order): correctness, clarity, performance. Seek to remove the mystery of infrastructure code by being approachable and easy to understand

Development Plan

• 0.1.x series: Proof of concept (along with Thousand Island) sufficient to support HAP)
• 0.2.x series: Revise process model to accommodate forthcoming HTTP/2 and WebSocket adapters
• 0.3.x series: Implement HTTP/2 adapter
• 0.4.x series: Re-implement HTTP/1.x adapter
• 0.5.x series: Implement WebSocket extension
• 0.6.x series: Enhance startup options, complete & revise documentation & tests

Installation

Bandit is available in Hex. The package can be installed by adding bandit to your list of dependencies in mix.exs:

def deps do
  [
    {:bandit, "~> 0.2.0"}
  ]
end

Documentation can be found at https://hexdocs.pm/bandit.

License

MIT