[Twisted-Python] Re: Components
radix at twistedmatrix.com
Fri Feb 27 14:14:57 EST 2004
David Bolen wrote:
> "Phillip J. Eby" <pje at 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
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 256 bytes
Desc: OpenPGP digital signature
Url : http://twistedmatrix.com/pipermail/twisted-python/attachments/20040227/7fb6cbf3/attachment.pgp
More information about the Twisted-Python