Changes between Version 25 and Version 26 of GSoC/2014/TestingFrameworkForGRASS

Timestamp:

May 30, 2014, 11:42:39 AM (10 years ago)

Author:

wenzeslaus

Comment:

improve test internal invocation desc

GSoC/2014/TestingFrameworkForGRASS

@@ -169 +169 @@
 This describes how `unittest` is doing it and we want to use as many classes (directly or by inheriting) from `unittest` as possible, so it will be probably also our system.
 
-Loading of tests:
-
-{{{
+Loading of tests (pseudo code):
+
+{{{
+#!python
 # finds all test methods of a given test case and creates test suite
-# suite class will get a list of instances of test case class with a method name (test method)
-# getTestCaseNames == test method names
-TestLoader.loadTestsFromTestCase()
-        testCaseNames = filter(isTestMethod, dir(testCaseClass))
+# test suite class will get a list of instances of test case class, each with one method name (test method)
+# testCaseNames contains test method names
+def TestLoader.loadTestsFromTestCase(testCaseClass):
+    testCaseNames = filter(isTestMethod, dir(testCaseClass))
     loaded_suite = self.suiteClass(map(testCaseClass, testCaseNames))
 
-# finds all test cases in the module/script
-TestLoader.loadTestsFromModule()
+# finds all test cases in a module/script
+def TestLoader.loadTestsFromModule(module):
     for each object in module:
         if isinstance(obj, type) and issubclass(obj, case.TestCase):
-                        tests.append(self.loadTestsFromTestCase(obj))
+            tests.append(self.loadTestsFromTestCase(obj))
     suiteClass = suite.TestSuite
     tests = self.suiteClass(tests)
 
-# finds all tests passes them to test runner
-TestProgram.runTests()
+# finds all tests (by direct import of what was specified or test discovery)
+# passes found tests to test runner
+def TestProgram.runTests():
     self.test = self.testLoader.loadTestsFromModule(self.module)
     self.result = testRunner.run(self.test)
 
 # triggers the top level test suite
-TextTestRunner.run(test)
+def TextTestRunner.run(test):
     test(result)
 }}}
 
-Running of tests (test suite can contain test suite or test case instances):
-
-{{{
+Running of tests (pseudo code):
+
+{{{
+#!python
 # invokes the separate tests
 # does setup and teardown for class
-TestSuite.run(result)
+# note that test suite can contain test suite or test case instances
+def TestSuite.run(result):
     for each test:
         test(result)
 
 # runs the test method and adds the information to the result
-# does setup and teardown for instance
-TestCase.run(result)
+# does setup and teardown for an test case instance
+def TestCase.run(result):
+     ...
 }}}