git.marmaro.de Git - mmh/blob - test/README

   1 nmh unit test suite.
   2
   3
   4         The testcases are not maintained in mmh, currently.
   5         Thus, they likely are broken.     --meillo 2012-04
   6
   7
   8 The purpose of these tests is to verify the functionality of the nmh
   9 commands.  The goal of the suite is to create an environment where testing
  10 nmh commands is easy and useful.  Each test is a shell script, and is
  11 launched via the 'sh' command. The script should run the test and report
  12 the result by one of:
  13
  14   * for a test pass: exit with status 0
  15   * where a test has been skipped (perhaps because it depends on an
  16     external program which can't be found): print "Test $0 SKIP (reason)"
  17     and exit with status 120
  18   * for a test fail: exit with some status other than 0 or 120
  19
  20 The Suite is arranged as such:
  21
  22 setup-test
  23     Create the unit test framework.  This will re-generate your configure
  24     script and make files.
  25
  26 teardown-test
  27     Remove the temporary files created as part of the unit tests.
  28
  29 runtest
  30     Run a single test.
  31
  32 runalltests
  33     Run all tests in the suite
  34
  35 tests
  36     Directory containing the tests.  All files found in this and all
  37     subsequent directories which have the name test-* will be treated as a
  38     single test.
  39
  40 Complex tests may be given their own directory as long as there is a file
  41 named 'test-*' in the directory which will launch the test.