X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=test%2FREADME;h=3d7d478b4b77948209e6484e1a87d2230d6565df;hb=42340d0aa25e0d0ec9c53bc81a7c5bf14283fbd7;hp=c61647eb4c32c5f29236fc4c5bababf826da9ee8;hpb=96e5489117df5aefa72de229ab08eda82c8b8913;p=mmh diff --git a/test/README b/test/README index c61647e..3d7d478 100644 --- a/test/README +++ b/test/README @@ -9,28 +9,26 @@ the result by one of: * for a test pass: exit with status 0 * where a test has been skipped (perhaps because it depends on an external program which can't be found): print "Test $0 SKIP (reason)" - and exit with status 120 + and exit with status 77 * for a test fail: exit with some status other than 0 or 120 -The Suite is arranged as such: +The Suite is a re-worked version of the original test suite; it now is +designed to work with Automake. To run these tests you can do "make check" +via the top-level Makefile. This is also done automatically via +"make distcheck". -setup-test - Create the unit test framework. This will re-generate your configure - script and make files. +If you wish to write a new test, here are the steps: -teardown-test - Remove the temporary files created as part of the unit tests. +- Make sure your test script sources common.sh (the location of this script + is in the MH_TEST_COMMON environment variable and calls the setup_test + shell function (the other scripts have examples of this). -runtest - Run a single test. +- Your path will be set up to find the locations of the test nmh binaries. -runalltests - Run all tests in the suite +- Add your script to the TESTS variable in the toplevel Makefile.am. -tests - Directory containing the tests. All files found in this and all - subsequent directories which have the name test-* will be treated as a - single test. +- If you need additional files for your tests, be sure to add them to + the EXTRA_DIST variable in Makefile.am. Note that you should insure + that you access these files relative to the ${srcdir} environment variable. -Complex tests may be given their own directory as long as there is a file -named 'test-*' in the directory which will launch the test. +- Verify that the test works with both "make check" and "make distcheck".