[Zope3-Users] Re: [Zope] Debugging doctests

[Chris McDonough]

On Feb 23, 2006, at 1:17 PM, Benji York wrote:

> Chris McDonough wrote:
>> I dunno about sucking because they are quite good for  
>> documentation,  but I tend to write plain-old unittests instead of  
>> doctests when I'm  testing without any pretense towards writing  
>> documentation.  If you  test internals of a class in a doctest,  
>> the doctest body gets pretty  cluttered, which tends to defeat the  
>> documentation-esque-ness of them.
>
> Are you talking about doctests in docstrings?  If so, I definitely  
> see downsides to that use case.  I was talking about doctests in  
> stand-alone text files.  That's my (and several others) preferred  
> way of using them.

Either.

>
> If you /were/ talking about stand-alone doctests, then I have no  
> idea what you're talking about. :)

It's just opinion, but for example, I don't think zope/wfmc/xpdl.txt  
reads much better as a doctest than it would as a plain old  
unittest.  But it's of course a judgment call.

- C