The aim of this repository is to simplify the current WoT TD tooling for generating the specification. WoT TD Tooling is a python project to automate the generation of 1) WoT resources: SHACL Shapes, JSON Schema, JSON-LD context, and RDF 2) Documentation: TD specification and ontology specifications
Here is an overview of the process:
This project leverages LinkML for modelling the Web of Things Thing Description information model.
The uv package manager.
git clone https://github.com/w3c/wot-thing-description-toolchain-tmp.git
cd wot-thing-description-toolchain-tmp
uv
uv run main.py -h
The main.py script supports various options:
uv run main.py [-h] [-l] [-s]
options:
-h, --help show this help message and exit
-l, --local-docs Boolean for local documentation generation.
-s, --serve-docs Boolean for serving the generated documentation.
Generate resources using the default schema and configuration:
uv run main.py
Generate documentation locally and serve it:
uv run main.py -l -s
resources/schemas/thing_description.yaml
resources/gens
resources/gens/linkml
We welcome contributions! Please fork the repository, create a branch, and submit a pull request. For major changes, please open an issue first to discuss what you would like to change.