Skip to main content

module_resolver/
module_resolver.rs

1//! Host module resolution and a read-only in-memory filesystem sandbox.
2use moonseed::*;
3mod support;
4use support::*;
5struct Modules;
6impl ModuleResolver for Modules {
7    fn resolve(&self, name: &[u8]) -> Resolved {
8        match name {
9            b"game.foo" => Resolved::Source(b"return {answer = 42}".to_vec()),
10            _ => Resolved::NotFound(b"module not provided by host".to_vec()),
11        }
12    }
13}
14fn main() -> ExampleResult {
15    let mut rt = Runtime::builder()
16        .libraries(Libraries::BASE | Libraries::PACKAGE)
17        .module_resolver(ResolverPolicy::Pure, Modules)
18        .build()?;
19    assert_eq!(
20        eval::<i64>(&mut rt, b"return require('game.foo').answer")?,
21        42
22    );
23    let capabilities = memory_filesystem(
24        [(b"answer.lua".to_vec(), b"return 42".to_vec())],
25        MemoryOptions {
26            read_only: true,
27            ..MemoryOptions::default()
28        },
29    )
30    .map_err(|error| format!("VFS: {error:?}"))?;
31    let mut sandbox = Runtime::builder()
32        .libraries(Libraries::BASE | Libraries::PACKAGE | Libraries::IO | Libraries::OS)
33        .capabilities(capabilities)
34        .package_paths(b"?.lua", b"")
35        .build()?;
36    // No process/environment/stdio authority was supplied. Writes are denied.
37    let (answer, denied, environment): (i64, bool, Value) = eval(
38        &mut sandbox,
39        br#"
40        local file = io.open('new.lua', 'w')
41        return require('answer'), file == nil, os.getenv('MOONSEED_EXAMPLE')
42    "#,
43    )?;
44    assert_eq!(answer, 42);
45    assert!(denied);
46    assert!(matches!(environment, Value::Nil));
47    Ok(())
48}
49
50#[cfg(test)]
51#[test]
52fn example_runs_and_asserts_its_result() {
53    main().unwrap();
54}