@theoparis/wasmoon v0.0.3

Wasmoon

This package aims to provide a way to:

• Embed Lua to any Node.js, Deno or Web Application.
• Run lua code in any operational system
• Interop Lua and JS without memory leaks (including the DOM)

API Usage

To initialize, create a new Lua state, register the standard library, set a global variable, execute a code and get a global variable:

import { LuaFactory } from "@theoparis/wasmoon"

// Initialize a new lua environment factory
// You can pass the wasm location as the first argument, useful if you are using wasmoon on a web environment and want to host the file by yourself
const factory = new LuaFactory()
// Create a standalone lua environment from the factory
const lua = await factory.createEngine()

try {
  // Set a JS function to be a global lua function
  lua.global.set('sum', (x, y) => x + y)
  // Run a lua string
  await lua.doString(`
    print(sum(10, 10))
    function multiply(x, y)
        return x * y
    end
  `)
  // Get a global lua function as a JS function
  const multiply = lua.global.get('multiply')
  console.log(multiply(10, 10))
} finally {
  // Close the lua environment, so it can be freed
  lua.global.close()
}

CLI Usage

Although Wasmoon has been designed to be embedded, you can run it on command line as well, but, if you want something more robust on this, we recommend to take a look at demoon.

$: wasmoon [options] [file] [args]

Available options are:

• -l: Include a file or directory
• -i: Enter interactive mode after running the files

Example

$: wasmoon -i sum.lua 10 30

And if you are in Unix, you can also use it as a script interpreter with Shebang:

#!/usr/bin/env wasmoon
return arg[1] + arg[2]

$: ./sum.lua 10 30

When to use wasmoon and fengari

Wasmoon compiles the official Lua code to webassembly and creates an abstraction layer to interop between Lua and JS, instead of fengari, that is an entire Lua VM rewritten in JS.

Performance

Because of wasm, wasmoon will run Lua code much faster than fengari, but if you are going to interop a lot between JS and Lua, this may be not be true anymore, you probably should test on you specific use case to take the prove.

This is the results running a heap sort code in a list of 20k numbers 10x:

Size

Fengari is lighter than wasmoon, which can improve the user experience if in web environments:

Contributing

You can submit bugs here, and you can create patches by following the git send-email guide.