starlight /

Filename Size Date modified Message
22 B
1.1 KB
1.4 KB
Starlight is a Web framework written in Python and based on Werkzeug. Though
Werkzeug is very powerful, it is also comparatively low-level - simple apps
written in it require a lot of common code to route URLs, trap HTTP errors,
build the request, etc. Starlight acts as a layer on top of Werkzeug, handling
the things like routing and request generation itself so you just have to
write the business logic.

The basic way to use Starlight is to subclass ``starlight.App`` and provide
methods. These methods should be decorated with ``@dispatch(route)``, where
``route`` is a Werkzeug URL routing specification. Their first argument is
self, and the rest are any parameters captured from the route as
keyword arguments. You can access the request from the ``request`` object,
which is included in a ``from starlight import *``, but lives in
``starlight.utils``. More documentation is forthcoming, but until then you can
look at the apps in the ``examples`` folder.

Starlight's home page, bug tracker, and Mercurial repository are at

Starlight is released under the MIT license, which is reproduced in the
COPYING file. In addition to that legal notice, here is a blessing:

    May you do good and not evil.
    May you find forgiveness for yourself and forgive others.
    May you share freely, never taking more than you give.