Skip to content

README.md

Latest commit

 

History

History
156 lines (113 loc) · 5.28 KB

README.md

File metadata and controls

156 lines (113 loc) · 5.28 KB

mobilityDCAT-AP SHACL Validation

Validation suite for mobilityDCAT-AP 1.1.0 compliance using SHACL shapes.

Quick Start

# Install dependencies
uv sync

# Validate single file
uv run scripts/validate.py --data sample_data/baseline-dcat-ap/negatives/B-N-01-missing-catalog-title.ttl --shacl shacl/

# Validate with verbose output
uv run scripts/validate.py --data sample_data/mobility/negatives/M-N-01-missing-mandatory-properties-dataset.ttl --shacl shacl/ -v

Run All Test Suites

# All baseline DCAT-AP tests
uv run scripts/validate.py --data sample_data/baseline-dcat-ap/ --shacl shacl/

# All mobility-specific tests
uv run scripts/validate.py --data sample_data/mobility/ --shacl shacl/

# All multilingual tests
uv run scripts/validate.py --data sample_data/multilingual/ --shacl shacl/

# All partial graph tests
uv run scripts/validate.py --data sample_data/partial_graphs/ --shacl shacl/

# All range constraint tests
uv run scripts/validate.py --data sample_data/ranges/ --shacl shacl/

# All vocabulary tests
uv run scripts/validate.py --data sample_data/vocabularies/ --shacl shacl/

# Run everything
uv run scripts/validate.py --data sample_data/ --shacl shacl/

Docker Usage

Build Image

docker build -t mobilitydcat-validator .

Validate Files

# Single file
docker run -v %cd%/sample_data:/data mobilitydcat-validator \
  --data /data/baseline-dcat-ap/negatives/B-N-01-missing-catalog-title.ttl \
  --shacl /validation/shacl/

# Directory
docker run -v %cd%/sample_data:/data mobilitydcat-validator \
  --data /data/baseline-dcat-ap/ \
  --shacl /validation/shacl/

# Verbose output
docker run -v %cd%/sample_data:/data mobilitydcat-validator \
  --data /data/mobility/ \
  --shacl /validation/shacl/ \
  -v

Using Docker Compose

# Run validation
docker-compose run validator --data /data/baseline-dcat-ap/ --shacl /validation/shacl/

# Run mobility tests
docker-compose run validator --data /data/mobility/ --shacl /validation/shacl/

Platform-Specific Commands

Linux/Mac:

docker run -v $(pwd)/sample_data:/data mobilitydcat-validator --data /data/ --shacl /validation/shacl/

Windows (CMD):

docker run -v %cd%/sample_data:/data mobilitydcat-validator --data /data/ --shacl /validation/shacl/

Windows (PowerShell):

docker run -v ${PWD}/sample_data:/data mobilitydcat-validator --data /data/ --shacl /validation/shacl/

Run Issue #160 Tests

Validate specific test cases from Issue #160:

# Test Case 1: Missing language tag detection
uv run scripts/validate.py --data sample_data/multilingual/negatives/L-N-01-missing-language-tag.ttl --shacl shacl/ -v

# Test Case 2: Language mismatch (NOT YET DETECTED)
uv run scripts/validate.py --data sample_data/multilingual/negatives/L-N-02-mismatched-language-tags.ttl --shacl shacl/ -v

# Test Case 3: Empty multilingual field detection
uv run scripts/validate.py --data sample_data/multilingual/negatives/L-N-03-empty-multilingual-field.ttl --shacl shacl/ -v

# Test Case 4: Invalid language tag detection
uv run scripts/validate.py --data sample_data/multilingual/negatives/L-N-04-invalid-language-tag.ttl --shacl shacl/ -v

# Distribution without accessURL
uv run scripts/validate.py --data sample_data/partial_graphs/negatives/P-N-02-distribution-without-access-url.ttl --shacl shacl/ -v

Expected Results

✓ Negative tests (N-*): Should detect violations ⚠️ Positive tests (P-*): Currently incomplete - missing mandatory properties ✗ Baseline DCAT-AP positives (B-P-*): Expected to fail (missing mobilityDCAT-AP mandatory properties like mobilityTheme, spatial, accrualPeriodicity)

Test Categories

  • baseline-dcat-ap/ - Tests base DCAT-AP compliance
  • mobility/ - Tests mobility-specific properties
  • multilingual/ - Tests language tag validation
  • partial_graphs/ - Tests individual class validation
  • ranges/ - Tests type/class constraints
  • vocabularies/ - Tests controlled vocabulary URIs
  • regression/ - Tests previously fixed bugs

Remaining

  • Language mismatch detection- Current shapes detect OTHER violations but NOT the specific language inconsistency. Requires SPARQL constraint.

SHACL Files

Note: Example test cases and documentation are being updated to align with the new three-file SHACL structure (shapes + ranges + MDR vocabularies). Updated examples will be available once PR #178 is merged in the main repository.

  • shacl/mobilitydcat-ap_1.1.0_shacl_shapes.ttl — Basic validation (cardinality, datatypes, mandatory properties)
  • shacl/mobilitydcat-ap_1.1.0_shacl_range.ttl — Range constraints (sh:class validations)
  • shacl/mobilitydcat-ap_1.1.0_shacl_mdr-vocabularies.shape.ttl — Controlled vocabulary validation

Specification Alignment

Shapes are aligned with:

Recent Fixes

  • Fixed Catalog dct:identifier cardinality: changed from mandatory (1..*) to optional (0..1) per spec §4.4.3