mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-10-19 13:36:48 +00:00
Maurice
4427c435a8
lint:test-mocks counts vi.mock/vi.doMock of src/config, src/nest/realtime and src/db per file under tests/, lint:test-new-service counts new XService(/new XRepository( there with every class whose constructor takes nothing allowed (derived from src/ and tests/helpers/), and lint:size holds files under tests/ to 2000 lines against their own baseline. Both counters share scripts/lib/count-ratchet.mjs, which gains a prepare hook for a check that reads the tree first. The three run as steps of the existing server lint job; the CLAUDE.md files and the module guide describe the test helpers they point to.
57 lines
2.4 KiB
JavaScript
57 lines
2.4 KiB
JavaScript
#!/usr/bin/env node
|
|
/*
|
|
* lint:test-mocks: module mocks of the config, the realtime transport and the
|
|
* database modules in tests/ may only shrink.
|
|
*
|
|
* A `vi.mock` of one of those paths replaces a module every domain imports,
|
|
* so a suite stays green for reasons its cases do not show (a factory that
|
|
* happens to export the names the import order reaches first) and every
|
|
* constructor or import change ripples through hundreds of factories. The
|
|
* test infrastructure covers each of them instead:
|
|
*
|
|
* src/config the setup file fixes its values once
|
|
* (tests/helpers/test-config.ts, overrideTestConfig)
|
|
* src/nest/realtime/** a FakeRealtimeService through DI, or spyOnRealtime(app)
|
|
* src/db/** a snapshot test db (tests/helpers/db-mock.ts) handed
|
|
* to the code under test; the remaining `src/db/database`
|
|
* mocks are the legacy this counts down
|
|
*
|
|
* Every `vi.mock(` / `vi.doMock(` whose path ends in one of those modules
|
|
* counts, per file, against scripts/test-mocks-baseline.json; a file without
|
|
* an entry may hold none (scripts/lib/count-ratchet.mjs has the rules).
|
|
*
|
|
* npm run lint:test-mocks check against the baseline (CI)
|
|
* npm run lint:test-mocks -- --update lower the counts; never raises or adds an entry
|
|
*/
|
|
import { cliMain } from './lib/count-ratchet.mjs';
|
|
|
|
const MOCK_CALL = /\bvi\.(?:mock|doMock)\(\s*(['"`])([^'"`]+)\1/g;
|
|
|
|
/** A mocked path that names one of the held modules, with or without an extension. */
|
|
const HELD_TARGET = /(?:^|\/)src\/(?:config|websocket|db(?:\/[^'"`]*)?|nest\/realtime(?:\/[^'"`]*)?)$/;
|
|
|
|
/** The module mocks of held targets in one file's text. */
|
|
export function countHeldMocks(text) {
|
|
let n = 0;
|
|
for (const match of text.matchAll(MOCK_CALL)) {
|
|
const target = match[2].replace(/\.(?:[cm]?[jt]s)$/, '');
|
|
if (HELD_TARGET.test(target)) n++;
|
|
}
|
|
return n;
|
|
}
|
|
|
|
export const check = {
|
|
name: 'test-mocks',
|
|
script: 'lint:test-mocks',
|
|
root: 'tests',
|
|
baseline: 'scripts/test-mocks-baseline.json',
|
|
unit: 'module mock(s) of config, realtime or db',
|
|
advice:
|
|
'Use the test config (overrideTestConfig), a FakeRealtimeService or spyOnRealtime(app), ' +
|
|
'and a snapshot test db handed to the code under test instead of mocking the module.',
|
|
include: (file) => /\.[cm]?[jt]s$/.test(file),
|
|
count: (text) => countHeldMocks(text),
|
|
};
|
|
|
|
cliMain(check, import.meta.url);
|