BURP (Basic and Unassuming RML Processor) is a reference implementation for the new RML specification which has been written from scratch to have no influence from prior implementations of RML. BURP was created to serve as a reference RML implementation for the Knowledge Graph Construction community and to verify the RML specifications their feasibility and coverage of their test cases.
RML-Core | RML-IO | RML-CC | RML-FNML | RML-Star |
---|---|---|---|---|
✔️ 100% coverage | 🚧 Source yes, Target WIP | ✔️ 100% coverage | ✔️ 100% coverage | 🚧 WIP |
To build the project and copy its dependencies, execute
$ mvn package
$ mvn dependency:copy-dependencies
You can add -DskipTests
after mvn package
to skip the unit tests. The tests do rely on Docker for testing mappings on top of MySQL and PostgreSQL.
Some libraries are available on GitHub's maven repository. Add a GitHub authentication token to your Apache Maven settings.xml
file. More information can be found here.
The run the R2RML processor, execute the following command:
$ java -jar burp.jar [-h] [-b=<baseIRI>] -m=<mappingFile> [-o=<outputFile>]
A fat jar is also provided with the Apache Maven Shade Plugin. It does not depend on the dependency
folder.
Usage: burp [-h] [-b=<baseIRI>] -m=<mappingFile> [-o=<outputFile>]
-b, --baseIRI=<baseIRI> Used in resolving relative IRIs produced by the RML mapping
-h, --help Display a help message
-m, --mappingFile=<mappingFile>
The RML mapping file
-o, --outputFile=<outputFile>
The output file
If no outputFile is provided and the RML mapping does not rely on RML-IO for targets, then the output is written to the standard output.
If you use BURP, please cite our paper:
@inproceedings{DBLP:conf/kgcw/AsscheD24,
author = {Dylan {Van Assche} and Christophe Debruyne},
editor = {David Chaves{-}Fraga and Anastasia Dimou and
Ana Iglesias{-}Molina and Umutcan Serles and
Dylan {Van Assche}},
title = {BURPing Through {RML} Test Cases},
booktitle = {Proceedings of the 5th International Workshop on Knowledge Graph Construction
co-located with 21th Extended Semantic Web Conference ({ESWC} 2024),
Hersonissos, Greece, May 27, 2024},
series = {{CEUR} Workshop Proceedings},
volume = {3718},
publisher = {CEUR-WS.org},
year = {2024},
url = {https://ceur-ws.org/Vol-3718/paper4.pdf}
}
BURP is released under the MIT license.