maud-extensions-macros 0.6.7

Proc-macro implementation for maud-extensions.
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

// CSS helper-macro diagnostics.
use proc_macro2::Span;
use syn::Error;

use crate::internal_diagnostics::error_with_help;

pub(crate) fn raw_expects_exactly_one_string_literal(span: Span) -> Error {
    error_with_help(
        span,
        "raw! expects exactly one string literal argument",
        "write raw!(\"...\") when you need to inject literal CSS without DSL rewriting",
    )
}

pub(crate) fn macro_arguments_must_use_parentheses(span: Span, macro_name: &str) -> Error {
    error_with_help(
        span,
        format!("{macro_name}! expects macro arguments in parentheses"),
        format!("write {macro_name}!(...) instead of {macro_name}!{{...}} or {macro_name}![...]"),
    )
}

pub(crate) fn at_rule_requires_body(span: Span, macro_name: &str) -> Error {
    error_with_help(
        span,
        format!("{macro_name}! expects a prelude and trailing `{{ ... }}` body"),
        format!(
            "write {macro_name}!((condition), {{ ... }}) or {macro_name}!(\"condition\", {{ ... }})"
        ),
    )
}

pub(crate) fn at_rule_requires_prelude_then_body(span: Span, macro_name: &str) -> Error {
    error_with_help(
        span,
        format!("{macro_name}! expects `{macro_name}!(prelude, {{ ... }})`"),
        "place the prelude first, then a comma, then exactly one trailing brace-delimited CSS body",
    )
}

pub(crate) fn at_rule_accepts_only_prelude_and_body(span: Span, macro_name: &str) -> Error {
    error_with_help(
        span,
        format!("{macro_name}! only accepts a prelude and one body block"),
        "remove extra trailing arguments or fold that CSS into the single `{ ... }` body",
    )
}

pub(crate) fn at_rule_requires_non_empty_prelude(span: Span, macro_name: &str) -> Error {
    error_with_help(
        span,
        format!("{macro_name}! requires a non-empty prelude"),
        "pass the selector, query, or rule prelude before the body block",
    )
}

pub(crate) fn unit_requires_value(span: Span, macro_name: &str) -> Error {
    error_with_help(
        span,
        format!("{macro_name}! requires a value"),
        format!("write {macro_name}!(12) or {macro_name}!(1.5) with exactly one value"),
    )
}

pub(crate) fn unit_expects_exactly_one_value(span: Span, macro_name: &str) -> Error {
    error_with_help(
        span,
        format!("{macro_name}! expects exactly one value argument"),
        "remove extra comma-separated arguments so the helper expands to a single CSS value",
    )
}