GeezerVison is showing github.com — Additional assert methods for unittest · Issue #71339 · python/cpython
Additional assert methods for unittest #71339Description
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields:
assignee = None
closed_at = None
created_at = <Date 2016-05-29.15:25:19.795>
labels = ['type-feature', 'tests']
title = 'Additional assert methods for unittest'
updated_at = <Date 2016-06-22.14:03:21.198>
user = 'https://github.com/serhiy-storchaka' bugs.python.org fields:
activity = <Date 2016-06-22.14:03:21.198>
actor = 'r.david.murray'
assignee = 'none'
closed = False
closed_date = None
closer = None
components = ['Tests']
creation = <Date 2016-05-29.15:25:19.795>
creator = 'serhiy.storchaka'
dependencies = []
files = ['43047']
hgrepos = []
issue_num = 27152
keywords = ['patch']
message_count = 10.0
messages = ['266600', '266601', '266620', '266627', '266675', '266682', '267175', '267185', '268877', '269074']
nosy_count = 8.0
nosy_names = ['rhettinger', 'rbcollins', 'ezio.melotti', 'r.david.murray', 'michael.foord', 'Pam.McANulty', 'serhiy.storchaka', 'ChrisBarker']
pr_nums = []
priority = 'normal'
resolution = None
stage = 'patch review'
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue27152'
versions = ['Python 3.6'] Linked PRs
Activityserhiy-storchaka commented on May 29, 2016 Proposed patch adds the ExtraAssertions mix-in that provides additional assert methods. These methods provide better failure report than assertTrue/assertFalse with a result of corresponding function. For example assertStartsWith outputs shorten reprs of the start of the string and prefix.
These checks are quite popular and can be used tens or hundreds times in tests (the patch makes tests using new assert methods):
assertHasAttr 121 times
assertNotHasAttr 99 times
assertIsSubclass 243 times
assertNotIsSubclass 95 times
assertStartsWith 131 times
assertEndsWith 73 times serhiy-storchaka commented on May 29, 2016 Additional statistics that proves that specified checks are not specific for narrow group of tests:
assertHasAttr 121 times in 57 files
assertNotHasAttr 99 times in 31 files
assertIsSubclass 243 times in 30 files
assertNotIsSubclass 95 times in 5 files
assertStartsWith 131 times in 59 files
assertEndsWith 73 times in 36 files bitdancer commented on May 29, 2016 Why a mixin?
(As an aside, there is a proposal to move all assert methods to a place where they can be accessed outside test cases.) serhiy-storchaka commented on May 29, 2016 I have this proposal (bpo-19645) in mind. We can add these method just in TestCase.
In any case I'm going to add the ExtraAssertions mixin in test.support in maintained versions to help keeping branches in sync. rhettinger commented on May 30, 2016 I don't really like the assertEndsWith method which triggers a mental hiccup when taking a familiar method call, making it into function call, and giving an awkward looking camelcase name.
Also, Guido is usually opposed to broad, sweeping search/replace patches. Instead, he has advocated "holistic refactoring" where updates are done by someone actively working on the module rather than a disinterested party churning the code without thinking deeply about the topic at hand. serhiy-storchaka commented on May 30, 2016 Changes in tests are provided as a demonstration that these methods are useful. I propose to commit only the unittest part, and use new methods on a case-by-case basis. For example some tests already define methods like assertHasAttr or assertIsSubclass, They can now use standard methods.
assertEndsWith() can be used 73 times in 36 files. It produces more useful error report than assertTrue(a.endswith(b)). PythonCHB commented on Jun 3, 2016 Why a mixin rather than adding to TestCase? If they are useful they should be easy to find.
Also, see bpo-27198 for another possible new assert. rbtcollins commented on Jun 3, 2016 rhettinger commented on Jun 20, 2016 Ask five people to spell "assertEndsWith" and see how many of them capitalize the "W". bitdancer commented on Jun 22, 2016 I would expect it to be assertEndswith, etc. You will note that all the other cases of multiple capitals are either englishification of symbolic operators or concatenations of separate type words and/or syntactically distinct operators. gpshead commented on Jun 13, 2023 absl.testing.absltest includes some of these methods.
In particular assertStartsWith and assertEndsWith (and Not variants) are its simplest addition. I "only" see those used 2-3000 test files in our huge internal codebase which puts it in a <10% use them category. Their goal is to provide a nice error message, it does that. Those 2-4 would be trivial additions with no maintenance burden. (I'd go with 2, the negative Not variants see almost no use in practice).
Outside of the stdlib I assume pytest may provide nice output on startswith and endwith comparison failures?
As for the method name spelling, anyone typing it wrong gets a failure immediately so that isn't a big deal, rapid feedback when wrong. They're fully consistent with the junit javaCaseStyle of unittest assertion methods with words delineated by a case change.
MetadataMetadataStatusShow more project fields
DevelopmentNo branches or pull requestsIssue actions
|