Changes between Version 3 and Version 4 of UnitTests

Timestamp:

Apr 30, 2010 2:05:27 PM (13 years ago)

Author:

toby

Comment:

--

UnitTests

@@ -1 @@
-The hope is that all sections of GSAS-II "model" code (as opposed to controller or view code in the MVC paradigm) will eventually have unit tests, as described below.
+The hope is that all sections of GSAS-II computation aka "model" code (as opposed to controller or view code in the [http://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller MVC paradigm]) will eventually have unit tests, as described below.
 
 === Design philosophy ===
@@ -12 +12 @@
 === Implementation ===
 
-Tests are to be included directly in the GSAS-II module by defining test functions. The test functions should be named to start with the string "test" and should not require any arguments. The should use assert or raise to report an unexpected result and should not print anything if the test succeeds. If the test requires more input than can comfortably be included in the module itself, the input should be placed in directory {{{testinp\}}}. If routines are used to generate this input, the generating routines can also be placed here. 
+Tests are to be included directly in the GSAS-II module by defining test functions. The test functions should be named to start with the string "test" and should not require any arguments. The test could should use assert or raise to report an unexpected result and should not print anything if the test succeeds. If the test requires more input than can comfortably be included in the module itself, the input should be placed in directory {{{testinp\}}}. If routines are used to generate this input, the generating routines can also be placed there. The code to implement the test can then look like this:
+{{{
+def test1():
+    ''' test #1: SpcGroup and SGPrint against previous results'''
+    testdir = ospath.join(mypath,'testinp')
+    if ospath.exists(testdir):
+        if testdir not in sys.path: sys.path.insert(0,testdir)
+    import spctestinp
+    def CompareSpcGroup(spc, referr, refdict, reflist): 
+        'Compare output from GSASIIspc.SpcGroup with results from a previous run'
+        #...
+    for spc in spctestinp.SGdat:
+        CompareSpcGroup(spc, 0, spctestinp.SGdat[spc], spctestinp.SGlist[spc] )
+}}}
+This allows the python nosetests to perform tests on the module using command {{{nosetests <file.py>}}} to run the test on the file ({{{file.py}}}). It is also convenient if the tests are implemented in a code section that is run if the file is run directly, rather than imported,
+{{{
+if __name__ == '__main__':
+    test0()
+    test1()
+    test2()
+    test3()
+    print "OK"
+}}} 
+this allows command {{{python <file.py>}}} to run the test without the nosetests package. 
 
+Finally, file {{{unit_tests.py}}} is intended to have a comprehensive list of all unit tests in GSAS-II, so that the entire suite of tests can be run in one pass. This file should contain a set of routines, each named beginning with the string "test" to exercise the self-tests from each module. Where this code:
+{{{
+import GSASIIspc
+def test_GSASIIspc():
+    GSASIIspc.test0()
+def test_GSASIIspc1():
+    GSASIIspc.test1()
+def test_GSASIIspc2():
+    GSASIIspc.test2()
+def test_GSASIIspc3():
+    GSASIIspc.test3()
+}}}
+duplicates that in the previous section.