kparse 1.0.1

Tracking and better error handling for nom parsers
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

//!
//! Some utilities for debug output.
//!

pub(crate) mod error;
pub(crate) mod tracks;

use nom::bytes::complete::take_while_m_n;
use nom::{AsBytes, InputIter, InputLength, InputTake, Offset, Slice};
use std::ops::{RangeFrom, RangeTo};

/// Maps a width value from the formatstring to a variant.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(crate) enum DebugWidth {
    /// Debug flag, can be set with width=0.
    Short,
    /// Debug flag, can be set with width=1.
    Medium,
    /// Debug flag, can be set with width=2.
    Long,
}

impl From<Option<usize>> for DebugWidth {
    fn from(value: Option<usize>) -> Self {
        match value {
            None | Some(0) => DebugWidth::Short,
            Some(1) => DebugWidth::Medium,
            Some(2) => DebugWidth::Long,
            _ => DebugWidth::Short,
        }
    }
}

/// Cuts off the text at 20/40/60 characters.
pub(crate) fn restrict_str<T: AsBytes + Copy>(w: DebugWidth, text: T) -> T
where
    T: Offset
        + InputTake
        + InputIter
        + InputLength
        + Slice<RangeFrom<usize>>
        + Slice<RangeTo<usize>>,
{
    match w {
        DebugWidth::Short => restrict_str_n(20, text),
        DebugWidth::Medium => restrict_str_n(40, text),
        DebugWidth::Long => restrict_str_n(60, text),
    }
}

/// Cuts off the text at max_len characters.
pub(crate) fn restrict_str_n<T: AsBytes + Copy>(max_len: usize, text: T) -> T
where
    T: Offset
        + InputTake
        + InputIter
        + InputLength
        + Slice<RangeFrom<usize>>
        + Slice<RangeTo<usize>>,
{
    match take_while_m_n::<_, _, nom::error::Error<T>>(0, max_len, |_c| true)(text) {
        Ok((_, v)) => v,
        Err(_) => text,
    }
}

/// Cuts off the text at 20/40/60 characters.
pub(crate) fn restrict<I>(w: DebugWidth, span: I) -> I
where
    I: Copy,
    I: Offset
        + InputTake
        + InputIter
        + InputLength
        + Slice<RangeFrom<usize>>
        + Slice<RangeTo<usize>>,
{
    match w {
        DebugWidth::Short => restrict_n(20, span),
        DebugWidth::Medium => restrict_n(40, span),
        DebugWidth::Long => restrict_n(60, span),
    }
}

/// Cuts off the text at max_len characters.
pub(crate) fn restrict_n<I>(max_len: usize, span: I) -> I
where
    I: Copy,
    I: Offset
        + InputTake
        + InputIter
        + InputLength
        + Slice<RangeFrom<usize>>
        + Slice<RangeTo<usize>>,
{
    match take_while_m_n::<_, _, nom::error::Error<I>>(0, max_len, |_c| true)(span) {
        Ok((_, v)) => v,
        Err(_) => span,
    }
}