π¦ ClawHub
surrealism
by @24601
SurrealDB Surrealism WASM extension development. Write Rust functions, compile to WASM, deploy as database modules. Part of the surreal-skills collection.
β‘ When to Use
π‘ Examples
# Create a new Surrealism project
cargo new --lib my_extension
cd my_extensionAdd the WASM target
rustup target add wasm32-unknown-unknownCreate surrealism.toml (required manifest)
cat > surrealism.toml << 'TOML'
[package]
name = "my_extension"
version = "0.1.0"
TOMLWrite your extension (annotate with #[surrealism])
cat > src/lib.rs << 'RUST'
use surrealism::surrealism;#[surrealism]
fn greet(name: String) -> String {
format!("Hello, {}!", name)
}
RUST
Compile to WASM using SurrealDB CLI
surreal module compileRegister in SurrealDB
surreal sql --endpoint http://localhost:8000 --user root --pass root --ns test --db test
-- Grant access to the WASM file
DEFINE BUCKET my_bucket;-- Register the module functions
DEFINE MODULE my_extension FROM 'my_bucket:my_extension.wasm';
-- Use the function in queries
SELECT my_extension::greet('World');
βοΈ Configuration
wasm32-unknown-unknown targetsurreal binary with surreal module subcommand)DEFINE MODULE and DEFINE BUCKETTERMINAL
clawhub install surrealism