Skip to content

bjoern #
Find similar titles

Structured data

Category
Etc
Programming

Introduction #

bjoern is fast, ultra-lightweight WSGI server for CPython, written in C using libev event loop.

Features #

  • ~ 1000 lines of C code
  • Memory footprint ~ 600KB
  • Single-threaded and without coroutines or other crap
  • Can bind to TCP host:port addresses and Unix sockets (thanks @k3d3!)
  • Full persistent connection ("keep-alive") support in both HTTP/1.0 and 1.1, including support for HTTP/1.1 chunked responses

Requirements #

  • Python 2 installation with headers ("development package")
  • libev with headers
  • a C compiler (tested with GCC and Clang)

Installation #

$ pip install bjoern

Usage #

# Bind to TCP host/port pair:
bjoern.run(wsgi_application, host, port)

# TCP host/port pair, enabling SO_REUSEPORT if available.
bjoern.run(wsgi_application, host, port, reuse_port=True)

# Bind to Unix socket:
bjoern.run(wsgi_application, 'unix:/path/to/socket')

# Bind to abstract Unix socket: (Linux only)
bjoern.run(wsgi_application, 'unix:@socket_name')

Alternatively, the mainloop can be run separately:

bjoern.listen(wsgi_application, host, port)
bjoern.run()

You can also simply pass a Python socket(-like) object. Note that you are responsible for initializing and cleaning up the socket in that case.

bjoern.server_run(socket_object, wsgi_application)
bjoern.server_run(filedescriptor_as_integer, wsgi_application)

References: 1 https://github.com/jonashaag/bjoern 2 https://github.com/jonashaag/bjoern/wiki/Installation

Suggested Pages #

0.0.1_20210630_7_v33