Description

Runs a list of regression tests for a Go program supporting the Go Text Protocol, and formats the output as HTML. The regression tests are GTP files, which use the special comment #?, as used for the GNU Go regression tests (see section Regression testing of the GNU Go documentation). The regular expression syntax for the expected responses is mostly compatible to the one used by the GNU Go regression test suite, see the documentation for java.util.regex.Pattern for a complete description.

Test names that start with a '@' are interpreted as files containing a test suite. The file with the corresponding name (excluding the '@') is read and every non-empty line that does not start with the comment character '#' is added to the list of test names. The files are allowed to contain names of other test suites.

The main output file is index.html. For each test file test.tst, additional files with name test.html and test.out.html are generated. Additionally, a text file summary.dat is generated, with a table row containing the most important summary statistics. gogui-regress will start a new instance of the Go program for each test and use the directory of the test file as the working directory for the Go program.

The return value of gogui-regress is 0, if all tests completed successfully with no unexpected fails, 1 if there was at least one unexpected fail, and 2 if the Go program crashed or some other error occurred.

Options