On Fri, Feb 4, 2011 at 8:01 AM, brett.cannon <python-check...@python.org> wrote: > +Stop Using :mod:`doctest` > +''''''''''''''''''''''''' > +While 2to3 tries to port doctests properly, it's a rather tough thing to do. > It > +is probably best to simply convert your critical doctests to :mod:`unittest`.
This advice strikes me as being *way* too strong. Perhaps something like: Consider limiting use of :mod:`doctest` =============================== While 2to3 tries to port doctests properly, it's a rather tough thing to do. If your test suite is heavily doctest dependent, then you may end up spending a lot of time manually fixing doctests. The two major avenues for dealing with this are to either port doctest based tests over to the unittest module (making them significantly easier for 2to3 to handle) or else to follow the guidelines below for writing 2/3 compatible source code in all doctests (making it so they should run unmodified on both Python versions). Cheers, Nick. -- Nick Coghlan | ncogh...@gmail.com | Brisbane, Australia _______________________________________________ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com