ruchy 4.2.0

A systems scripting language that transpiles to idiomatic Rust with extreme quality engineering
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
130
131
132
133
134
135
136
137
138
139
140
141
142
143

//! WASM Module Representation
//!
//! Represents a compiled WASM module ready for execution.

/// Represents a compiled WASM module
#[derive(Debug, Clone)]
pub struct WasmModule {
    bytes: Vec<u8>,
}

impl WasmModule {
    /// Create a new WASM module from compiled bytes
    pub fn new(bytes: Vec<u8>) -> Self {
        Self { bytes }
    }

    /// Get the raw WASM bytes
    pub fn bytes(&self) -> &[u8] {
        &self.bytes
    }

    /// Get the size of the module in bytes
    pub fn size(&self) -> usize {
        self.bytes.len()
    }

    /// Check if this is a valid WASM module (has magic number)
    pub fn is_valid(&self) -> bool {
        self.bytes.len() >= 8 && &self.bytes[0..4] == b"\0asm"
    }

    /// Get the WASM version (should be 1 for current spec)
    pub fn version(&self) -> Option<u32> {
        if self.bytes.len() >= 8 {
            Some(u32::from_le_bytes([
                self.bytes[4],
                self.bytes[5],
                self.bytes[6],
                self.bytes[7],
            ]))
        } else {
            None
        }
    }
}

impl Default for WasmModule {
    fn default() -> Self {
        Self::new(Vec::new())
    }
}

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

    #[test]
    fn test_wasm_module_new() {
        let module = WasmModule::new(vec![0, 1, 2, 3]);
        assert_eq!(module.bytes(), &[0, 1, 2, 3]);
    }

    #[test]
    fn test_wasm_module_size() {
        let module = WasmModule::new(vec![0; 100]);
        assert_eq!(module.size(), 100);
    }

    #[test]
    fn test_wasm_module_default() {
        let module = WasmModule::default();
        assert!(module.bytes().is_empty());
        assert_eq!(module.size(), 0);
    }

    #[test]
    fn test_wasm_module_is_valid() {
        // Valid WASM header
        let valid = WasmModule::new(vec![0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]);
        assert!(valid.is_valid());

        // Invalid - too short
        let invalid_short = WasmModule::new(vec![0x00, 0x61]);
        assert!(!invalid_short.is_valid());

        // Invalid - wrong magic
        let invalid_magic = WasmModule::new(vec![0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00]);
        assert!(!invalid_magic.is_valid());
    }

    #[test]
    fn test_wasm_module_version() {
        let module = WasmModule::new(vec![0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]);
        assert_eq!(module.version(), Some(1));

        let empty = WasmModule::new(vec![]);
        assert_eq!(empty.version(), None);
    }

    #[test]
    fn test_wasm_module_clone() {
        let module = WasmModule::new(vec![1, 2, 3]);
        let cloned = module.clone();
        assert_eq!(module.bytes(), cloned.bytes());
    }

    #[test]
    fn test_wasm_module_debug() {
        let module = WasmModule::new(vec![1, 2, 3]);
        let debug = format!("{:?}", module);
        assert!(debug.contains("WasmModule"));
    }

    // Property tests
    #[cfg(test)]
    mod property_tests {
        use super::*;
        use proptest::prelude::*;

        proptest! {
            #![proptest_config(ProptestConfig::with_cases(100))]

            #[test]
            fn prop_size_equals_bytes_len(data in prop::collection::vec(any::<u8>(), 0..100)) {
                let module = WasmModule::new(data.clone());
                prop_assert_eq!(module.size(), data.len());
            }

            #[test]
            fn prop_bytes_roundtrip(data in prop::collection::vec(any::<u8>(), 0..100)) {
                let module = WasmModule::new(data.clone());
                prop_assert_eq!(module.bytes(), data.as_slice());
            }

            #[test]
            fn prop_valid_wasm_header(_dummy: u8) {
                let valid = WasmModule::new(vec![0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]);
                prop_assert!(valid.is_valid());
                prop_assert_eq!(valid.version(), Some(1));
            }
        }
    }
}