| # Web Testing Infrastructure |
| |
| Testing support for IREE's web platform port: |
| |
| * Scripts to build tests with CMake/Emscripten |
| * HTML/JS for displaying individual tests and test suites |
| * Scripting to parse the list of tests provided by `ctest` into the format |
| expected by the HTML/JS test suite runner |
| |
| ## Quickstart |
| |
| 1. Install IREE's host tools (e.g. by building the `install` target with CMake) |
| 2. Install the Emscripten SDK by |
| [following these directions](https://emscripten.org/docs/getting_started/downloads.html) |
| 3. Initialize your Emscripten environment (e.g. run `emsdk_env.bat`) |
| 4. From this directory, run `bash ./build_sample.sh [path to install] && bash ./serve_sample.sh` |
| 5. Open the localhost address linked in the script output |
| |
| ## Implementation Details |
| |
| * Our tests (and benchmarks) generate binary files that when executed run tests |
| then return an exit code |
| * When compiling for the web using Emscripten, each binary target produces a |
| `.js` and a `.wasm` file |
| * Running an Emscripten-produced binary on a webpage requires just defining the |
| `Module` object and importing the `.js` |
| * The [`test-runner.html`](test-runner.html) webpage runs an individual test, |
| based on URL parameters |
| * `ctest --show-only=json-v1` outputs a JSON file enumerating all tests and |
| their properties (working directory, required files, arguments, etc.). The |
| [`parse_test_list.py`](parse_test_list.py) script parses this file into a |
| list of HTML elements linking to the test runner webpage with properties set |
| * The [`index_template.html`](index_template.html) webpage absorbs that list |
| of hyperlinks and runs them in an `<iframe>` |
