= Welcome! =

''Diva'' is a a lightweight web framework for Python that is built on top of [http://www.python.org/dev/peps/pep-0333/ WSGI] and tightly coupled to the [http://genshi.edgewall.org/ Genshi] template engine. It also uses [http://babel.edgewall.org/ Babel] for internationalization and [http://pythonpaste.org/webob/ WebOb] for an more convenient abstraction on top of raw WSGI.

== Big Fat Warning ==

The name ''diva'' was chosen for its negative connotation. Says [http://en.wikipedia.org/wiki/Diva#Negative_connotation Wikipedia]:

> The term is often used with a negative connotation. This derives from the implication that a star who is a "diva" is arrogant, difficult to work with, high-maintenance, manipulative, fussy, highly strung, privileged and demanding. He or she does not believe the law and accepted rules of courtesy apply to him or her.

So: '''You probably don't want to be using this'''. It's a sandbox where I play with various ideas for modern web application development, it doesn't make it easy to use a different template engine than Genshi, it doesn't help you with connecting to a relational database (or any kind of database, for that matter), it doesn't have fancy reusable widgets, and so on. And it's probably never going to do or have those things.

So why am I releasing this code in the first place. Because I don't like keeping spare time code to myself, and because it might serve as inspiration for others, or something like that.

== Documentation ==

Some very early and incomplete documentation:

 * ApplicationObject
 * DevelopmentServer
 * RequestHandlers
 * UrlRouting
 * FormProcessing
 * RequestFilters
 * ErrorHandling
 * ConfigOptions