18 lines
989 B
Markdown
18 lines
989 B
Markdown
# Diff tests
|
|
|
|
This directory contains files used to ensure correctness of the `spirv-diff` implementation. The
|
|
`generate_tests.py` script takes `name_src.spvasm` and `name_dst.spvasm` (for each `name`) and
|
|
produces unit test files in the form of `name_autogen.cpp`.
|
|
|
|
The unit test files test the diff between the src and dst inputs, as well as between debug-stripped
|
|
versions of those. Additionally, based on the `{variant}_TESTS` lists defined in
|
|
`generate_tests.py`, extra unit tests are added to exercise different options of spirv-diff.
|
|
|
|
New tests are added simply by placing a new `name_src.spvasm` and `name_dst.spvasm` pair in this
|
|
directory and running `generate_tests.py`. Note that this script needs the path to the spirv-diff
|
|
executable that is built.
|
|
|
|
The `generate_tests.py` script additionally expects `name_src.spvasm` to include a heading where the
|
|
purpose of the test is explained. This heading is parsed as a block of lines starting with `;;` at
|
|
the top of the file.
|