tomling 0.3.0

A TOML 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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

use winnow::{
    ascii::space0,
    combinator::{alt, empty, eof, fail, opt, peek, preceded},
    dispatch,
    stream::Stream as _,
    token::{any, one_of, take_while},
    ModalResult, Parser,
};

/// Parse a comment, w/o the trailing newline.
pub(crate) fn parse_comment(input: &mut &str) -> ModalResult<()> {
    preceded(
        '#',
        take_while(
            0..,
            // > Control characters other than tab (U+0000 to U+0008, U+000A to U+001F, U+007F) are
            // > not permitted in comments.
            |c| !matches!(c, '\0'..='\u{08}' | '\u{0a}'..='\u{1f}' | '\u{7f}'),
        ),
    )
    .void()
    .parse_next(input)
}

/// Parses a comment and newline (unless at EOF).
pub(crate) fn parse_comment_newline(input: &mut &str) -> ModalResult<()> {
    (parse_comment, alt((newline, eof.void())))
        .void()
        .parse_next(input)
}

/// Parse all whitespace (including newlines) and comments.
pub(crate) fn parse_whitespace_n_comments(input: &mut &str) -> ModalResult<()> {
    let mut start = input.checkpoint();
    loop {
        let _ = space0.parse_next(input)?;

        let next_token = opt(peek(any)).parse_next(input)?;
        match next_token {
            Some('#') => (parse_comment, newline).void().parse_next(input)?,
            Some('\n') => (newline).void().parse_next(input)?,
            Some('\r') => (newline).void().parse_next(input)?,
            _ => break,
        }

        let end = input.checkpoint();
        if start == end {
            break;
        }
        start = end;
    }

    Ok(())
}

/// Parse a newline.
pub(crate) fn newline(input: &mut &str) -> ModalResult<()> {
    dispatch! {any;
        '\n' => empty,
        '\r' => one_of('\n').void(),
        _ => fail,
    }
    .parse_next(input)
}