Kgc 2026 conformance

.github/workflows/deploy.yml

@@ -0,0 +1,55 @@
+name: Deploy
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  deploy:
+    name: Deploy Release
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      id-token: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          submodules: true
+      - name: Set up JDK 21
+        uses: actions/setup-java@v5
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'maven'
+          server-id: central
+          server-username: MAVEN_USERNAME # env variable for username in deploy
+          server-password: MAVEN_CENTRAL_TOKEN # env variable for token in deploy
+      - name: Set project version from tag
+        run: |
+          TAG_VERSION="${{ github.ref_name }}"
+          # Remove leading 'v' if present (e.g. v0.1.4 -> 0.1.4)
+          TAG_VERSION="${TAG_VERSION#v}"
+
+          echo "Updating pom.xml version to: $TAG_VERSION"
+          mvn versions:set -DnewVersion="$TAG_VERSION" -DgenerateBackupPoms=false -B
+      - name: Deploy Maven package
+        # Locally run instead: mvn clean deploy -DskipTests -Pdeploy -Dgpg.passphrase=""
+        run: mvn deploy -B -Pdeploy -Dgpg.signer=bc -DskipTests
+        env:
+          MAVEN_USERNAME: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+          MAVEN_CENTRAL_TOKEN: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+          # ASCII-armored secret key (TSK), e.g. from `gpg --armor --export-secret-keys YOUR_ID`
+          MAVEN_GPG_KEY: ${{ secrets.GPG_ARMOR_KEY }}
+          MAVEN_GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
+      - name: JReleaser Release
+        run: mvn jreleaser:full-release -B -Pdeploy
+        env:
+          TAG_NAME: ${{ github.ref }}
+          JRELEASER_PROJECT_VERSION: ${{ github.ref }}
+          JRELEASER_JBANG_GITHUB_TOKEN: ${{ secrets.JBANG_CATALOG_TOKEN }}
+          JRELEASER_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/tests.yml

@@ -0,0 +1,32 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    name: Run Unit Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          submodules: true
+      - name: Set up JDK 21
+        uses: actions/setup-java@v5
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'maven'
+      - name: Build with Maven
+        run: mvn clean compile
+      - name: Test with Maven
+        run: mvn test
+      - name: Publish Test Report
+        uses: mikepenz/action-junit-report@v6
+        if: success() || failure() # always run even if the previous step fails
+        with:
+          report_paths: '**/target/surefire-reports/TEST-*.xml'

.gitmodules

@@ -0,0 +1,22 @@
+[submodule "src/test/resources/rdf-tests"]
+	path = src/test/resources/rdf-tests
+	url = https://github.com/w3c/rdf-tests.git
+	branch = main
+[submodule "rml-modules/rml-core"]
+	path = rml-modules/rml-core
+	url = https://github.com/kg-construct/rml-core.git
+[submodule "rml-modules/rml-cc"]
+	path = rml-modules/rml-cc
+	url = https://github.com/kg-construct/rml-cc.git
+[submodule "rml-modules/rml-io"]
+	path = rml-modules/rml-io
+	url = https://github.com/kg-construct/rml-io.git
+[submodule "rml-modules/rml-fnml"]
+	path = rml-modules/rml-fnml
+	url = https://github.com/kg-construct/rml-fnml.git
+[submodule "rml-modules/rml-lv"]
+	path = rml-modules/rml-lv
+	url = https://github.com/kg-construct/rml-lv.git
+[submodule "rml-modules/rml-io-registry"]
+	path = rml-modules/rml-io-registry
+	url = https://github.com/kg-construct/rml-io-registry.git

README.md

@@ -1,16 +1,58 @@
-# BURP: A Basic and Unassuming RML Processor
+# BURP-Error: A Basic and Unassuming RML Processor with RML Execution Report
 
