tame/tamer/tests/xmli/README.md

30 lines
1.1 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

# 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.