Build Status Downloads Version Documentation License

bml

BML Markup Language

[BML] is a simplified [XML] used by the [SNES Preservation Project], see the BML [grammar] using [PEG] as input for the [pest] parser.

In contrast to its C++ [reference] implementation, this Rust implementation parses indents by pushing them on a stack to compare them instead of counting characters (stack-based-indent) and it allows tabulators between attributes (tabular-attributes) and between colons and multi-line data (tabular-colon-data) supporting tabulator-based along with space-based alignments.

Syntax highlighting is trivial, see [vim-bml].

Usage

This crate works on Rust stable channel by adding it to Cargo.toml:

toml [dependencies] bml = "0.3"

Examples

```rust use bml::BmlNode; use std::convert::TryFrom;

let root = BmlNode::try_from(concat!( "server\n", " path: /core/www/\n", " host: example.com\n", " port: 80\n", " service: true\n", " proxy\n", " host: proxy.example.com\n", " port: 8080\n", " authentication: plain\n", " description\n", " :Primary web-facing server\n", " :Provides commerce-related functionality\n", "\n", "server\n", " // ...\n", " proxy host=\"proxy.example.com\" port=\"8080\"\n", " authentication: plain\n", )).unwrap();

let (name, node) = root.nodes().next().unwrap();

asserteq!(name, "server"); asserteq!(node.named("port").next().unwrap().value(), "80"); ```

License

Licensed under ISC.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the works by you shall be licensed as above, without any additional terms or conditions.