oxc/tasks/transform_conformance/README.md
Wenzhe Wang 7192520d2b
feat(transformer_conformance): use bun to run babel exec.js test cases (#1012)
closes #999 

Co-authored-by: Boshen <boshenc@gmail.com>
2023-10-25 03:06:07 +00:00

43 lines
1,011 B
Markdown

# Transformation Conformance Test Runner
## Execution
This test runner uses the transformation plugin test suite from the babel repository.
The failing test cases are listed in [./babel.snap.md](./babel.snap.md)
To get started, run
```bash
cargo run -p oxc_transform_conformance
```
or watch for changes
```bash
just watch 'run -p oxc_transform_conformance'
```
## Options
### --filter
To filter for a specific test case, apply the `--filter path` option, e.g.
```bash
cargo run -p oxc_transform_conformance -- --filter react/arrow-functions
```
### --exec
The babel test suite contains many `exec.js` files, they need to be executed by a runtime.
`Bun` is the preferred way to execute these tests, which you may install them via [https://bun.sh/docs/installation](https://bun.sh/docs/installation).
Once `bun` is installed, apply the `--exec` flag:
```bash
cargo run -p oxc_transform_conformance -- --exec
```
The failing test cases are listed in [./babel_exec.snap.md](./babel_exec.snap.md).