[Twisted-Python] Re: Components

[Christopher Armstrong]

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
---------+           http://radix.twistedmatrix.com/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 256 bytes
Desc: OpenPGP digital signature
Url : http://twistedmatrix.com/pipermail/twisted-python/attachments/20040227/7fb6cbf3/attachment.pgp