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
121
122
123
124
125
126
127
128
129

//! Test: String value validation passes with valid string constants and enum variants
//!
//! This test verifies that diag! with strict(string_values) validation
//! accepts primaries that are &str constants and components that are enum variants.

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",
            },
            Database {
                docs: "Database component",
            },
        }
    }

    pub use Component::*;
}

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

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

// Define valid sequences
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",
        },
    }
}

// Test string value validation
mod test_string_value_1 {
    use super::*;

    diag! {
        strict(string_values),

        E.Auth.Token.MISSING: {
            message: "Validates that Token is a &str constant",
            hints: ["Type checking ensures primary is a valid string constant"],
        },
    }
}

mod test_string_value_2 {
    use super::*;

    diag! {
        strict(string_values),

        E.Database.Connection.INVALID: {
            message: "Validates that Database component exists as enum variant",
            hints: ["Type checking ensures component is a valid enum variant"],
        },
    }
}

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

    diag! {
        strict(primary, component, string_values),

        E.Auth.Token.INVALID: {
            message: "Validates both existence and types",
            hints: ["Ensures Token exists as &str AND Auth exists as enum variant"],
        },
    }
}

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

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

        E.Database.Connection.MISSING: {
            message: "Maximum validation: everything checked",
            hints: [
                "Validates naming conventions",
                "Checks for duplicates",
                "Verifies existence of all components",
                "Type-checks sequence values (u16)",
                "Type-checks string values (&str and enum)",
            ],
        },
    }
}

fn main() {
    println!("✅ String value validation passed!");
    println!("All primaries are valid &str constants.");
    println!("All components are valid enum variants.");
}