Note: this repository serves as an up-to-date version of the project found in the Shape Fragments repository. This package uses an updated version of the SHACL Logical Syntax Parser.
The main goal of this project is to translate SHACL shapes to corresponding SPARQL queries according to the shape fragments specification in our paper.
At the moment, the translation from SHACL shapes to unary SPARQL queries is working. You can use it as a library; the test files can be considered an example usage. See tests/unaryquery_test.py, the pytest function test_unary_query_structural.
The translation from SHACL shapes to neighborhood SPARQL queries is broken at the moment. An older, working version can be found here.
- python 3.9.7
- python packages listed in
requirements.txt
You need to add the slsparser folder from sls_project as a subpackage of ssf.
Set up a Python virtual environment and install packages from requirements.txt.
Let's say the virtual environment is located in .env:
$ source .env/bin/activate$ python -m pip install -r requirements.txt
The interface to the software is located in ssf.py.
To run the program (while having the virtual environment activated):
$ python ssf.py
This will display the help string. To generate a SPARQL query from a shapes graph:
$ python ssf.py --frag shapesgraph.ttl
where shapesgraph.ttl is the relevant shapes graph in turtle format.
To generate SPARQL queries which ignore tests (as generated for the experiments in the paper):
$ python ssf.py --frag -i shapesgraph.ttl