Changes between Version 45 and Version 46 of GSoC/2014/TestingFrameworkForGRASS

Timestamp:

07/14/14 07:21:38 (11 years ago)

Author:

wenzeslaus

Comment:

add Testing framework now in trunk announcement

GSoC/2014/TestingFrameworkForGRASS

@@ -637 +637 @@
 [source:sandbox/wenzeslaus/gunittest/testing.rst?rev=61144 documentation], [http://lists.osgeo.org/pipermail/grass-dev/2014-July/069923.html report email]
 
+=== Announcement: Testing framework now in trunk ===
+
+I moved testing framework ([source:grass/trunk/lib/python/gunittest?rev=61225 gunittest] package) from sandbox to trunk in
+r61225.
+
+You can run all tests from GRASS source code top directory using:
+
+{{{
+python -m grass.gunittest.main .../grassdata/ nc_spm_08 nc
+}}}
+
+You should be in GRASS session and in some testing location (it will not be
+used but to be sure that nothing is damaged). First parameter is path to
+GISDBASE, second is the name of location (you should use sample NC smp
+location) and third parameter should be 'nc'. Running tests may take few
+minutes and then open a file `testreport/index.html` with test results.
+
+I'm working on [source:grass/trunk/lib/python/docs/src/gunittest_testing.rst?rev=61228 documentation] but assertion methods are well documented already and there is already a lot of examples in the source code. See directories named testsuite for example test files (ignore testsuite directory in root for now). Modules which have tests are [source:grass/trunk/temporal/t.rast.extract/testsuite t.rast.extract], [source:grass/trunk/raster/r.gwflow/testsuite r.gwflow], [source:grass/trunk/general/g.mlist/testsuite g.mlist], [source:grass/trunk/general/g.mremove/testsuite g.mremove], [source:grass/trunk/general/g.list/testsuite g.list], and [source:grass/trunk/raster/r.slope.aspect/testsuite r.slope.aspect].
+
+You can write tests for raster modules pretty easily and in limited way it
+is possible to write tests for vector modules too. See the available assert
+methods (in [source:grass/trunk/lib/python/gunittest/case.py?rev=61225 gunittest] and in [https://docs.python.org/2/library/unittest.html#assert-methods unittest]). When writing consider that you are in GRASS sample NC spm location.
+
+Tests for modules such as `r.info` or `r.univar` are good starting point in
+learning how to write tests and moreover, it would be advantageous to have
+these core modules covered. If you would prefer rewriting rather then
+writing, there is a lot of tests (or Pythod doctests) here and there which
+might be integrated into the new framework. I can give you some pointers.
+
+I'm getting feedback from Soeren but I would like to hear from other
+developers, too. So, let me know what you think.
+
+[http://lists.osgeo.org/pipermail/grass-dev/2014-July/069988.html announcement email]
 === Week 08 ===