The tool translates mapping rules from YARRRML in a turtle-based serialization of RML or R2RML.
Project description
YATTER
The tool translates mapping rules from YARRRML in a turtle-based serialization of RML or R2RML.
Installation:
pip install yatter
Execution from CLI
To execute from command line run the following:
- From YARRRML to [R2]RML
python3 -m yatter -i path_to_input_yarrrml.yml -o path_to_rdf_mapping.ttl [-f R2RML]
- From [R2]RML to YARRRML
python3 -m yatter -i path_to_input_rdf_mapping.ttl -o path_to_output_yarrrml.yml [-f R2RML]
-f R2RML is an optional parameter for translating input YARRRML to R2RML (and inverse)
Execution as a library
If you want to include the module in your implementation:
- for translating YARRRML mapping to RML mappings (and inverse):
import yatter
from ruamel.yaml import YAML
# YARRRML to RML
yaml = YAML(typ='safe', pure=True)
rml_content = yatter.translate(yaml.load(open("path-to-yarrrml")))
# RML to YARRRML
yarrrml_content = yatter.inverse_translate("rdf_mapping_content")
- for translating YARRRML mappings to R2RML mappings (and inverse):
import yatter
from ruamel.yaml import YAML
R2RML_URI = 'http://www.w3.org/ns/r2rml#'
# YARRRML to R2RML
yaml = YAML(typ='safe', pure=True)
rml_content = yatter.translate(yaml.load(open("path-to-yarrrml")), mapping_format=R2RML_URI)
# R2RML to YARRRML
yarrrml_content = yatter.inverse_translate("rdf_mapping_content", mapping_format=R2RML_URI)
- for merging TriplesMap based on id:
import yatter
list_yarrrml_mappings = ["content_mapping_yarrrml1", "content_mapping_yarrrml1"]
yarrrml_content = yatter.merge_mappings(list_yarrrml_mappings)
Specifications conformant:
These are the following specifications used by the translation process:
- YARRRML: https://w3id.org/kg-construct/yarrrml
- R2RML: https://www.w3.org/TR/r2rml/
- RML: https://rml.io/spec
- RML-star: https://w3id.org/rml/star/spec
- RML-IO: https://w3id.org/rml/io/spec
- RML-FNML: https://w3id.org/rml/fnml/spec
- RML-CC: https://w3id.org/rml/cc/spec
To be implemented soon:
- RML-core: https://w3id.org/rml/core/spec
Cite this work:
If you used Yatter in your work, please cite the ICWE2023 paper:
@inproceedings{iglesias2023human,
title={Human-Friendly RDF Graph Construction: Which One Do You Chose?},
author={Iglesias-Molina, Ana and Chaves-Fraga, David and Dasoulas, Ioannis and Dimou, Anastasia},
booktitle={International Conference on Web Engineering},
pages={262--277},
year={2023},
doi={10.1007/978-3-031-34444-2_19},
organization={Springer}
}
Authors
CiTIUS - Universidade de Santiago de Compostela (2023-now):
- David Chaves-Fraga
- Rubén Buján Vide (Final bachelor thesis - Mapping normalization, RML-cc and library management)
Ontology Engineering Group - Universidad Politécnica de Madrid (2021-2023):
- David Chaves-Fraga
- Marino González García (Final bachelor thesis - Systematic Testing)
- Luis López Piñero (Final bachelor thesis - v0.1)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yatter-2.0.3.tar.gz.
File metadata
- Download URL: yatter-2.0.3.tar.gz
- Upload date:
- Size: 32.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
195fb2a686eb0fe7b3b39ef9738df3829d24162687a80e07569d0a6ccc60baef
|
|
| MD5 |
f828060dcfb8643ee9ae1846db41a5e5
|
|
| BLAKE2b-256 |
a43c7d5082dfc52704d148a38999af5deeffd6181209fea495e5f8a2888b88e0
|
Provenance
The following attestation bundles were made for yatter-2.0.3.tar.gz:
Publisher:
pypi-publish.yml on citiususc/yatter
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yatter-2.0.3.tar.gz -
Subject digest:
195fb2a686eb0fe7b3b39ef9738df3829d24162687a80e07569d0a6ccc60baef - Sigstore transparency entry: 607621476
- Sigstore integration time:
-
Permalink:
citiususc/yatter@e4eea23f38e605d22ed669b1e745cc96189eec35 -
Branch / Tag:
refs/tags/v2.0.3 - Owner: https://github.com/citiususc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@e4eea23f38e605d22ed669b1e745cc96189eec35 -
Trigger Event:
push
-
Statement type:
File details
Details for the file yatter-2.0.3-py3-none-any.whl.
File metadata
- Download URL: yatter-2.0.3-py3-none-any.whl
- Upload date:
- Size: 36.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
83cc77f253c59934f8a9557b1f5fff5fe04b09edafd3da73a68118696af51726
|
|
| MD5 |
a3efa0cc07e4fe1c13c428a483ab1ac1
|
|
| BLAKE2b-256 |
0ceb989d48127ef54c5b5b68752b1828c7d273d86b8c91df90018b33a23b9ada
|
Provenance
The following attestation bundles were made for yatter-2.0.3-py3-none-any.whl:
Publisher:
pypi-publish.yml on citiususc/yatter
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yatter-2.0.3-py3-none-any.whl -
Subject digest:
83cc77f253c59934f8a9557b1f5fff5fe04b09edafd3da73a68118696af51726 - Sigstore transparency entry: 607621478
- Sigstore integration time:
-
Permalink:
citiususc/yatter@e4eea23f38e605d22ed669b1e745cc96189eec35 -
Branch / Tag:
refs/tags/v2.0.3 - Owner: https://github.com/citiususc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@e4eea23f38e605d22ed669b1e745cc96189eec35 -
Trigger Event:
push
-
Statement type: