limu 0.1.0

A diagram layout engine. It reads Mermaid and leaves the drawing to your program.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

//! Sankey diagrams, as Pele's src/diagrams/sankey reads and draws them: a lexer and a parser
//! of the CSV that Mermaid's Jison grammar reads, the model they fill, and a layout that
//! places the nodes in columns by their flow and draws the bands between them, with a label
//! beside each node.
//!
//! Offsets into the text are bytes. The columns of errors are UTF-16 code units, as Pele's
//! are.

mod db;
mod layout;
mod lexer;
mod parser;
mod render;

#[cfg(test)]
mod tests;

pub(crate) use db::SankeyDb;
pub(crate) use render::layout;

use crate::errors::Error;

/// Parses a sankey diagram's text, as the parse of Pele's sankey diagram does. title is the
/// one its front matter gives. The text is prepared as Pele's prepareTextForParsing prepares
/// it before it is parsed, and an error is placed in the text before it was prepared.
pub(crate) fn parse(source: &str, title: Option<&str>) -> Result<SankeyDb, Error> {
    let mut db = SankeyDb::default();
    db.title = title.filter(|t| !t.is_empty()).map(str::to_string);
    let src = parser::prepare_text_for_parsing(source, None);
    parser::parse_sankey(&src, &mut db, source)?;
    Ok(db)
}