Decodal/README.md

1.2 KiB

Decodal

Decodal is a small deterministic DSL for describing, composing, validating, and materializing structured data.

It is designed around a lightweight Rust library:

  • host-supplied imports through SourceLoader
  • no filesystem access in the library core
  • concrete and abstract values with constraints and defaults
  • deterministic expression evaluation
  • optional regex support behind a Cargo feature
  • browser playground support through WebAssembly

Library crate

Embedded hosts should depend on decodal and provide imports with a SourceLoader.

[dependencies]
decodal = "0.1"

CLI

A standalone CLI is kept in this repository as the decodal-cli workspace package. It builds a decodal binary, but it is not the primary crates.io package.

Run a Decodal file from the repository:

cargo run -q -p decodal-cli -- examples/advanced/main.dcdl

Enable optional regex support when needed:

cargo run -q -p decodal-cli --features regex -- examples/regex/main.dcdl

Web playground

The static documentation site and browser playground live under:

site/decodal-site/

License

Licensed under either of:

  • Apache License, Version 2.0
  • MIT license

at your option.