luna-core 4.0.2

Pure-Rust Lua runtime (interpreter only, zero third-party dependencies). The JIT-equipped variant lives in the `luna-jit` crate.
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

//! PUC bytecode → luna `Proto` translators, one module per dialect.
//!
//! Each dialect module reads its own chunk format into a
//! [`lower::RawProto`] tree; the code is then lowered into luna's ISA by
//! [`classic`] (5.2, 5.3), [`modern`] (5.4, 5.5) or `puc_51` itself, all on
//! the shared machinery in [`lower`]. `lower`'s module docs list what luna's
//! interpreter trusts a translated proto to satisfy.

pub(in crate::vm::dump) mod classic;
mod lower;
pub(in crate::vm::dump) mod modern;
pub(in crate::vm::dump) mod puc_51;
pub(in crate::vm::dump) mod puc_52;
pub(in crate::vm::dump) mod puc_53;
pub(in crate::vm::dump) mod puc_54;
pub(in crate::vm::dump) mod puc_55;

use super::error::Bad;
use crate::runtime::function::Proto;
use crate::runtime::heap::{Gc, Heap};

/// Route a `\x1bLua` chunk to its dialect's undumper by the version byte.
pub(super) fn undump_puc(bytes: &[u8], heap: &mut Heap) -> Result<Gc<Proto>, Bad> {
    match bytes.get(4) {
        Some(0x51) => puc_51::undump(bytes, heap),
        Some(0x52) => puc_52::undump(bytes, heap),
        Some(0x53) => puc_53::undump_puc_53(bytes, heap),
        Some(0x54) => puc_54::undump(bytes, heap),
        Some(0x55) => puc_55::undump_puc_55(bytes, heap),
        Some(_) => Err(Bad::Version),
        None => Err(Bad::Truncated),
    }
}