github.com/grumpyhome/grumpy@v0.3.1-0.20201208125205-7b775405bdf1/grumpy-runtime-src/third_party/stdlib/unittest/__init__.py (about)

     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',
    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  __all__ += (['getTestCaseNames', 'makeSuite', 'findTestCases'])
    56  
    57  __unittest = True
    58  
    59  import unittest_result
    60  import unittest_case
    61  import unittest_suite
    62  import unittest_loader
    63  # import unittest_main
    64  import unittest_runner
    65  import unittest_signals
    66  
    67  # from .result import TestResult
    68  # from .case import (TestCase, FunctionTestCase, SkipTest, skip, skipIf,
    69  #                    skipUnless, expectedFailure)
    70  # from .suite import BaseTestSuite, TestSuite
    71  # from .loader import (TestLoader, defaultTestLoader, makeSuite, getTestCaseNames,
    72  #                      findTestCases)
    73  # from .main import TestProgram, main
    74  # from .runner import TextTestRunner, TextTestResult
    75  # from .signals import installHandler, registerResult, removeResult, removeHandler
    76  
    77  TestResult = unittest_result.TestResult
    78  TestCase, FunctionTestCase, SkipTest, skip, skipIf, skipUnless, expectedFailure = \
    79    unittest_case.TestCase, unittest_case.FunctionTestCase, unittest_case.SkipTest, \
    80    unittest_case.skip, unittest_case.skipIf, unittest_case.skipUnless, \
    81    unittest_case.expectedFailure
    82  BaseTestSuite, TestSuite = unittest_suite.BaseTestSuite, unittest_suite.TestSuite
    83  TestLoader, defaultTestLoader, makeSuite, getTestCaseNames, findTestCases = \
    84    unittest_loader.TestLoader, unittest_loader.defaultTestLoader, unittest_loader.makeSuite, \
    85    unittest_loader.getTestCaseNames, unittest_loader.findTestCases
    86  # TestProgram, main = unittest_main.TestProgram, unittest_main.main
    87  TextTestRunner, TextTestResult = unittest_runner.TextTestRunner, unittest_runner.TextTestResult
    88  installHandler, registerResult, removeResult, removeHandler = \
    89    unittest_signals.installHandler, unittest_signals.registerResult, \
    90    unittest_signals.removeResult, unittest_signals.removeHandler
    91  
    92  # deprecated
    93  _TextTestResult = TextTestResult