============================
Klein, a Web Micro-Framework
============================

Klein is a micro-framework for developing production-ready web services with Python.
It's built on widely used and well tested components like Werkzeug and Twisted, and has near-complete test coverage.

Klein is developed by a team of contributors `on GitHub <https://github.com/twisted/klein>`_.
We're also commonly in ``#twisted`` on `Libera.Chat <https://libera.chat/>`_.


Introduction to Klein
=====================

This is an introduction to Klein, going through from creating a simple web site to something supporting AJAX and more.

.. toctree::
    :maxdepth: 1

    introduction/1-gettingstarted
    introduction/2-twistdtap


Klein Examples
==============

These are examples that show how to use different parts of Klein, or use things with Klein.

.. toctree::

    examples/staticfiles
    examples/templates
    examples/deferreds
    examples/await
    examples/twistd
    examples/handlingpost
    examples/subroutes
    examples/nonglobalstate
    examples/handlingerrors
    examples/alternativerunning
    examples/disablingtracebacks


Contributing
============

If you'd like to help out, here's some material to help you get started!

.. toctree::

    contributing
    release