# Test programs

Run `./run_tests.sh` to run the full suite and report results.

The tests are executed with very aggressive garbage collection parameters.  A full garbage
collection cycle is run on every allocation.  This means if an object is freed by the GC but still
referenced (because the reference was not from the stack / heap) then the error can be caught in
valgrind.

The output of each test (merging `stdout` and `stderr` with `2>&1`) should match its .golden file.  If a
test has no `.golden` file, the test should return "true".  If a test's name begins with "error." then
its exit code is expected to be 1, otherwise it should be 0.

If a test is changed, and its golden output needs to be updated (e.g. line numbers in stack traces
no-longer match up) then run `./refresh_golden.sh <thetest.jsonnet>`