-[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11037712.svg)](https://doi.org/10.5281/zenodo.11037712)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19455346.svg)](https://doi.org/10.5281/zenodo.19455346)
 
+BURP (Basic and Unassuming RML Processor) is a reference implementation for the
+new [RML specification](http://w3id.org/rml/portal) 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.
 
-BURP (Basic and Unassuming RML Processor) is a reference implementation for the new [RML specification](http://w3id.org/rml/portal) 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.
+BURP-Error is a fork of BURP that adds error handling to the RML processor, according to
+the [RML Execution Report](https://w3id.org/dre/rer). The project is a proof of concept, no maintenance guaranteed, but
+if you have any questions or issues, feel free to
+[open an issue on GitHub](https://github.com/jduchateau/BURP/issues/new).
+
+Warning: Joins are quadratic, in terms of iterations and number of multivalued join conditions values.
 
 ## Coverage matrix
 
-| [RML-Core](http://w3id.org/rml/core/spec) | [RML-IO](http://w3id.org/rml/io/spec) | [RML-CC](http://w3id.org/rml/cc/spec) | [RML-FNML](http://w3id.org/rml/fnml/spec) | [RML-Star](http://w3id.org/rml/star/spec) |
-| ----------------------------------------- | ------------------------------------- | ------------------------------------- | ----------------------------------------- | ----------------------------------------- |
-| ✔️ 100% coverage                          | 🚧 Source yes, Target WIP              | ✔️ 100% coverage                      | ✔️ 100% coverage                          | 🚧 WIP                                     |
+| RML module                                           | Test Cases: Pass / Fail / Total |
+|------------------------------------------------------|---------------------------------|
+| [RML-Core](https://w3id.org/rml/core/spec)           | ✅ 76 / 0 / 76                   |
+| [RML-IO](https://w3id.org/rml/io/spec)               | ✔️ 56 / 0 / 56*                 | 
+| [RML-IO-Registry](https://w3id.org/rml/io-registry/) | 🚧️ 52 / 50 / 102 Details below  | 
+| [RML-CC](https://w3id.org/rml/cc/spec)               | ✅ 35 / 0 / 35                   | 
+| [RML-FNML](https://w3id.org/rml/fnml/spec)           | ✅️ 20 / 0 / 20                  | 
+| [RML-Star](https://w3id.org/rml/star/spec)           | ❌ Not implemented               | 
+| [RML-LV](https://w3id.org/rml/lv/spec)               | ✅️ 41 / 0 / 41                  |
+| [RER](https://w3id.org/dre/rer)                      | 🪅 Demo implementation          |
+
+\* We consider 17 test cases in RML-IO to have issues. 
+
+### RML-IO-Registry coverage details
+
+BURP supports natively the following input sources:
+
+- rml:FilePath or rml:RelativePathSource — local files (supports rml:root and rml:path)
+- rml:CSV — CSV files (including CSVW tables and their dialects: encoding, delimiter, header, nulls)
+- rml:JSONPath — JSON sources ([RFC 9535](https://www.rfc-editor.org/rfc/rfc9535) JSONPath iterator)
+- rml:XPath — XML sources (XPath 1.0 iterator; supports namespace/prefix mappings for XPath reference formulations)
+- rml:SPARQL Results (CSV/TSV/XML/JSON) — SPARQL result files, SPARQL endpoints/services, and data dumps (VOID/SD)
+- rml:SQL2008Query and rml:SQL2008Table — relational database sources
+  (via D2RQ properties such as d2rq:jdbcDSN, d2rq:jdbcDriver, username, password)
+- DCAT Distribution / CSVW Table — remote files via DCAT downloadURL or CSVW url
+
+- Extensions possible see extending BURP
+
+## About the RML Execution Report
+
+The RML Execution Report (RER) is a taxonomy for describing the execution of an RML mapping, defined at [https://w3id.org/dre/rer](https://w3id.org/dre/rer).
+
+BURP-Error can output the execution report using the `rer` vocabulary.
+In addition, if your mapping is in Turtle format, BURP-Error will also output the execution report in a textual format with code snippets or your mappings instead of the rdf 1.2 statements pointers ([ptr](https://w3id.org/dre/ptr)).
+
+Notice; to locate prescicely the turtle token location, we use a custom turtle parser (in `turtleprov`) that admitedly is only 39/103 (37%) of RDF1.2 test cases and 217/313 (69%) of RDF1.1 test cases.
 
 ## Building BURP
 
@@ -27,7 +69,17 @@ Some libraries are available on GitHub's maven repository. Add a GitHub authenti
 
 ## Using BURP
 
-The run the R2RML processor, execute the following command:
+You can run BURP using [JBang](https://jbang.dev):
+
+```bash
+$ jbang burp@jduchateau [-h] [-b=<baseIRI>] -m=<mappingFile> [-o=<outputFile>]
+```
+
+*Note: JBang will automatically download the required JDK and resolve all project dependencies on the first run.*
+
+If you don't have JBang installed yet, see the [JBang Installation Guide](https://jbang.dev/download) to install it.
+
+Alternatively, if you prefer to run it using a local pre-built fat JAR and standard Java, execute the following command:
 
 ```bash
 $ java -jar burp.jar [-h] [-b=<baseIRI>] -m=<mappingFile> [-o=<outputFile>]
@@ -48,6 +100,24 @@ If no outputFile is provided and the RML mapping does not rely on RML-IO for tar
 
 ## Citation
 
+If you use BURP-Error, please cite our paper:
+
+```
+@inproceedings{duchateau2026rml-execution-report,
+  author       = {Jakub Duchateau and Dylan {Van Assche} and Christophe Debruyne},
+  editor       = {},
+  title        = {Beyond Exit Code 1: A Vocabulary for Execution Report of RML Processors (RER)},
+  booktitle    = {Proceedings of the 7th International Workshop on Knowledge Graph Construction
+                  co-located with 23rd Extended Semantic Web Conference ({ESWC} 2026),
+                  Dubrovnik, Croatia, May 10, 2026},
+  series       = {{CEUR} Workshop Proceedings},
+  volume       = {X},
+  publisher    = {CEUR-WS.org},
+  year         = {2026},
+  url          = {https://ceur-ws.org/Vol-X/paperX.pdf}
+}
+```
+
 If you use BURP, please cite our paper:
 
 ```