employer
/
tame
1
0
Fork 0
Code Packages Releases Activity
tame/tamer/tests/xmli/README.md

35 lines
1.4 KiB
Markdown
Raw Normal View History

tamer: asg::graph::object::xir: Initial rate element reconstruction This extends the POC a bit by beginning to reconstruct rate blocks (note that NIR isn't producing sub-expressions yet). Importantly, this also adds the first system tests, now that we have an end-to-end system. This not only gives me confidence that the system is producing the expected output, but serves as a compromise: writing unit or integration tests for this program derivation would be a great deal of work, and wouldn't even catch the bugs I'm worried most about; the lowering operation can be written in such a way as to give me high confidence in its correctness without those more granular tests, or in conjunction with unit or integration tests for a smaller portion. DEV-13708
2023-02-22 23:03:42 -05:00
# XMLI System Test
The `xmli` file is an intermediate file that serves as a handoff between
TAMER and the XSLT-based compiler:
```
xml -> (TAMER) -> xmli -> (TAME XSLT) -> xmlo
```
TAMER gets the first shot at processing, and then the compilation process
continues with the XSLT-based compiler. This allows TAMER to incrementally
augment and manipulate the source file and remove responsibilities from
TAME XSLT.
Tests in this directory ensure that this process is working as
intended. TAMER's failure to perform a proper handoff will cause TAME XSLT
to compile sources incorrectly, since TAMER will have rewritten them to
something else.
This handoff is more than just echoing tokens back into a file---it
_derives_ a new program from the state of the ASG. This program may have a
slightly different representation than the original sources, but it must
express an equivalent program, and the program must be at least as
performant when emitted by TAME XSLT.
# Running Tests
Test are prefixed with `test-*` and are executable. They must be invoked
with the environment variable `PATH_TAMEC` set to the path of `tamec`
relative to the working directory.
tamer: tests/xmli: Break apart single test case This would have gotten unwieldy as time goes on, and already made looking at traces very difficult. DEV-13708
2023-03-09 09:19:05 -05:00
Test cases are organized into sub-directories with `src.xml` and
`expected.xml` files. `src.xml` will be compiled with `tamec`, its output
formatted with `xmllint --format`, and `diff`'d against the
`xmllint`-formatted output of `expected.xml`.