31 lines
1.4 KiB
Markdown
31 lines
1.4 KiB
Markdown
|
# libsyntax2.0 testing infrastructure
|
||
|
|
|
||
|
|
Libsyntax2.0 tests are in the `tests/data` directory. Each test is a
|
||
|
|
pair of files, an `.rs` file with Rust code and a `.txt` file with a
|
||
|
|
human-readable representation of syntax tree.
|
||
|
|
|
||
|
|
The test suite is intended to be independent from a particular parser:
|
||
|
|
that's why it is just a list of files.
|
||
|
|
|
||
|
|
The test suite is intended to be progressive: that is, if you want to
|
||
|
|
write a Rust parser, you can TDD it by working through the test in
|
||
|
|
order. That's why each test file begins with the number. Generally,
|
||
|
|
tests should be added in order of the appearance of corresponding
|
||
|
|
functionality in libsytnax2.0. If a bug in parser is uncovered, a
|
||
|
|
**new** test should be created instead of modifying an existing one:
|
||
|
|
it is preferable to have a gazillion of small isolated test files,
|
||
|
|
rather than a single file which covers all edge cases. It's okay for
|
||
|
|
files to have the same name except for the leading number. In general,
|
||
|
|
test suite should be append-only: old tests should not be modified,
|
||
|
|
new tests should be created instead.
|
||
|
|
|
||
|
|
|
||
|
|
Note that only `ok` tests are normative: `err` tests test error
|
||
|
|
recovery and it is totally ok for a parser to not implement any error
|
||
|
|
recovery at all. However, for libsyntax2.0 we do care about error
|
||
|
|
recovery, and we do care about precise and useful error messages.
|
||
|
|
|
||
|
|
|
||
|
|
Contribution opportunity: design and implement testing infrastructure
|
||
|
|
for validators.
|