This repository contains the W3C Credentials Community Group test suite. Any conforming implementation MUST pass all tests in the test suite.
There are multiple test suites, each of which is detailed below.
This test suite will check any application that generates Decentralized Identifiers documents to ensure conformance with the specification.
You web application will need to be accessible from the command line. It will also need to accept the following command line parameters:
Usage: <your_program> [options] [command]
Options:
-?, --question //TODO add commands
-h, --help output usage information
Commands:
validate
--did true|false
--document true|false
--contexts [path-to-context]
--did is used for validating identifiers. --document is used for validating documents --contexts is a list of paths to jsonld contexts used in the tests. Both did and document accept the tested object via stdin.
All tests will run against your binary and assume that an exit code greater than 0 represents an error.
An example local configuration for the test suite. To use:
- Copy the file config.json.example to a new file called config.json.
- Modify the file and replace with appropriate values for your system.
{
"generator": "../your-application/bin",
"baseDIDContext": "../path/to/base/context/did.json"
}
baseDIDContext is the path to the test suite's test/contexts/base.json file.
- npm install
- Copy the
config.json.example
file toconfig.json
and modify. - All that is needed is a path to the binary that runs the tests
- npm test
- npm install
- Copy the
config.json.example
file toconfig.json
and modify. - npm run report
- Rename implementation/results.json to implementation/YOUR_IMPLEMENTATION-results.json.
- git add implementations/YOUR_IMPLEMENTATION-results.json and submit a pull request for your implementation.
You may contribute to this test suite by submitting pull requests here: