WASM API

The KCL core is written by Rust and can be compiled to the wasm-wasi target using toolchains such as cargo. With the help of WASM, we can also easily achieve multilingual and browser integration. Here is how we can use the KCL WASM module in Node.js, Go and Rust.

Quick Start

We can find and download KCL WASM module from here

Node.js

Install the dependency

npm install @kcl-lang/wasm-lib

Write the code

import { load, invokeKCLRun } from "@kcl-lang/wasm-lib";

async function main() {
  const inst = await load();
  const result = invokeKCLRun(inst, {
    filename: "test.k",
    source: `
schema Person:
  name: str

p = Person {name = "Alice"}`,
  });
  console.log(result);
}

main();

The output is

p:
  name: Alice

Rust

In Rust, we use wasmtime as an example, and of course, you can also use other runtime that supports WASI to accomplish this.

Install the dependency

cargo add kcl-wasm-lib --git https://github.com/kcl-lang/lib
cargo add anyhow

Write the code

use anyhow::Result;
use kcl_wasm_lib::{KCLModule, RunOptions};

fn main() -> Result<()> {
    let opts = RunOptions {
        filename: "test.k".to_string(),
        source: "a = 1".to_string(),
    };
    // Note replace your KCL wasm module path.
    let mut module = KCLModule::from_path("path/to/kcl.wasm")?;
    let result = module.run(&opts)?;
    println!("{}", result);
    Ok(())
}

The output is

a: 1

Go

In Go, we use wasmtime as an example, and of course, you can also use other runtime that supports WASI to accomplish this.

Write the code, and the code of package github.com/kcl-lang/wasm-lib/pkg/module can be found here

package main

import (
    "fmt"

    "github.com/kcl-lang/wasm-lib/pkg/module"
)

func main() {
    m, err := module.New("path/to/kcl.wasm")
    if err != nil {
        panic(err)
    }
    result, err := m.Run(&module.RunOptions{
        Filename: "test.k",
        Source:   "a = 1",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

The output is

a: 1