lu 0.5.1

A library for embedding Luau
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

use std::ffi::c_char;
use std::ptr::null;

#[derive(Default, Clone, Copy)]
pub enum OptimizationLevel {
    None,
    Some,
    #[default]
    Full,
}

impl From<OptimizationLevel> for i32 {
    fn from(level: OptimizationLevel) -> Self {
        match level {
            OptimizationLevel::None => 0,
            OptimizationLevel::Some => 1,
            OptimizationLevel::Full => 2,
        }
    }
}

#[derive(Default, Clone, Copy)]
pub enum DebugInfoLevel {
    None,
    #[default]
    Some,
    Full,
}

impl From<DebugInfoLevel> for i32 {
    fn from(level: DebugInfoLevel) -> Self {
        match level {
            DebugInfoLevel::None => 0,
            DebugInfoLevel::Some => 1,
            DebugInfoLevel::Full => 2,
        }
    }
}

#[derive(Default)]
pub struct Compiler {
    optimization_level: OptimizationLevel,
    debug_level: DebugInfoLevel,
}

impl Compiler {
    pub fn with_optimization_level(mut self, level: OptimizationLevel) -> Self {
        self.optimization_level = level;
        self
    }

    pub fn with_debug_level(mut self, level: DebugInfoLevel) -> Self {
        self.debug_level = level;
        self
    }

    pub fn compile(&self, source: &[u8]) -> CompileResult {
        let mut options = sys::lua_CompileOptions {
            optimizationLevel: self.optimization_level.into(),
            debugLevel: self.debug_level.into(),
            typeInfoLevel: 0,
            coverageLevel: 0,
            vectorLib: null(),
            vectorCtor: null(),
            vectorType: null(),
            mutableGlobals: null(),
            userdataTypes: null(),
            librariesWithKnownMembers: null(),
            libraryMemberTypeCb: None,
            libraryMemberConstantCb: None,
            disabledBuiltins: null(),
        };

        let mut len = 0;
        let ptr = unsafe {
            sys::luau_compile(source.as_ptr().cast(), source.len(), &mut options, &mut len)
        };

        CompileResult { ptr, len }
    }
}

pub struct CompileResult {
    ptr: *mut c_char,
    len: usize,
}

impl Drop for CompileResult {
    fn drop(&mut self) {
        unsafe { libc::free(self.ptr.cast()) }
    }
}

impl CompileResult {
    pub fn bytecode(&self) -> Bytecode {
        Bytecode(unsafe { std::slice::from_raw_parts(self.ptr.cast(), self.len) })
    }
}

pub struct Bytecode<'a>(&'a [u8]);

impl Bytecode<'_> {
    pub fn ptr(&self) -> *const c_char {
        self.0.as_ptr().cast()
    }

    #[allow(clippy::len_without_is_empty)]
    pub fn len(&self) -> usize {
        self.0.len()
    }

    pub fn result(&self) -> Result<(), &str> {
        if self.0.first().copied().unwrap() == 0 {
            Err(unsafe { std::str::from_utf8_unchecked(&self.0[1..]) })
        } else {
            Ok(())
        }
    }
}