Crate nom_tracable

nom-tracable is an extension of nom to trace parser.

Examples

The following example show a quick example.

use nom::character::complete::*;
use nom::IResult;
use nom_locate::LocatedSpan;
use nom_tracable::{tracable_parser, TracableInfo};

// Input type must implement trait Tracable
// nom_locate::LocatedSpan<T, TracableInfo> implements it.
type Span<'a> = LocatedSpan<&'a str, TracableInfo>;

// Apply tracable_parser by custom attribute
#[tracable_parser]
pub fn term(s: Span) -> IResult<Span, String> {
    let (s, x) = char('1')(s)?;
    Ok((s, x.to_string()))
}

#[test]
fn test() {
    // Configure trace setting
    let info = TracableInfo::new().forward(true).backward(true);
    let ret = term(LocatedSpan::new_extra("1", info));
    assert_eq!("\"1\"", format!("{:?}", ret.unwrap().1));
}

Structs

• TracableInfo
  Struct to have trace configuration.

Traits

• FragmentDisplay
  Trait to indicate the type can display as fragment.
• HasTracableInfo
  Trait to indicate TracableInfo is provided.
• Tracable
  Trait to indicate the type has information for tracing.

Functions

• cumulative_histogram
  Show cumulative histogram of parser call count.
• histogram
  Show histogram of parser call count.

Attribute Macros

• tracable_parser
  Custom attribute to enable trace