This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: TestProgram is mentioned in the unittest docs but is not documented
Type: enhancement Stage:
Components: Documentation Versions: Python 3.11, Python 3.10, Python 3.9
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: beng94, brett.cannon, docs@python, ezio.melotti, michael.foord, r.david.murray
Priority: normal Keywords: easy

Created on 2014-01-02 18:01 by r.david.murray, last changed 2022-04-11 14:57 by admin.

Messages (3)
msg207178 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2014-01-02 18:01
IMO, TestProgram should either be made anonymous in the docs ('main returns an object that has a results attribute...') or its external API should be formally documented.  If results is the only external API other than its init (which is documented as unittest.main), then I would suggest the former.  In either case exactly what 'results' contains should be clarified.
msg259728 - (view) Author: Tamás Bence Gedai (beng94) * Date: 2016-02-06 14:21
I think TestProgram should be anonymous, all the work is done in its constructor. I don't see why would anyone would call its functions. I can update the docs if it's needed.
msg259831 - (view) Author: Michael Foord (michael.foord) * (Python committer) Date: 2016-02-08 09:37
TestProgram is an abomination, but it has been publicly exposed in unittest since forever.
History
Date User Action Args
2022-04-11 14:57:56adminsetgithub: 64308
2021-06-22 22:48:08brett.cannonsetnosy: + brett.cannon
2021-06-21 10:49:37iritkatrielsetkeywords: + easy
versions: + Python 3.9, Python 3.10, Python 3.11, - Python 2.7, Python 3.3, Python 3.4
2016-02-08 09:37:54michael.foordsetmessages: + msg259831
2016-02-06 14:21:38beng94setnosy: + beng94
messages: + msg259728
2014-02-15 15:21:22ezio.melottisetnosy: + ezio.melotti, michael.foord
type: enhancement
2014-01-02 18:01:47r.david.murraycreate