| 1 |
This directory contains a large suite of regex tests defined in a TOML format. |
| 2 |
They are used to drive tests in `tests/lib.rs`, `regex-automata/tests/lib.rs` |
| 3 |
and `regex-lite/tests/lib.rs`. |
| 4 |
|
| 5 |
See the [`regex-test`][regex-test] crate documentation for an explanation of |
| 6 |
the format and how it generates tests. |
| 7 |
|
| 8 |
The basic idea here is that we have many different regex engines but generally |
| 9 |
one set of tests. We want to be able to run those tests (or most of them) on |
| 10 |
every engine. Prior to `regex 1.9`, we used to do this with a hodge podge soup |
| 11 |
of macros and a different test executable for each engine. It overall took a |
| 12 |
longer time to compile, was harder to maintain and it made the test definitions |
| 13 |
themselves less clear. |
| 14 |
|
| 15 |
In `regex 1.9`, when we moved over to `regex-automata`, the situation got a lot |
| 16 |
worse because of an increase in the number of engines. So I devised an engine |
| 17 |
independent format for testing regex patterns and their semantics. |
| 18 |
|
| 19 |
Note: the naming scheme used in these tests isn't terribly consistent. It would |
| 20 |
be great to fix that. |
| 21 |
|
| 22 |
[regex-test]: https://docs.rs/regex-test |