David Bolen wrote:
"Phillip J. Eby" <pje@telecommunity.com> writes:
So, if you are creating a framework of any significance, your users will in all likelihood thank you for using the pure style instead of the ABC style, unless you have exceedingly strong discipline as far as being able to keep implementation out of the ABC, or are separately specifying/documenting the expected behavior anyway.
Speaking of documentation and convenience for users, it's nice when inheriting from an ABC interface lets tools such as epydoc automatically inherit the documentation strings for the methods as well for classes that implement them. Otherwise, do you find yourself duplicating docstrings in the classes providing the interfaces, or how do you handle that aspect of things.
Hmm. I think the real solution to this is to make epydoc understand interfaces, and make it easy to see the interface-documentation when looking at its implementation. -- Twisted | Christopher Armstrong: International Man of Twistery Radix | Release Manager, Twisted Project ---------+ http://radix.twistedmatrix.com/