views:

697

answers:

12

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).

+6  A: 

Django

samoz
+9  A: 

Not completely sure about the latter two, but Twisted and Django are both very well written/organised/documented

dbr
Twisted? Really? I personally think it has an apt name. :-)
Jason Baker
Twisted documentation is horrid. Django documentation is much much better.
Unknown
A: 

BitTorrent?

Ken
+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
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
+2  A: 

SQLAlchemy

S.Lott
+5  A: 

Reddit. I've learned quite a bit about using Python for web development by browsing their source code.

Dave K
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
A: 

And actually, several project from Edgwall are in this case.

Vincent Demeester
A: 

Sphinx

S.Lott
+1  A: 

SCons, the only Python application I've come to like and use.

akauppi
+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
A: 

I recently took a look over buildbot's code and it looked nice. See here

hyperboreean
A: 

Bazaar

miya