Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A screamingly fast Python WSGI server written in C.

tree: 70fe90a48f

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bjoern
Octocat-spinner-32 http-parser @ 1786fda Refactoring of @k3d3's initial Unix socket patch. January 15, 2012
Octocat-spinner-32 tests
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .gitmodules
Octocat-spinner-32 CHANGELOG
Octocat-spinner-32 KNOWN_ISSUES Fix header dict memory leak August 22, 2010
Octocat-spinner-32 LICENSE
Octocat-spinner-32 MANIFEST.in fixes December 07, 2010
Octocat-spinner-32 Makefile
Octocat-spinner-32 README.rst
Octocat-spinner-32 TODO
Octocat-spinner-32 setup.py
README.rst

bjoern: Fast And Ultra-Lightweight Asynchronous HTTP/1.1 WSGI Server

A screamingly fast, ultra-lightweight asynchronous WSGI server for CPython, written in C using Marc Lehmann's high performance libev event loop and Ryan Dahl's http-parser.

Why It's Cool

bjoern is the fastest, smallest and most lightweight WSGI server out there, featuring

  • ~ 1000 lines of C code
  • Memory footprint ~ 600KB
  • Single-threaded and without coroutines or other crap
  • Full persistent connection ("keep-alive") support in both HTTP/1.0 and 1.1, including support for HTTP/1.1 chunked responses

Installation

libev

Arch Linux
pacman -S libev
Ubuntu
apt-get install libev-dev
Fedora
yum install libev-devel
Mac OS X (using homebrew)
brew install libev
Your Contribution Here
Fork me and send a pull request

bjoern

For most users, the easiest way to install bjoern is using pip. Make sure libev is installed and then:

pip install bjoern

You can also build bjoern by directly using the provided setup.py file (this is probably most useful if you actually want to hack on bjoern):

python setup.py install

On some Linux systems (notably Fedora), the libev headers may be installed outside of the default include path. In order to build bjoern you will need to export CFLAGS when running setup.py, for instance:

CFLAGS=-I/usr/include/libev python setup.py install

Usage

bjoern.run(wsgi_application, host, port)

Alternatively, the mainloop can be run separately:

bjoern.listen(wsgi_application, host, port)
bjoern.run()
Something went wrong with that request. Please try again.