run docstrings tests with mocha

[aspeddro]

Main changes:

• Generates a single file with all the examples from the docstrings, generated_mocha_test.res
• Runtime tests using mocha
• Much faster
• Run on macos and Linux

[cknitt]

Great work! This is awesome. Huge speedup (> 10x on my machine).

Some feedback:

1. generated_mocha.test.res is quite huge. Maybe we shouldn't check it in?
2. If possible, could we change the generation so that we get one describe call per module (e.g., String) with multiple test calls inside (one per function, e.g., charAt, charCodeAt, ...).
3. Is the inner module Test actually needed? In what cases?

[cknitt]

Bonus points: detect node version and run tests accordingly. As these tests actually work with Node 22.

[aspeddro]

Done.

[cknitt]

Why do we need Obj.magic here?

I think this can just be

  examples->Array.sort((a, b) => String.compare(a.id, b.id))

and should be moved into the extractExamples function.

[aspeddro]

Thanks

[aspeddro]

Great work! This is awesome. Huge speedup (> 10x on my machine).

Some feedback:

1. generated_mocha.test.res is quite huge. Maybe we shouldn't check it in?
2. If possible, could we change the generation so that we get one describe call per module (e.g., String) with multiple test calls inside (one per function, e.g., charAt, charCodeAt, ...).
3. Is the inner module Test actually needed? In what cases?

1. Added generated_mocha_test.res and generated_mocha_test.res.mjs to gitignore.
2. Done
3. Yes, bc some examples contains type definitions. Added comment on code

[cknitt]

2. Done

Doesn't really seem to be done yet? I still see one describe per test.

But never mind, we can always improve things in separate PRs.

[cknitt]

Doesn't really seem to be done yet? I still see one describe per test.

Sorry, please disregard, seems I somehow had a stale generated file locally. 🤦