88:Contact: warmerdam at pobox.com
99:Author: Jeff McKenna
1010:Contact: jmckenna at gatewaygeomatics.com
11- :Last Updated: 2026-07-03
11+ :Last Updated: 2026-08-31
1212
1313.. contents:: Table of Contents
1414 :depth: 2
@@ -376,8 +376,12 @@ TODO
376376Adding New Tests
377377------------------------------------------------------------------------------
378378
379- - Pick an appropriate directory to put the test in. Feel free to start a new
379+ - Pick an appropriate directory under `/msautotest/` to put the test in. Feel free to start a new
380380 one for new families of testing functionality.
381+
382+ .. warning::
383+ Do not modify any files in the `/tests/` folder (including `/tests/unit/test.cpp`),
384+ please only add your tests under the `/msautotest/` folder.
381385
382386- Create a minimal map file to test a particular issue. I would discourage
383387 starting from a "real" mapfile and cutting down as it is hard to reduce this
@@ -398,17 +402,17 @@ Adding New Tests
398402 directory. These test datasets should be as small as possible! Reuse
399403 existing datasets if at all possible.
400404
401- - run the "run_test.py" script.
405+ - execute the "run_test.py" script.
402406
403- - verify that the newly created expected/<testname>.png file produces the
407+ - verify that the newly created ` expected/<testname>.png` file produces the
404408 results you expect. If not, revise the map and rerun the test, now checking
405- the results/<testname>.png file. Move the results/<testname>.png file into
409+ the ` results/<testname>.png` file. Move the ` results/<testname>.png` file into
406410 the expected directory when you are happy with it.
407411
408- - add the .map file, and the expected/<testname>.png file to the
412+ - add the .map file, and the ` expected/<testname>.png` file to the
409413 repository when you are happy with them. For example,
410414
411- ::
415+ ::
412416
413417 % git add mynewtest.map expected/mynewtest.png
414418 % git commit -m "My new test" mynewtest.map expected/mynewtest.png
0 commit comments