1 = Notes on the test machinery =
3 == Understanding and running tests ==
5 A .log extension means it's a game log
6 A .chk extension means it's expected output from a test
8 The test files are run in alphabetical order. This allows you to
9 ensure certain tests are run in a particular order merely by giving
10 them appropriate names, e.g.: test.1.log, test.2.log, test.3.log. This
11 is useful for testing save and resume.
13 In general, a file named foo.chk is the expected output from the game log
14 foo.log. To add new tests, just drop log files in this directory.
16 To see summary lines from all tests, 'make testlist'. The summary lines
17 are those led with ##; you should have one such descriptive line at the
20 To run the tests, "make regress".
22 To remake the check files, "make buildregress".
26 The simplest way to make a test is to simply play a game with the -l
27 option giving a log path. Commands will be captured to that log.
29 To re-use a command sequence from an existing log, run advent -s and
30 paste it to the advent command log from the clipboard. If you don't
31 use -s to disable advanced ediiting, the code used for that will consume
32 the first line of the paste and discare the rest. This is almost
33 certainly not what you want.
35 To see where we can use more tests, have a look at our test coverage
38 http://esr.gitlab.io/open-adventure/coverage/
40 Improvements in test coverage are always welcome.