waddling-errors-macros 0.7.3

Procedural macros for structured error codes with compile-time validation and taxonomy enforcement
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

//! Test: Sequence value validation passes with valid u16 constants
//!
//! This test verifies that diag! with strict(sequence_values) validation
//! accepts sequences that are properly defined u16 constants.

use waddling_errors_macros::{component, diag, primary, sequence, setup};

setup! {
    components = crate::components,
    primaries = crate::primaries,
    sequences = crate::sequences,
}

// Define valid components
pub mod components {
    use waddling_errors_macros::component;

    component! {
        pub enum Component {
            Auth {
                docs: "Authentication component",
            },
        }
    }

    pub use Component::*;
}

// Define valid primaries
pub mod primaries {
    use waddling_errors_macros::primary;

    primary! {
        pub enum Primary {
            Token {
                docs: "Token errors",
            },
        }
    }
}

// Define valid sequences with numeric values
pub mod sequences {
    use waddling_errors_macros::sequence;

    sequence! {
        MISSING(1) {
            description: "Missing parameter",
            typical_severity: "Error",
        },
        INVALID(3) {
            description: "Invalid parameter",
            typical_severity: "Error",
        },
        EXPIRED(17) {
            description: "Expired resource",
            typical_severity: "Error",
        },
    }
}

// Test sequence value validation
mod test_sequence_value_1 {
    use super::*;

    diag! {
        strict(sequence_values),

        E.Auth.Token.MISSING: {
            message: "Validates that MISSING is a u16",
            hints: ["Type checking ensures it's a valid sequence constant"],
        },
    }
}

mod test_sequence_value_2 {
    use super::*;

    diag! {
        strict(sequence_values),

        E.Auth.Token.EXPIRED: {
            message: "Validates that EXPIRED is a u16",
            hints: ["The numeric value (17) is enforced by sequence! macro"],
        },
    }
}

// Test combined with other validations
mod test_combined_validation {
    use super::*;

    diag! {
        strict(sequence, sequence_values),

        E.Auth.Token.INVALID: {
            message: "Validates both existence and type",
            hints: ["Ensures INVALID exists AND is a u16"],
        },
    }
}

// Test all validations together
mod test_all_validations {
    use super::*;

    diag! {
        strict(sequence, primary, component, naming, duplicates, sequence_values, string_values),

        E.Auth.Token.MISSING: {
            message: "Maximum validation: everything checked",
            hints: ["All validation modes enabled"],
        },
    }
}

fn main() {
    println!("✅ Sequence value validation passed!");
    println!("All sequences are valid u16 constants.");
}