============================

Klein, a Web Micro-Framework

.. image:: https://travis-ci.org/twisted/klein.png?branch=master :target: http://travis-ci.org/twisted/klein :alt: Build Status .. image:: https://codecov.io/github/twisted/klein/coverage.svg?branch=master :target: https://codecov.io/github/twisted/klein?branch=master :alt: Code Coverage

Klein is a micro-framework for developing production-ready web services with Python. It is 'micro' in that it has an incredibly small API similar to Bottle <http://bottlepy.org/docs/dev/index.html>_ and Flask <http://flask.pocoo.org/>. It is not 'micro' in that it depends on things outside the standard library. This is primarily because it is built on widely used and well tested components like Werkzeug <http://werkzeug.pocoo.org/> and Twisted <http://twistedmatrix.com>_.

A Klein bottle <https://en.wikipedia.org/wiki/Klein_bottle>_ is an example of a non-orientable surface, and a glass Klein bottle looks like a twisted bottle or twisted flask. This, of course, made it too good of a pun to pass up.

Klein's documentation can be found at Read The Docs <http://klein.readthedocs.org>_.

Example

This is a sample Klein application that returns 'Hello, world!', running on port 8080.

.. code-block:: python

from klein import run, route

@route('/')
def home(request):
    return 'Hello, world!'

run("localhost", 8080)

Contribute

klein is hosted on GitHub <http://github.com/twisted/klein>_ and is an open source project that welcomes contributions of all kinds from the community, including:

• code patches,
• documentation <http://klein.readthedocs.org/>_ improvements,
• bug reports <https://github.com/twisted/klein/issues>_,
• reviews for contributed patches <https://github.com/twisted/klein/pulls>_.

For more information about contributing, see the contributor guidelines <https://github.com/twisted/klein/tree/master/CONTRIBUTING.rst>_.