[issue19006] UnitTest docs should have a single list of assertions

Roundup Robot added the comment: New changeset ddb8fa84a119 by Ezio Melotti in branch '2.7': #19006: fix wording in unittest docs. https://hg.python.org/cpython/rev/ddb8fa84a119 New changeset 84f34e8685de by Ezio Melotti in branch '3.5': #19006: fix wording in unittest docs.

[issue19006] UnitTest docs should have a single list of assertions

Ezio Melotti added the comment: Fixed, thanks for the review! -- resolution: -> fixed stage: commit review -> resolved status: open -> closed ___ Python tracker

[issue19006] UnitTest docs should have a single list of assertions

Kushal Das added the comment: The patch looks good to me. Commit :) -- ___ Python tracker ___ ___

[issue19006] UnitTest docs should have a single list of assertions

Ezio Melotti added the comment: Here's a patch. -- assignee: docs@python -> ezio.melotti keywords: +patch stage: -> commit review versions: +Python 3.5, Python 3.6 -Python 3.3, Python 3.4 Added file: http://bugs.python.org/file41462/issue19006.diff

[issue19006] UnitTest docs should have a single list of assertions

Changes by Nicholas H.Tollervey : -- nosy: +kushal.das, ntoll ___ Python tracker ___ ___

[issue19006] UnitTest docs should have a single list of assertions

Changes by Arnon Yaari : -- nosy: +wiggin15 ___ Python tracker ___ ___ Python-bugs-list

[issue19006] UnitTest docs should have a single list of assertions

Terry J. Reedy added the comment: I like the current division, but agree that The TestCase class provides a number of methods to check for and report failures, such as: is slightly misleading. I would change it to The TestCase class provides a number of methods to check for and report

[issue19006] UnitTest docs should have a single list of assertions

Roy Smith added the comment: The new text suggested by terry.reedy works for me. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19006 ___ ___

[issue19006] UnitTest docs should have a single list of assertions

Ezio Melotti added the comment: There's nothing fundamentally different about the two lists I made that division because the ones in the first table are the most common and widely used, and are quite general too. The second table contains assert methods about catching exceptions and

[issue19006] UnitTest docs should have a single list of assertions

New submission from Roy Smith: http://docs.python.org/2/library/unittest.html#assert-methods The docs say, The TestCase class provides a number of methods to check for and report failures, such as, and then when you scroll a couple of screens down, there's another list, There are also other

[issue19006] UnitTest docs should have a single list of assertions

Roy Smith added the comment: Adding a note that there are more methods in the tables below would be useful. Otherwise, you assume you've seen them all when you've read the first table. I agree that the assertions about exceptions and warnings belong in a different group, but I don't see any

[issue19006] UnitTest docs should have a single list of assertions

Ezio Melotti added the comment: One reason is that if I list all those assert methods first and keep the assertRaises/Warns in a separate group, they will be pushed way down, and people might miss them. I'll try to prepare a patch that adds links to the other tables and/or changes the wording