Go to file
Dustin C. Hatch e6774204a6 app: Return an empty string for HEAD requests
Some WSGI servers, e.g. Werkzeug, unconditionally attempt to iterate over the
application response, even for HEAD requests. If `None` is returned, then the
server will crash in this case, because it is not iterable. This commit alters
the behavior of `milla.Application` to return an empty string, which is
iterable and has the same effect of not sending a body.
2015-02-19 20:01:05 -06:00
.settings Started documentation 2011-03-13 16:48:16 -05:00
doc New documentation 2013-01-22 10:47:39 -06:00
src/milla app: Return an empty string for HEAD requests 2015-02-19 20:01:05 -06:00
.hgignore Update .hgignore 2012-10-16 19:54:31 -05:00
.hgtags Added tag 0.2 for changeset 2d04d03ce334 2013-01-22 13:01:28 -06:00
.project Started the Milla project, a simple WSGI web framework 2011-03-13 16:46:42 -05:00
.pydevproject Bump PyDev interpreter and grammer for Python 3 2012-11-27 17:26:34 -06:00
COPYING Added licensing information and boilerplate messages 2011-04-05 23:47:44 -05:00
MANIFEST.in Added an icon and support for automatically serving favicon.ico 2011-03-27 15:24:41 -05:00
README Added README 2013-01-22 12:00:56 -06:00
distribute_setup.py Added setup.py 2011-03-13 16:48:35 -05:00
milla.svg Added an icon and support for automatically serving favicon.ico 2011-03-27 15:24:41 -05:00
setup.cfg Version bump 2013-01-22 13:02:17 -06:00
setup.py Version bump 2013-01-22 13:02:17 -06:00

README

.. vim: set ft=rst :

=====
Milla
=====

*Milla* is a simple and lightweight web framework for Python. It built on top
of `WebOb`_ and thus implements the `WSGI`_ standard. It aims to be easy to use
while imposing no restrictions, allowing web developers to write code the way
they want, using the tools, platform, and extensions they choose.

To get started using *Milla* right away, visit `Downloads`_ to get the latest
version, then read the `Documentation`_.

Example
=======

.. code:: python

    from wsgiref import simple_server
    from milla.dispatch import routing
    import milla


    def hello(request):
        return 'Hello, world!'

    router = routing.Router()
    router.add_route('/', hello)
    app = milla.Application(router)

    httpd = simple_server.make_server('', 8080, app)
    httpd.serve_forever()


.. _WebOb: http://webob.org/
.. _WSGI: http://wsgi.readthedocs.org/
.. _Downloads: https://bitbucket.org/AdmiralNemo/milla/downloads
.. _Documentation: http://milla.readthedocs.org/