Module @traqula/test-utils
Traqula Test utils
Traqula test utils contains developer utilities for testing parsers, generators, and algebra transformers within the Traqula project.
Installation
npm install -D @traqula/test-utils
or
yarn add -D @traqula/test-utils
Exports
| Export | Description |
|---|---|
positiveTest(type) |
Generator yielding positive parser test cases (query + expected AST) |
negativeTest(type) |
Generator yielding negative parser test cases (queries that should fail) |
sparqlAlgebraTests(suite, ...) |
Generator yielding algebra transformation test cases |
sparqlAlgebraNegativeTests(suite) |
Generator yielding negative algebra test cases |
sparqlQueries(suite) |
Generator yielding raw SPARQL query strings |
toEqualParsedQuery |
Vitest matcher for deep-comparing parsed ASTs (with RDF term support) |
toEqualParsedQueryIgnoring |
Vitest matcher for comparing ASTs while ignoring specified keys |
importSparql11NoteTests(parser, DF) |
Registers a suite of SPARQL 1.1 specification note tests |
readFile(path) |
Async file reader with line-ending normalization |
readFileSync(path) |
Sync file reader with line-ending normalization |
getStaticFilePath(...paths) |
Resolves paths relative to the test statics directory |
Usage
import { positiveTest, sparqlAlgebraTests } from '@traqula/test-utils';
// Iterate parser test cases
for (const test of positiveTest('sparql-1-1')) {
it(test.name, async () => {
const { query, astWithSource } = await test.statics();
expect(parser.parse(query)).toEqualParsedQuery(astWithSource);
});
}