Skip to content

CLI tools

surreal mod

mod is the launcher component for WebAssembly module tooling: scaffolding, building, inspecting and running Surrealism modules. It is installed and versioned separately from the database, like every other component.

Usage
surreal mod <COMMAND>
Note

The first release of the mod component is not published yet, so surreal install mod does not succeed. Until it is, the commands are available as surreal db module, from the database component. The top-level form surreal module is deprecated in favour of surreal mod and prints a warning.

CommandPurpose
surreal db module init [PATH]Scaffold a new Surrealism module project.
surreal db module build [SOURCE_PATH]Build a WASM module.
surreal db module run <FILE> --fnc <NAME>Run a function with arguments.
surreal db module sig <FILE> --fnc <NAME>Show a function's signature.
surreal db module info <FILE>Show the module's information.

Flags and examples are on the surreal db module page. For a walkthrough, see Working with modules.

Was this page helpful?