Skip to content

Refactoring cookbook

CLI examples for workspace refactoring. Replace /path/to/ontologies with your project folder (or use fixtures from a git clone).

Find usages

strixonomy refactor usages /path/to/ontologies 'http://example.org/people#Person'
strixonomy refactor usages /path/to/ontologies 'http://example.org/people#Person' --format json

Rename IRI

# Preview
strixonomy refactor rename /path/to/ontologies \
  --from 'http://example.org/people#Person' \
  --to 'http://example.org/people#Human' \
  --preview --format json

# Apply
strixonomy refactor rename /path/to/ontologies \
  --from 'http://example.org/people#Person' \
  --to 'http://example.org/people#Human'

Merge entities

strixonomy refactor merge /path/to/ontologies \
  --keep 'http://example.org/people#Person' \
  --merge 'http://example.org/people#Human' \
  --preview

Replace entity references

strixonomy refactor replace /path/to/ontologies \
  --from 'http://example.org/people#OldName' \
  --to 'http://example.org/people#NewName' \
  --preview

Migrate namespace

strixonomy refactor migrate-namespace /path/to/ontologies \
  --from 'http://example.org/people#' \
  --to 'http://example.org/v2/people#' \
  --preview

Move entity

strixonomy refactor move /path/to/ontologies 'http://example.org/people#Student' \
  --to /path/to/ontologies/students.ttl \
  --preview

Extract module

strixonomy refactor extract /path/to/ontologies \
  --entities 'http://example.org/people#Person,http://example.org/people#Student' \
  --out /path/to/ontologies/core.ttl \
  --leave-stub \
  --locality \
  --preview

Validate after refactor

strixonomy validate /path/to/ontologies

User guide: Refactoring guide