TestCase.assertEqual, assertRaises, setUp, and tearDown
assertEqual(first, second, msg=None)
assertTrue(expr, msg=None)
assertRaises(expected_exception, *args, **kwargs)
setUp()
tearDown()
setUpClass()
tearDownClass()Run two tests through TestResult and print the hook order. The tests pass, so failures and errors are both zero.
| Parameter | Description |
|---|---|
first, second | Values compared by assertEqual. A mismatch is a test failure, not an uncaught exception. |
expected_exception | The exception type that the code inside the assertRaises context must raise. |
Returns: Assertion methods return None on success. TestResult.wasSuccessful() is True when failures and errors are empty. testsRun is the number of test methods that ran.
Raises
AssertionError— A failed assertion is recorded as a failure on the result, not printed as a traceback in this example.
- The signatures above are TestCase methods as documented for Python 3.13. setUpClass and tearDownClass are class methods.
- This example does not use TextTestRunner, because that runner prints a timing line that can vary.
import unittest
events = []
class ArithmeticTest(unittest.TestCase):
@classmethod
def setUpClass(cls):
events.append("setUpClass")
@classmethod
def tearDownClass(cls):
events.append("tearDownClass")
def setUp(self):
events.append("setUp")
self.value = 2
def tearDown(self):
events.append("tearDown")
def test_equal(self):
events.append("test_equal")
self.assertEqual(self.value * 2, 4)
self.assertTrue(self.value > 0)
def test_raises(self):
events.append("test_raises")
with self.assertRaises(ValueError):
int("x")
suite = unittest.defaultTestLoader.loadTestsFromTestCase(ArithmeticTest)
result = unittest.TestResult()
suite.run(result)
print(result.wasSuccessful(), result.testsRun, len(result.failures), len(result.errors))
print(events)Expected output
True 2 0 0
['setUpClass', 'setUp', 'test_equal', 'tearDown', 'setUp', 'test_raises', 'tearDown', 'tearDownClass']