I am looking for a well-engineered, well-built python application that could serve as a guideline to demonstrate best practices relating to software development in general, and more specifically in python. (Note that software in other languages would also be welcome provided they are of good quality and could serve as models of good architecture).
+9
A:
Not completely sure about the latter two, but Twisted and Django are both very well written/organised/documented
dbr
2009-04-09 22:54:28
Twisted? Really? I personally think it has an apt name. :-)
Jason Baker
2009-04-10 03:04:56
Twisted documentation is horrid. Django documentation is much much better.
Unknown
2009-04-14 07:23:16
+1
A:
Jinja 2. Not only its code but also the fantastic documentation that makes me wish every project had something like it.
Hao Lian
2009-04-09 23:07:41
You think so? I've mostly found jinja2's docs to be just barely enough. At least I haven't found it to be woefully underdocumented, but there are many times I'd like it to go into a bit more detail.
TokenMacGuy
2009-04-10 01:47:46
A:
I'll add docutils, and particularly its statemachine module. It's reasonably well designed and sticks to the basics (i.e. little or no metaclasses and the source isn't overrun with underscore methods like __getattr__
).
The project "eats its own dogfood" with all source code documentation for modules, classes, functions in reStructuredText format. Design and user documentation also written in reStructuredText.
Van Gale
2009-04-10 08:32:25
A:
Vincent Demeester
2009-04-10 08:48:08
+1 good one that I'd forgotten about. Won a design competition and has a good user manual as well as API and source documentation.
Van Gale
2009-04-10 11:49:37
A:
I recently took a look over buildbot's code and it looked nice. See here
hyperboreean
2009-04-10 11:28:19