rsass 0.29.2

Sass implementation in pure rust (not complete yet)
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

use super::{PResult, Span};
use crate::input::SourcePos;
use nom::{character::complete::one_of, Finish};
use nom_language::error::{VerboseError, VerboseErrorKind};
use std::fmt;

/// An error encountered when parsing sass.
///
/// This contains an error message (currently just a String, and often
/// not very descriptive) and informaion on where in the parsed data
/// the error occured.
#[derive(Debug, PartialEq, Eq)]
pub struct ParseError {
    msg: String,
    pos: SourcePos,
}

impl std::error::Error for ParseError {}

impl ParseError {
    /// Check a nom result for errors.
    ///
    /// This differs from a `From<nom::Err>` implementation in that an
    /// `Ok` result with remaining unparsed data is also considered an
    /// error.
    pub fn check<T>(res: PResult<T>) -> Result<T, Self> {
        let (rest, value) = res.finish()?;
        if rest.fragment().is_empty() {
            Ok(value)
        } else {
            Err(Self::new("Expected end of file.", rest.to_owned()))
        }
    }

    pub(crate) fn new<Msg>(msg: Msg, pos: SourcePos) -> Self
    where
        Msg: Into<String>,
    {
        Self {
            msg: msg.into(),
            pos,
        }
    }
}

impl From<VerboseError<Span<'_>>> for ParseError {
    fn from(value: VerboseError<Span<'_>>) -> Self {
        let (msg, pos) = value
            .errors
            .iter()
            .filter_map(|(pos, kind)| {
                match kind {
                    VerboseErrorKind::Context(ctx) => {
                        Some((ctx.to_string(), pos))
                    }
                    VerboseErrorKind::Char(ch) if *ch == '\'' => {
                        Some((format!("Expected {ch}."), pos))
                    }
                    VerboseErrorKind::Char(ch) => {
                        Some((format!("expected {:?}.", ch.to_string()), pos))
                    }
                    VerboseErrorKind::Nom(_) => None, // Try the next one!
                }
            })
            .next()
            .or_else(|| {
                value.errors.first().map(|(pos, _)| {
                    if pos.is_at_end() {
                        ("expected more input.".to_string(), pos)
                    } else if let PResult::Ok((_, b)) = one_of(")}]")(*pos) {
                        (format!("unmatched \"{b}\"."), pos)
                    } else {
                        ("Parse error.".to_string(), pos)
                    }
                })
            })
            .unwrap();
        Self::new(msg, pos.sanitize_end().to_owned())
    }
}

impl fmt::Display for ParseError {
    fn fmt(&self, out: &mut fmt::Formatter) -> fmt::Result {
        writeln!(out, "{}", self.msg)?;
        self.pos.show(out)
    }
}