aboutsummaryrefslogtreecommitdiff

kdl-schema

KDL Schema types and parsing.

examples

building a schema

use kdl_schema::*;
let schema = Schema {
    document: Document {
        info: Info {
            title: vec![TextValue {
                text: "Sample Schema".to_string(),
                lang: Some("en".to_string()),
            }],
            ..Info::default()
        },
        nodes: vec![Node {
            name: Some("name".to_string()),
            values: vec![Value {
                validations: vec![Validation::Type("string".to_string())],
                ..Value::default()
            }],
            ..Node::default()
        }]
    }
};
println!("{:?}", schema);

parsing a schema KDL

#[cfg(feature = "parse-knuffel")] {
    let schema_kdl = r#"
document {
    info {
        title "Sample Schema" lang="en"
        description "An example schema" lang="en"
        author "boringcactus"
    }
    node "name" {
        value {
            type "string"
        }
    }
    node "age" {
        value {
            type "number"
        }
    }
}
"#;
    let _matching_document = r#"
name "Joe"
age 69
"#;
    let schema = kdl_schema::Schema::parse(schema_kdl).unwrap();
    assert_eq!(schema.document.info.title[0].text, "Sample Schema");
}

referencing the schema schema

assert_eq!(kdl_schema::SCHEMA_SCHEMA.document.info.title[0].text, "KDL Schema");

cargo features

conditions blocking version 1.0.0

  • consistently good documentation
  • merge ref target over ref source if ref source has anything else
  • good API for parsing from a file
  • types actually match the schema (currently I'm omitting several things because the schema schema doesn't use them)
  • ergonomic builder API to define a schema in Rust in a non-ugly way
  • can generate KDL from schema object in Rust
  • can choose kdl or knuffel as parser
  • make sure required false in a prop works properly
  • validate the schema at parse time (ensure that e.g. refs are resolvable, IDs are unique)
  • make sure enums work with int values
  • allow rich types for language tags, modification dates, etc

license

Blue Oak Model License 1.0.0.