| Version 29 (modified by cmlenz, 16 years ago) (diff) |
|---|
Welcome!
Diva is a a lightweight web framework for Python that is built on top of WSGI and integrated with the Genshi template engine. It also uses Babel for internationalization and WebOb for a more convenient abstraction on top of raw HTTP/WSGI.
Big Fat Warning
The name Diva was chosen for its negative connotation (but also as an homage to a well-known web framework for Ruby). Says 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.
Seriously: You probably don't want to be using this. It's a sandbox where I play with various ideas for modern web application development. Specifically, it doesn't make it easy to use a different template engine, it doesn't help you connect to a relational database (or any kind of database, for that matter), it doesn't provide an automatic admin interface or even scaffolding, it doesn't have fancy reusable widgets, it doesn't have an authentication and authorization system, and so on. Hell, it doesn't even handle server-side sessions for you. And it's probably never going to do or have those things.
Also, I will be changing things, sometimes radically, without paying attention to preserving backwards compatibility.
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.
If you're looking for a lightweight and well-designed web application toolkit for Python that doesn't come with such a big fat warning, I'd recommend taking a good look at Werkzeug or CherryPy. And of course there are the heavyweights such as Django, Pylons, TurboGears, or Zope.
Documentation
Some very early and incomplete documentation:
- ApplicationObject
- RequestHandlers
- UrlRouting
- FormProcessing
- I18nAndL10n
- RequestFilters
- ErrorHandling
- ConfigOptions
- DevelopmentServer
Examples
This framework is being used “in production” for my own personal sites http://www.cmlenz.net/ and http://scratchpad.cmlenz.net/. The code for those two sites will be made available after I've cleaned it up a bit.
Some examples are also included in the repository:
Acknowledgements
Much of this framework has been built on ideas and patterns extracted from the Trac project, and many other parts have been inspired by other frameworks and libraries.
