# Test Data

Data used in tests is called _test data_ and is located in this folder, or
sub-folders thereof. This is not for test files, this folder should not contain
test code, only data used in tests.

## Golden Test

The `test` wrapper `testWithGolden('<name>', (ctx) async {` will register a
test case, and create a file:
  `test/testdata/goldens/path/to/myfile_test/<name>.txt`
, where `path/to/myfile_test.dart` is the name of the file containing the test
case, and `<name>` is the name of the test case.

Any calls to `ctx.run` will run `pub` and compare the output to a section in the
golden file. If the file does not exist, it is created and the
test is marked as skipped.
Thus, it is safe to delete all files in `test/testdata/goldens` and recreate
them -- just carefully review the changes before committing.

**Maintaining goldens**:
 1. Delete `test/testdata/goldens/`.
 2. Re-run tests to re-create files in `test/testdata/goldens/`.
 3. Compare changes, using `git diff test/testdata/goldens/`.