SML
SML is a simple markup language. It is designed to convert human readable information into
Rust data-structures.
Data Format
- Indentation has meaning and is 4 spaces, relative to the top key.
- All values must be double quoted.
- Every key/value combination must be nested in a key. For example
hobbit: "Frodo"
by itself is invalid. It can be written:
hobbit:
name: "Frodo"
- Separation of lines has meaning.
- Keys may not include
:.
- Double quotes in values must be escaped using
\".
- Everything after the second double quote is ignored (and can be used for commenting).
- There can be an arbitary amount of whitespace and returns before the first key and after the
last key.
Example
```rust
use small::{Data, Small, SmallError};
[derive(Debug)]
struct Hobbit {
name: String,
age: u32,
friends: Vec,
bicycle: Option,
}
impl Small for Hobbit {
fn from_data(data: Data) -> Result {
Ok(Self {
name: String::sml(&data, "hobbit::name")?,
age: u32::sml(&data, "hobbit::age")?,
friends: Vec::::sml(&data, "hobbit::friends::hobbit")?,
bicycle: Option::::sml(&data, "hobbit::bicycle")?,
})
}
}
fn main() {
let s = r#"
hobbit:
name: "Frodo Baggins"
age: "98"
friends:
hobbit:
name: "Bilbo Baggins"
age: "176"
hobbit:
name: "Samwise Gamgee"
age: "66""#;
let frodo = Hobbit::from_str_debug(s);
}
```