[Python-checkins] python/dist/src/Misc NEWS,1.793,1.794

tim_one@users.sourceforge.net tim_one@users.sourceforge.net
Sat, 28 Jun 2003 22:30:50 -0700


Update of /cvsroot/python/python/dist/src/Misc
In directory sc8-pr-cvs1:/tmp/cvs-serv11324/Misc

Modified Files:
	NEWS 
Log Message:
Some nifty doctest extensions from Jim Fulton, currently used in Zope3.
I won't have time to write real docs, but spent a lot of time adding
comments to his code and fleshing out the exported functions' docstrings.
There's probably opportunity to consolidate how docstrings get extracted
too, and the new code for that is probably better than the old code for
that (which strained mightily to recover from 2.2's new class/type
gimmicks).


Index: NEWS
===================================================================
RCS file: /cvsroot/python/python/dist/src/Misc/NEWS,v
retrieving revision 1.793
retrieving revision 1.794
diff -C2 -d -r1.793 -r1.794
*** NEWS	29 Jun 2003 03:29:42 -0000	1.793
--- NEWS	29 Jun 2003 05:30:48 -0000	1.794
***************
*** 87,90 ****
--- 87,105 ----
  -------
  
+ - Some happy doctest extensions from Jim Fulton have been added to
+   doctest.py.  These are already being used in Zope3.  The two
+   primary ones:
+ 
+   doctest.debug(module, name) extracts the doctests from the named object
+   in the given module, puts them in a temp file, and starts pdb running
+   on that file.  This is great when a doctest fails.
+ 
+   doctest.DocTestSuite(module=None) returns a synthesized unittest
+   TestSuite instance, to be run by the unittest framework, which
+   runs all the doctests in the module.  This allows writing tests in
+   doctest style (which can be clearer and shorter than writing tests
+   in unittest style), without losing unittest's powerful testing
+   framework features (which doctest lacks).
+ 
  - ZipFile.testzip() now only traps BadZipfile exceptions.  Previously,
    a bare except caught to much and reported all errors as a problem