| 1 | """
|
|---|
| 2 | Python unit testing framework, based on Erich Gamma's JUnit and Kent Beck's
|
|---|
| 3 | Smalltalk testing framework.
|
|---|
| 4 |
|
|---|
| 5 | This module contains the core framework classes that form the basis of
|
|---|
| 6 | specific test cases and suites (TestCase, TestSuite etc.), and also a
|
|---|
| 7 | text-based utility class for running the tests and reporting the results
|
|---|
| 8 | (TextTestRunner).
|
|---|
| 9 |
|
|---|
| 10 | Simple usage:
|
|---|
| 11 |
|
|---|
| 12 | import unittest
|
|---|
| 13 |
|
|---|
| 14 | class IntegerArithmeticTestCase(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 |
|
|---|
| 25 | Further information is available in the bundled documentation, and from
|
|---|
| 26 |
|
|---|
| 27 | http://docs.python.org/library/unittest.html
|
|---|
| 28 |
|
|---|
| 29 | Copyright (c) 1999-2003 Steve Purcell
|
|---|
| 30 | Copyright (c) 2003-2010 Python Software Foundation
|
|---|
| 31 | This module is free software, and you may redistribute it and/or modify
|
|---|
| 32 | it under the same terms as Python itself, so long as this copyright message
|
|---|
| 33 | and disclaimer are retained in their original form.
|
|---|
| 34 |
|
|---|
| 35 | IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
|
|---|
| 36 | SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF
|
|---|
| 37 | THIS CODE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
|
|---|
| 38 | DAMAGE.
|
|---|
| 39 |
|
|---|
| 40 | THE AUTHOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT
|
|---|
| 41 | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
|
|---|
| 42 | PARTICULAR PURPOSE. THE CODE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS,
|
|---|
| 43 | AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
|
|---|
| 44 | SUPPORT, 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 |
|
|---|
| 58 | from .result import TestResult
|
|---|
| 59 | from .case import (TestCase, FunctionTestCase, SkipTest, skip, skipIf,
|
|---|
| 60 | skipUnless, expectedFailure)
|
|---|
| 61 | from .suite import BaseTestSuite, TestSuite
|
|---|
| 62 | from .loader import (TestLoader, defaultTestLoader, makeSuite, getTestCaseNames,
|
|---|
| 63 | findTestCases)
|
|---|
| 64 | from .main import TestProgram, main
|
|---|
| 65 | from .runner import TextTestRunner, TextTestResult
|
|---|
| 66 | from .signals import installHandler, registerResult, removeResult, removeHandler
|
|---|
| 67 |
|
|---|
| 68 | # deprecated
|
|---|
| 69 | _TextTestResult = TextTestResult
|
|---|
