[issue9796] Add summary tables for unittest API

Ezio Melotti added the comment: And in 2.7 in 6e5b5d1b6714. There's some more refactoring that could be done on unittest.rst but it's out of the scope of this issue, so I'm closing this. -- resolution: -> fixed stage: commit review -> committed/rejected status: open -> closed ___

[issue9796] Add summary tables for unittest API

Ezio Melotti added the comment: The tables and several other doc changes went in 3.1 in cb3a925de1bd. -- ___ Python tracker ___ ___ Py

[issue9796] Add summary tables for unittest API

Terry J. Reedy added the comment: I just read through the 3.2 unittest doc and found and will find the new tables very helpful. I hope you get them into the upcoming 3.1.3 and 2.7.2 releases, even if you think them not complete ;-). -- nosy: +terry.reedy versions: +Python 3.3 ___

[issue9796] Add summary tables for unittest API

Ezio Melotti added the comment: I committed the patch in r86141 and a few other fixes in r86142 and r86143. There are still more things I want to fix before I backport all the patches to 3.1 and 2.7 and close the issue. -- stage: needs patch -> commit review _

[issue9796] Add summary tables for unittest API

Ezio Melotti added the comment: Updated patch after the changes made in r86118. -- Added file: http://bugs.python.org/file19467/issue9796-4.diff ___ Python tracker ___ __

[issue9796] Add summary tables for unittest API

Ezio Melotti added the comment: issue9796-3.diff improves the rendering of the HTML tables. (Note: the patch just adds the tables, short paragraphs before them and moves a few methods around to match the division and the order of the tables, without changing their content.) -- compon

[issue9796] Add summary tables for unittest API

Ezio Melotti added the comment: I implemented 2) and 3) in issue9796-2.diff. -- assignee: eric.araujo -> ezio.melotti Added file: http://bugs.python.org/file19458/issue9796-2.diff ___ Python tracker ___

[issue9796] Add summary tables for unittest API

Ezio Melotti added the comment: The attached patch adds a table with the most common assert* methods and their explanation at the top of the doc. There are however a few things that should imho be changed, but that will require some re-organization in the unittest doc: 1) now the table is on

[issue9796] Add summary tables for unittest API

Michael Foord added the comment: This has been on my 'todo list' for a long time. Feel free to get to it before me. Please *don't* include the now deprecated assert* methods in the table. I'd like to move all the deprecated methods to a separate section of the documentation. As Raymond says

[issue9796] Add summary tables for unittest API

Raymond Hettinger added the comment: Just focus on the table for assert* methods. This is the one category that users will need to look-up over and over again. The goal is to make the docs more usable, not more voluminous. Also, I suggest finding meaningful groupings (don't stick with alpha

[issue9796] Add summary tables for unittest API

Changes by Ezio Melotti : -- nosy: +ezio.melotti ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.pyt

[issue9796] Add summary tables for unittest API

New submission from Éric Araujo : Suggestion from Raymond: Add a table summarizing all assert* methods of TestCase. I will make a patch in some days or weeks. I think I’ll also add one table for the most useful objects from a user viewpoint (Loader, TestCase, main). See the docs of itertools a