stateforward-sml-macros 1.2.0

Procedural macros for the sml.rs transition-table DSL
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

use crate::parser::lifetimes::Lifetimes;
use std::collections::HashMap;
use syn::{parse, spanned::Spanned, Type};

pub type DataTypes = HashMap<String, Type>;

#[derive(Debug)]
pub struct DataDefinitions {
    pub data_types: DataTypes,
    pub all_lifetimes: Lifetimes,
    pub lifetimes: HashMap<String, Lifetimes>,
}

impl DataDefinitions {
    pub fn new() -> Self {
        Self {
            data_types: DataTypes::new(),
            all_lifetimes: Lifetimes::new(),
            lifetimes: HashMap::new(),
        }
    }

    // helper function for adding a new data type to a data descriptions struct
    fn add(&mut self, key: String, data_type: Type) -> Result<(), parse::Error> {
        // retrieve any lifetimes used in this data-type
        let lifetimes = Lifetimes::from_type(&data_type)?;

        // add the data to the collection
        self.data_types.insert(key.clone(), data_type);

        // if any new lifetimes were used in the type definition, we add those as well
        if !lifetimes.is_empty() {
            self.all_lifetimes.extend(&lifetimes);
            self.lifetimes.insert(key, lifetimes);
        }
        Ok(())
    }

    // helper function for collecting data types and adding them to a data descriptions struct
    pub fn collect(&mut self, key: String, data_type: Option<Type>) -> Result<(), parse::Error> {
        // check to see if there was every a previous data-type associated with this transition
        let prev = self.data_types.get(&key);

        // if there was a previous data definition for this key, may sure it is consistent
        if let Some(prev) = prev {
            if let Some(ref data_type) = data_type {
                if prev != &data_type.clone() {
                    return Err(parse::Error::new(
                        data_type.span(),
                        format!(
                            "This event's type {} does not match its previous definition",
                            key
                        ),
                    ));
                }
            } else {
                return Err(parse::Error::new(
                    data_type.span(),
                    format!(
                        "This event's type {} does not match its previous definition",
                        key
                    ),
                ));
            }
        }

        if let Some(data_type) = data_type {
            self.add(key, data_type)?;
        }
        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    fn ty(source: &str) -> Type {
        syn::parse_str(source).unwrap()
    }

    #[test]
    fn collects_consistent_types_and_lifetimes() {
        let mut definitions = DataDefinitions::new();
        definitions
            .collect("event".to_owned(), Some(ty("&'a str")))
            .unwrap();
        definitions
            .collect("event".to_owned(), Some(ty("&'a str")))
            .unwrap();
        assert_eq!(definitions.data_types.len(), 1);
        assert_eq!(definitions.all_lifetimes.as_slice().len(), 1);
        assert_eq!(definitions.lifetimes["event"].as_slice().len(), 1);
    }

    #[test]
    fn rejects_conflicting_or_missing_redefinitions() {
        let mut definitions = DataDefinitions::new();
        definitions
            .collect("event".to_owned(), Some(ty("u8")))
            .unwrap();
        assert!(definitions
            .collect("event".to_owned(), Some(ty("u16")))
            .is_err());
        assert!(definitions.collect("event".to_owned(), None).is_err());
    }

    #[test]
    fn ignores_absent_first_definition() {
        let mut definitions = DataDefinitions::new();
        definitions.collect("event".to_owned(), None).unwrap();
        assert!(definitions.data_types.is_empty());
    }
}