test(harness): migrate away from magic globals

Problem:
The magic globals `it`, `describe`, etc., are more trouble than they are
worth.

- Hooking into `after_each` requires `getfenv()` hacks.
- They confuse luals/emmylua, because the top-level `.luarc.json` isn't
  merged with `test/.luarc.json` (apparently a luals limitation?)
- They totally defeat discoverability because the user just has to
  "know" about the various magic symbols.

So they harm DX, which means they serve no purpose at all.

Solution:
- Expose the test API from `testutil`, so tests can call `t.it()`,
  `t.describe()`, etc., in the conventional way.
- Drop `getfenv()` hacks.
- Drop the `setfenv()` injection in `load_chunk`.
- Drop `test/_meta.lua`.
This commit is contained in:
Justin M. Keyes committed 2026-07-21 13:22:39 +02:00
1 parent a71ee754ee
commit 6d8c8b18d5
535 files changed
+771 -115

No files matched your search

+2
View File
@@ -1,5 +1,7 @@
local assert = require('test.assert')
local t = require('test.testutil')
local describe, it = t.describe, t.it
describe('test.assert', function()
it('ignores aliasing differences', function()
local shared = {}