myriad-rs 0.2.0

VM runtime for Polka bytecode, computation core.
Documentation
use crate::memory::Heap;
use alloc::{string::{String, ToString}, vec::Vec};

pub struct RegionTable {
    stack: Vec<Vec<(u32, u32)>>,
}

impl RegionTable {
    pub fn new() -> Self {
        Self { stack: Vec::new() }
    }

    pub fn push(&mut self) {
        self.stack.push(Vec::new());
    }

    #[inline]
    pub fn is_active(&self) -> bool { !self.stack.is_empty() }

    #[inline]
    pub fn record_alloc(&mut self, slot: u32, generation: u32) {
        if let Some(top) = self.stack.last_mut() {
            top.push((slot, generation));
        }
    }

    pub fn depth(&self) -> usize {
        self.stack.len()
    }

    pub fn pop_and_release(&mut self, heap: &mut Heap) -> Result<(), String> {
        let allocs = self.stack.pop()
            .ok_or_else(|| "region_pop: no active region".to_string())?;
        for (slot, generation) in allocs {
            if let Err(e) = heap.force_free(slot, generation) {
                debug_assert!(false, "region pop force_free failed: {}", e);
            }
        }
        Ok(())
    }

    pub fn clear(&mut self) {
        self.stack.clear();
    }

    pub fn deep_forget(&mut self, heap: &Heap, slot: u32, generation: u32) {
        let mut visited = alloc::collections::BTreeSet::new();
        self.deep_forget_inner(heap, slot, generation, &mut visited);
    }

    fn deep_forget_inner(&mut self, heap: &Heap, slot: u32, generation: u32,
                         visited: &mut alloc::collections::BTreeSet<(u32, u32)>) {
        if !visited.insert((slot, generation)) { return; }
        if !self.forget(slot, generation) { return; }
        let size = match heap.size(slot, generation) { Ok(n) => n, Err(_) => return };
        for off in 0..size {
            if let Ok((raw, is_handle)) = heap.ld(slot, generation, off) {
                if is_handle && raw != polka::HANDLE_NONE {
                    let (s, g) = polka::Value::from_raw(raw).as_handle();
                    self.deep_forget_inner(heap, s, g, visited);
                }
            }
        }
    }

    pub fn forget(&mut self, slot: u32, generation: u32) -> bool {
        // record_alloc only ever pushes to the top region, so a live cell can
        // appear in at most that one. Scan top only.
        let Some(top) = self.stack.last_mut() else { return false; };
        let before = top.len();
        top.retain(|(s, g)| !(*s == slot && *g == generation));
        top.len() < before
    }
}