cssengine 0.2.0

CSS Engine to parse and get declarations by class and query
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

mod animation;
mod parser;
mod style;
mod unit;

pub mod error;

pub use animation::*;
pub use declaration::Declaration;
pub use error::ParseError;
pub use parser::PseudoClass;
pub use style::StyleSheet;

pub(crate) use parser::*;
pub use unit::*;

use lexer::Token;

/// Parses a CSS string into a vector of rules.
///
/// # Parameters
/// - `input`: The CSS input string.
///
/// # Returns
/// - `Ok(Vec<Rule>)` if the input is successfully parsed.
/// - `Err(Vec<SyntaxError>)` if there are syntax errors in the input.
///
/// # Example
/// ```
/// let css = ".example { color: red; }";
/// let rules = cssengine::css_to_rules(css).expect("Failed to parse CSS");
/// ```
#[must_use]
pub fn css_to_rules(input: &str) -> Result<Vec<Rule<'_>>, Vec<SyntaxError<'_>>> {
    let tokens = Lexer::new(input).tokens();
    analyze_tokens(&tokens, input)?;
    let rules = Parser::new(tokens).parse();
    Ok(replace_vars(rules))
}

pub fn analyze(input: &str) -> Result<(), Vec<SyntaxError<'_>>> {
    let tokens = Lexer::new(input).tokens();
    let res = parser::analyze_tokens(&tokens, input);

    if !res.is_empty() {
        return Err(res);
    }

    Ok(())
}

pub fn analyze_tokens<'a>(
    tokens: &[Token<'a>],
    input: &'a str,
) -> Result<(), Vec<SyntaxError<'a>>> {
    let res = parser::analyze_tokens(&tokens, input);

    if !res.is_empty() {
        return Err(res);
    }

    Ok(())
}