New methods

• assertNone(value, message='')
• assertNotNone(value, message='')
• assertTrue(value, message='') # fails unless value is boolean and True
• assertFalse(value, message='') # fails unless value is boolean and False
• assertIs(obj1, obj2, message='') # fails unless obj1 is obj2
• assertIsNot(value, message='') # fails if obj1 is obj2

assertEquals()

assertEquals(actual, expected, message='', epsilon=0)

assertEquals now actually shows you the two compared values if it fails. Also, I've added an epsilon keyword parameter, which supplants the use of assertAlmostEquals. If it is absent, all comparisons are exact. If it is specified, then assertEquals will only fail if the different between two floats is greater or equal to epsilon. If iterables are compared, the given epsilon is used to compare each of their elements. This is not recursively applied to nested iterables.

As in unittest, assertEqual is a synonym for assertEquals. None of the failXXX style aliases are supported by TestCasePlus.

assertRaises()

assertRaises(callable, expectedException, expected_message='')

Note that this is a reversal of the argument order in unittest. I wanted assertRaises to follow a (to me) more consistent and memorable 'actual, expected' ordering of its arguments. Uses of the traditional ordering are detected and warned about.

This also allows you to specify the message that the expected exception should contain, which can't be done in unittest.

run()

Use as you would unittest.main(). It can be passed a TestCase (or TestCasePlus) class, or an instance of TestSuite:

from unittestplus.run import run
from unittestplus.testcaseplus import TestCasePlus

class MyTest(TestCasePlus):
    pass # etc...

if __name__ == "__main__":
    run(MyTest)

The 'run()' function also accepts 'verbosity' (int) and 'descriptions' (bool) keyword args, which it passes on to unittest.TextTestRunner. Pass verbosity=2 and descriptions=1 to see the prettier output described below.

combine()

Combine can be given any number of TestCase classes or TestSuites, and will combine them all into a single TestSuite:

from unittestplus.run import combine, run
from unittestplus.testcaseplus import TestCasePlus

class FirstTest(TestCasePlus):
    pass

class SecondTest(TestCasePlus):
    pass

AllTests = combine(FirstTest, SecondTest)

if __name__ == '__main__':
    run(AllTests)

get_all_tests()

Your top-level 'run_all_tests.py' script can easily auto-discover all tests in a package and all its sub-packages, using:

from unittestplus.run import get_all_tests, run
run(get_all_tests('unittestplus'))

run_all_tests(test_dir)

A convenience function that calls run(get_all_tests(test_dir)), while also setting verbosity of the test runner to 2 if either '-v' or '--verbose' can be found on sys.argv.