BURP: A Basic and Unassuming RML Processor

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.

Coverage matrix

RML-Core	RML-IO	RML-CC	RML-FNML	RML-Star
✔️ 100% coverage	🚧 Source yes, Target WIP	✔️ 100% coverage	✔️ 100% coverage	🚧 WIP

Building BURP

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.

Using BURP

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.

Citation

If you use BURP, please cite our paper:

@inproceedings{vanassche2024BURP,
  title={{BURPing Through RML Test Cases}},
  author={Van Assche, Dylan and Debruyne, Christophe},
  year={2024},
  month={may},
  version={1.0.0},
  doi={TODO},
  url={https://github.com/kg-construct/BURP},
  license={{MIT}},
}

License

BURP is released under the MIT license.