On Wed, Jul 27, 2011 at 06:36, R. David Murray <rdmur...@bitdance.com>wrote:
> On Wed, 27 Jul 2011 16:14:40 +0300, Eli Bendersky <eli...@gmail.com> > wrote: > > 1. In the documentation of test.support mention explicitly that it's code > > for CPython's internal use only, and these APIs aren't guaranteed to be > > stable. > > This was already done. > > > 2. Some functions like unlink and rmtree are obviously redundant, and > shadow > > frequently used Python stdlib functions, so I would either kill them > > completely or at least rename them appropriately. > > But they aren't redundant, since the test.support versions ignore > errors. > > Perhaps what we could do is move the documentation for test.support to > the devguide, and then vet the test suite so that unlink and friends > are always called as 'support.unlink', etc. > I like this solution since this issue of documenting test.support keeps coming up. Otherwise we can not document test.support, but then we need to do a pass through the module to make sure that the docstrings are properly updated and we start deprecating some of the stuff in there that is just pure cruft.
_______________________________________________ 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
