test_support: add a docstring to vereq().
test_complex: repair new test's usage of vereq().
diff --git a/Lib/test/test_complex.py b/Lib/test/test_complex.py
index 1fa0ee0..ff7bb14 100644
--- a/Lib/test/test_complex.py
+++ b/Lib/test/test_complex.py
@@ -63,8 +63,7 @@
if complex(0.0, 0.0):
raise TestFailed("complex(0.0, 0.0) should be false")
-if vereq(complex(5.3, 9.8).conjugate(), 5.3-9.8j):
- raise TestFailed("complex.conjugate() didn't work")
+vereq(complex(5.3, 9.8).conjugate(), 5.3-9.8j)
try:
print int(5+3j)
diff --git a/Lib/test/test_support.py b/Lib/test/test_support.py
index 83bde3e..4a45617 100644
--- a/Lib/test/test_support.py
+++ b/Lib/test/test_support.py
@@ -118,6 +118,16 @@
raise TestFailed(reason)
def vereq(a, b):
+ """Raise TestFailed if a == b is false.
+
+ This is better than verify(a == b) because, in case of failure, the
+ error message incorporates repr(a) and repr(b) so you can see the
+ inputs.
+
+ Note that "not (a == b)" isn't necessarily the same as "a != b"; the
+ former is tested.
+ """
+
if not (a == b):
raise TestFailed, "%r == %r" % (a, b)