spacewasm 0.4.1

A no_std WebAssembly 1.0 decoder, validator, and interpreter for on-board spacecraft use
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

use core::ops::Deref;

use crate::util::InnerVec;

pub struct Chunk(InnerVec<u8>);

impl From<InnerVec<u8>> for Chunk {
    fn from(value: InnerVec<u8>) -> Self {
        Chunk(value)
    }
}

impl Chunk {
    pub(crate) fn return_(&mut self, stream: &mut dyn WasmStream) {
        let to_drop = core::mem::replace(&mut self.0, InnerVec::zero());
        stream.return_(to_drop)
    }
}

impl Drop for Chunk {
    fn drop(&mut self) {
        assert_eq!(self.0.capacity, 0);
    }
}

impl Deref for Chunk {
    type Target = [u8];
    fn deref(&self) -> &[u8] {
        &self.0
    }
}

pub trait WasmStream {
    /// Read the next chunk of data from the data 'feeder'
    /// Returns Ok(None) when we are finished reading
    /// Returns Err(code) to indicate an error code while reading this chunk
    fn read(&mut self) -> Result<Option<InnerVec<u8>>, u8>;

    /// Returns a buffer back to the stream so that the memory may be reused.
    fn return_(&mut self, chunk: InnerVec<u8>);
}