[issue4899] doctest should support fixtures
David W. Lambert
report at bugs.python.org
Fri Jan 9 20:52:59 CET 2009
David W. Lambert <lambertdw at corning.com> added the comment:
I disagree. Purpose of __doc__ is to explain functionality all at once.
This command idiom is useful:
$ python -c 'from a_module import thing; help(thing)'
The doctest module is a lightweight nicety that helps verify that which
is suitable. The sufficiently simple algorithms of my code have doc
strings that are the complete test and explanation. For others I
provide both docstring and unit tests. But with many I explain the
arguments and output, possibly the algorithm in a doc string. Tests and
use case examples reside in the module's unit test.
I'm among the "Choose correct tool for the job. python comes with full
tool bag." group.
Python tracker <report at bugs.python.org>
More information about the Python-bugs-list