README
EARL-Badge.js
This tool creates SVG badges for EARL test reports, for representing the specification compliance of a certain tool. These badges represent the percentage of passed tests for a specification's test suite for a given tool.
For example, a badge representing the JSON-LD 1.1 spec compliance could look as follows:
These EARL reports can be generated using a variety of tools in different programming languages, such as rdf-test-suite.js.
Installation
Global
This allows the tool to be used from the CLI.
$ yarn global add earl-badge
or
$ npm install -g earl-badge
Local
This allows the tool to be used as a library.
$ yarn add earl-badge
or
$ npm install earl-badge
Usage
This tool can either be used to generate SVG files from command line, or from code.
CLI
This tool assumes that you have an EARL test report file for a tool.
Assuming that you have an EARL file at mytool-earl.ttl
,
where your tool is identified in the EARL file by http://example.org/mytool
,
and your tool implements the JSON-LD 1.1
specification,
you can execute this tool as follows:
$ earl-badge "JSON-LD 1.1" http://example.org/mytool mytool-earl.ttl
This tool supports EARL files in most RDF serializations,
as long as they are supported by rdf-parse
.
Code
The SVG generation can also be called from code as follows:
import { BadgeGeneratorEarl } from "earl-badge";
const svgString = await new BadgeGeneratorEarl().createSvgBadge({
filePath: 'mytool-earl.ttl',
specName: 'JSON-LD 1.1',
testSubject: 'http://example.org/mytool',
});
License
This software is written by Ruben Taelman.
This code is released under the MIT license.