W3C

LDP Test Suite

Test Suite for W3C Linked Data Platform 1.0

View on GitHub

Background

Status

This Test Suite is still work-in-progress (see implementation and coverage reports), but you could start to use it to check your implementation and send some early feedback to the working group.

The list of test cases, along with their status (WG approved, manual, client-only) is available in a generated report.

Usage

Standalone

You can run the test suite against an arbitrary server:

$ mvn package
$ java -jar target/ldp-testsuite-1.0.0-SNAPSHOT-shaded.jar \
    --server http://localhost --basic

Use --basic, --direct, or --indirect for the type of container you want to test; --help for getting some more help.

For instance, if you want to test Apache Marmotta, once you have it installed the command to use would be:

$ java -jar ldp-testsuite-1.0.0-SNAPSHOT-shaded.jar \
    --server http://localhost:8080/ldp --basic

Maven

If you are using Maven for building your project, you can use the test suite as dependency for your tests:

<dependency>
    <groupId>org.w3</groupId>
    <artifactId>ldp-testsuite</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <scope>test</scope>
</dependency>

And then you can programmatically execute the test suite with a code like:

LdpTestSuite testSuite = new LdpTestSuite("http://localhost");
testSuite.run();
System.out.println(testSuite.getStatus());

For further details and advance usage, please check the javadoc.

Reporting

For reporting the status of a concrete implemetation, please use a command like:

$ java -jar target/ldp-testsuite-1.0.0-SNAPSHOT-shaded.jar \
    --server http://localhost --basic --non-rdf --earl \
    --software "Your Software" --shortname "Yours" --language "Java" \
    --homepage http://ldp.example.org  \
    --assertor http://ldp.example.org \
    --developer "Your Name"
Please, submit the generated reports, (both ldp-testsuite-execution-report-earl.ttl and ldp-testsuite-execution-report.html located at the report directory, to the working group (public-ldp@w3.org) to be included to the official LDP Implementation Conformance Report.

Contributors

On behalf of the W3C LDP Working Group:

  • Steve Speicher (IBM)
  • Samuel Padgett (IBM)
  • Sergio Fern├índez (ASF)

Licenses

The Test Suite software is avaible under the terms of the W3C Software Notice and License. To contribute to the Test Suite software, you have to sign the Contributor License Agreement.

The Test Suite data is available under both W3C Test Suite License and W3C 3-clause BSD License. To contribute to the Test Suite data, see the policies and contribution forms.