Debian Codegraph @

.cargo/vendor/regex/testdata/README.md

raw
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