[Zope3-dev] Re: [Zope-Checkins] CVS: Zope3/src/persistent/tests-test_persistent.py:1.5 persistent.txt:1.2

[Chris Withers]

Tim Peters wrote:

>>>>import doctest
>>>>import junk
>>>>print doctest.testsource(junk, 'A')
> 
> a = A()
> print type(a) is A
> # Expect:
> # True

cool :-)

> Why is that a concern?  For example, did you struggle with understanding the
> meaning of class A's docstring above (I assume your mail reader doesn't
> understand doctest or Python)?  Did you struggle with the Python tutorial
> (which is darned close to *being* a doctest, except because it isn't really
> some of the tutorial examples are always out of synch with what current
> Python actually does).  Good doctests typically have blocks of English
> exposition interspersed with small snippets of Python, and read like a
> tutorial, or like a paper containing Python examples.

Yes, but how'd you guys fancy writing all those >>> and ...'s?

Chris

-- 
Simplistix - Content Management, Zope & Python Consulting
            - http://www.simplistix.co.uk