Skip to content

Installation

Tobias John edited this page Jun 13, 2025 · 15 revisions

There are three options to get RDFMutate running, depending on your preferences.

  1. Run RDFMutate using the provided JAR. (recommended method)
  2. Build RDFMutate locally.
  3. Run RDFMutate using Docker.

1. Run the provided JAR

Get the newst version of RDFMutate from the releases. The provided JAR is built for Java version 17.

2. Build RDFMutate Locally

Instead of using a release, you can build the JAR-file yourself from the source code.

Requirements

  • Java installation (we built RDFMutate with Java 17)

Build Instructions

Build a JAR file for the project using the gradle wrapper by running

git clone https://github.com/smolang/RDFMutate.git
cd RDFMutate
./gradlew shadowJar
  • The generated JAR file is located in the folder build/libs and has the name rdfmutate-<version>.jar

3. Run RDFMutate within the Docker Container

Requirements

Build Instructions

  • Clone the repository and change into the directory
git clone https://github.com/smolang/RDFMutate.git
cd RDFMutate
  • Build the docker image using the provided docker file
docker build -t rdf-mutate .
  • Create a new container, where you can run the scripts in
docker run -it rdf-mutate
  • You can run the scripts in the container now
    • The directory /RDFMutate/build/libs contains the JAR file rdfmutate-<version>.jar
  • Alternatively, there are two scripts that directly call RDFMutate:
    • mutate.sh calls the mutation generator
    • test_system.sh runs a test of the setup (last line of output should be Mutation Generator works as expected.)
  • To run RDFMutate on inputs from your machine, you can use dockers -v option to connect your own volume to the container

Clone this wiki locally