Terry J. Reedy added the comment: Doc issues should be 'tested' and reported against the latest versions. 2.6.6 doc is effectively the last 2.6 version. TextTextRunner is not completely undocumented. In 3.2

...

...

help(t.run) Help on function run in module unittest.runner:

run(self, test) Run the given test case or test suite. Searching on 'run(' finds near the top of the unittest chapter (2.7, 3.2): "A test runner is an object that provides a single method, run(), which accepts a TestCase or TestSuite object as a parameter, and returns a result object." I agree that the entry for TextTestRunner near the bottom should include one for .run, with at least the doc string, but maybe a backreference to the discussion near the top. It is not clear to me how TextTestRunner is expected to be used. Does unittest.main instantiate one, and call run, behind the scenes? ---------- nosy: +michael.foord, terry.reedy versions: +Python 2.7, Python 3.1, Python 3.2, Python 3.3 -Python 2.6 _______________________________________ Python tracker http://bugs.python.org/issue11385 _______________________________________

Michael Foord added the comment: Except the former is incorrect as the responsibility for printing results as they occur is with the TestResult and not the runner. I'll look at this and improve the docs for the runner. (And yes unittest.main() creates and uses a runner under the hood. It is frequently used directly by test frameworks as well though.) ---------- _______________________________________ Python tracker http://bugs.python.org/issue11385 _______________________________________

Michael Foord added the comment: TextTestRunner was more meant to be an *example* of a test runner. It just turned out to be the only one and widely used. ---------- _______________________________________ Python tracker http://bugs.python.org/issue11385 _______________________________________

Changes by Michael Foord : ---------- assignee: docs@python -> michael.foord _______________________________________ Python tracker http://bugs.python.org/issue11385 _______________________________________

Changes by Julian Berman : ---------- nosy: +Julian _______________________________________ Python tracker http://bugs.python.org/issue11385 _______________________________________