1"""
2Python unit testing framework, based on Erich Gamma's JUnit and Kent Beck's
3Smalltalk testing framework.
4
5This module contains the core framework classes that form the basis of
6specific test cases and suites (TestCase, TestSuite etc.), and also a
7text-based utility class for running the tests and reporting the results
8 (TextTestRunner).
9
10Simple usage:
11
12    import unittest
13
14    class IntegerArithmenticTestCase(unittest.TestCase):
15        def testAdd(self):  ## test method names begin 'test*'
16            self.assertEqual((1 + 2), 3)
17            self.assertEqual(0 + 1, 1)
18        def testMultiply(self):
19            self.assertEqual((0 * 10), 0)
20            self.assertEqual((5 * 8), 40)
21
22    if __name__ == '__main__':
23        unittest.main()
24
25Further information is available in the bundled documentation, and from
26
27  http://docs.python.org/library/unittest.html
28
29Copyright (c) 1999-2003 Steve Purcell
30Copyright (c) 2003-2010 Python Software Foundation
31This module is free software, and you may redistribute it and/or modify
32it under the same terms as Python itself, so long as this copyright message
33and disclaimer are retained in their original form.
34
35IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
36SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF
37THIS CODE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
38DAMAGE.
39
40THE AUTHOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT
41LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
42PARTICULAR PURPOSE.  THE CODE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS,
43AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
44SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
45"""
46
47__all__ = ['TestResult', 'TestCase', 'TestSuite',
48           'TextTestRunner', 'TestLoader', 'FunctionTestCase', 'main',
49           'defaultTestLoader', 'SkipTest', 'skip', 'skipIf', 'skipUnless',
50           'expectedFailure', 'TextTestResult', 'installHandler',
51           'registerResult', 'removeResult', 'removeHandler']
52
53# Expose obsolete functions for backwards compatibility
54__all__.extend(['getTestCaseNames', 'makeSuite', 'findTestCases'])
55
56__unittest = True
57
58from .result import TestResult
59from .case import (TestCase, FunctionTestCase, SkipTest, skip, skipIf,
60                   skipUnless, expectedFailure)
61from .suite import BaseTestSuite, TestSuite
62from .loader import (TestLoader, defaultTestLoader, makeSuite, getTestCaseNames,
63                     findTestCases)
64from .main import TestProgram, main
65from .runner import TextTestRunner, TextTestResult
66from .signals import installHandler, registerResult, removeResult, removeHandler
67
68# deprecated
69_TextTestResult = TextTestResult
70