rst_parser 0.4.2

a reStructuredText parser
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
33
34
35

#![warn(clippy::pedantic)]

mod conversion;
mod pair_ext_parse;
mod pest_rst;
#[cfg(test)]
pub mod tests;
pub mod token;
pub mod transforms;

use anyhow::Error;
use pest::Parser;

use document_tree::Document;

use self::conversion::convert_document;
use self::pest_rst::{RstParser, Rule};
use self::transforms::standard_transform;

/// Parse into a document tree and resolve sections, but not references.
///
/// # Errors
/// Returns an error if parsing fails.
pub fn parse_only(source: &str) -> Result<Document, Error> {
    let pairs = RstParser::parse(Rule::document, source)?;
    convert_document(pairs)
}

/// Parse into a document tree and resolve sections and references.
///
/// # Errors
/// Returns an error if parsing fails.
pub fn parse(source: &str) -> Result<Document, Error> {
    parse_only(source).map(standard_transform)
}