Lit as it exists today has three hacks that allow users to run tests earlier:
- An entire test suite can set the is_early boolean.
- A very recently introduced "early_tests" feature.
- The --incremental flag forces failing tests to run first.
All of these approaches have problems.
- The is_early feature was until very recently undocumented. Nevertheless it still lacks testing and is a imprecise way of optimizing test starting times.
- The early_tests feature requires manual updates and doesn't scale.
- --incremental is undocumented, untested, and it requires modifying the *source* file system by "touching" the file. This "touch" based approach is arguably a hack because it confuses editors (because it looks like the test was modified behind the back of the editor) and "touching" the test source file doesn't work if the test suite is read only from the perspective of lit (via advanced filesystem/build tricks).
This patch attempts to simplify and address all of the above problems.
This patch formalizes, documents, tests, and defaults lit to recording the execution time of tests and then reordering all tests during the next execution. By reordering the tests, high core count machines run faster, sometimes significantly so.
This patch also always runs failing tests first, which is a positive user experience win for those that didn't know about the hidden --incremental flag.
Finally, if users want, they can _optionally_ commit the test timing data (or a subset thereof) back to the repository to accelerate bots and first-time runs of the test suite.