https://github.com/TopQuadrant/shacl
SHACL API in Java based on Apache Jena
https://github.com/TopQuadrant/shacl
shacl
Last synced: 7 months ago
JSON representation
SHACL API in Java based on Apache Jena
- Host: GitHub
- URL: https://github.com/TopQuadrant/shacl
- Owner: TopQuadrant
- License: apache-2.0
- Created: 2015-05-24T07:34:24.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-05-06T17:02:47.000Z (7 months ago)
- Last Synced: 2025-05-06T18:23:14.294Z (7 months ago)
- Topics: shacl
- Language: Java
- Homepage:
- Size: 2.9 MB
- Stars: 226
- Watchers: 63
- Forks: 63
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-semantic-shapes - TopBraid SHACL API - central/v/org.topbraid/shacl" align="top"> <img alt="Maven Central Last Update" src="https://img.shields.io/maven-central/last-update/org.topbraid/shacl" align="top"> - Supports SHACL Core, SHACL-SPARQL, SHACL rules; based on Jena; `Apache-2.0` license; `Java`. (SHACL Validators)
- awesome-semantic-web - TopQuadrant/shacl - SHACL API in Java based on Apache Jena. (SHACL Implementations / BBedit)
- awesome-semantic-web - TopQuadrant/shacl - SHACL API in Java based on Apache Jena. (SHACL Implementations / BBedit)
- awesome-semantic-tools - SHACL API - SHACL API in Java based on Apache Jena (Uncategorized / Uncategorized)
README
# TopBraid SHACL API
[](https://github.com/topquadrant/shacl/releases/latest)
**An open source implementation of the W3C Shapes Constraint Language (SHACL) based on Apache Jena.**
Contact: Ashley Caselli (ashley.caselli@unige.ch)\
Original developer: Holger Knublauch (holger@topquadrant.com)
Can be used to perform SHACL constraint checking and rule inferencing in any Jena-based Java application.
This API also serves as a reference implementation of the SHACL spec.
Coverage:
* [SHACL Core and SHACL-SPARQL validation](https://www.w3.org/TR/shacl/)
* [SHACL Advanced Features (Rules etc)](https://www.w3.org/TR/shacl-af/)
Former Coverage until version 1.4.0
* [SHACL Compact Syntax](https://w3c.github.io/shacl/shacl-compact-syntax/)
Former Coverage until version 1.3.2
* [SHACL JavaScript Extensions](https://www.w3.org/TR/shacl-js/)
The TopBraid SHACL API is internally used by the European Commission's generic [SHACL-based RDF validator](https://www.itb.ec.europa.eu/shacl/any/upload) (used to validate RDF content against SHACL shapes)
and [SHACL shape validator](https://www.itb.ec.europa.eu/shacl/shacl/upload) (used to validate SHACL shapes themselves).
The same code is used in the TopBraid products (currently aligned with the TopBraid 7.1 release).
Feedback and questions should become GitHub issues or sent to TopBraid Users mailing list:
https://groups.google.com/forum/#!forum/topbraid-users
Please prefix your messages with [SHACL API]
To get started, look at the class ValidationUtil in
the package org.topbraid.shacl.validation.
There is also an [Example Test Case](../master/src/test/java/org/topbraid/shacl/ValidationExample.java)
# How to use it
- [Application dependency](#application-dependency)
- [Docker](#docker-usage)
- [Command line](#command-line-usage)
## Application dependency
Releases are available in the [central maven repository](https://mvnrepository.com/artifact/org.topbraid/shacl):
> :warning: Replace `*VER*` with the actual package version. Consult the package page to find what versions are available.
```
org.topbraid
shacl
*VER*
```
## Docker Usage
You can use the tool as Docker image. Prebuild Docker images are available at the [GitHub Container Registry](https://github.com/ashleycaselli/shacl/pkgs/container/shacl). The SHACL API runs inside the Docker image, with two possible commands available. To run the validator:
> :warning: It is generally better to use a fixed version of the docker image, rather than the `latest` tag. Consult the package page to find what versions are available.
```
docker run --rm -v /path/to/data:/data ghcr.io/ashleycaselli/shacl:latest validate -datafile /data/myfile.ttl -shapesfile /data/myshapes.ttl
```
To run rule inferencing:
```
docker run --rm -v /path/to/data:/data ghcr.io/ashleycaselli/shacl:latest infer -datafile /data/myfile.ttl -shapesfile /data/myshapes.ttl
```
Any other command after `ghcr.io/ashleycaselli/shacl:latest` will print the following help page:
```
Please use this docker image as follows:
docker run -v /path/to/data:/data ghcr.io/ashleycaselli/shacl:latest [COMMAND] [PARAMETERS]
COMMAND:
validate
to run validation
infer
to run rule inferencing
PARAMETERS:
-datafile /data/myfile.ttl [MANDATORY]
input to be validated (only .ttl format supported)
-shapesfile /data/myshapes.ttl [OPTIONAL]
shapes for validation (only .ttl format supported)
-maxiterations 1 [OPTIONAL] - default is 1
iteratively applies the inference rules until the maximum number of iterations is reached (or no new triples are inferred)
-validateShapes [OPTIONAL]
in case you want to include the metashapes (from the tosh namespace in particular)
-addBlankNodes [OPTIONAL]
adds the blank nodes to the validation report
-noImports [OPTIONAL]
disables the import of external ontologies
```
### Build image locally
You can build your own Docker image locally by using the `Dockerfile` provided in the `.docker` folder. It includes a minimal Java Runtime Environment for the SHACL API that clocks in at ~85Mb. To build it locally use:
> :warning: If no value for the `ARCH_BASE` variable is provided, the image will be built using the default architecture value (**eclipse-temurin:21-alpine**)
```
docker build \
-f .docker/Dockerfile \
-t ghcr.io/topquadrant/shacl:VER \
--build-arg VERSION=VER .
```
If you'd like to build the image locally in an `x86` architecture, use:
```
docker build
-f .docker/Dockerfile \
-t ghcr.io/topquadrant/shacl:VER \
--build-arg VERSION=VER \
--build-arg ARCH_BASE=eclipse-temurin:21-alpine .
```
If your architecture is `arm`, use:
```
docker build \
-f .docker/Dockerfile \
-t ghcr.io/topquadrant/shacl:VER \
--build-arg VERSION=VER \
--build-arg ARCH_BASE=amazoncorretto:21-alpine3.20-jdk .
```
## Command Line Usage
Download the latest release from:
`https://repo1.maven.org/maven2/org/topbraid/shacl/`
The binary distribution is:
`https://repo1.maven.org/maven2/org/topbraid/shacl/*VER*/shacl-*VER*-bin.zip`.
Two command line utilities are included: `shaclvalidate` (performs constraint validation) and `shaclinfer` (performs SHACL rule inferencing).
To use them, set up your environment similar to https://jena.apache.org/documentation/tools/ (note that the SHACL download includes Jena).
For example, on Windows:
```
SET SHACLROOT=C:\Users\Holger\Desktop\shacl-1.4.3-bin
SET PATH=%PATH%;%SHACLROOT%\bin
```
As another example, for Linux, add to .bashrc these lines:
```
# for shacl
export SHACLROOT=/home/holger/shacl/shacl-1.4.3-bin/shacl-1.4.3/bin
export PATH=$SHACLROOT:$PATH
```
After setting up the environment, you can run the command line utilities (i.e. validation) using the following command:
- Windows: `shaclvalidate.bat -datafile myfile.ttl -shapesfile myshapes.ttl`
- Linux/Unix: `shaclvalidate.sh -datafile myfile.ttl -shapesfile myshapes.ttl`
Both tools (Windows, Linux) take the parameters described in the [Docker Usage](#docker-usage) section. **Currently, only Turtle (.ttl) files are supported.**
The tool print the validation report or the inferences graph to the output screen.