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.

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.

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{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}
}

License

BURP is released under the MIT license.