13 releases
0.1.13 | Jun 10, 2021 |
---|---|
0.1.12 | Jun 9, 2021 |
#844 in WebAssembly
30 downloads per month
13KB
249 lines
wasmir
A library for embedding high-performance WASM code directly in a Rust program. This package was created for people who absolutely hate writing Javascript. The goal of this library is to reduce the amount of overhead required to implement WASM by automatically compiling WASM modules and statically linking them to your binary. You will need to have wasm-bindgen installed. If your project stops building, please submit an issue.
Usage
Add wasmir as a dependency to your Cargo.toml:
wasmir = "0.1.13"
Code must be declared inside a module. The typical usage is as follows:
use wasmir::wasmir;
#[wasmir]
mod my_module {
use wasm_bindgen::prelude::*;
#[wasm_bindgen]
extern "C" {
pub fn alert(s: &str);
}
#[wasm_bindgen]
pub fn greet(name: &str) {
unsafe {
alert(&format!("Hello, {}!", name));
}
}
}
Once the proc_macro does its work, the above module will then contain two binary blob constants,
wasm
and loader
. Serve loader from "my_module.js" and wasm from "my_module_bg.wasm"
Then, in index.js, include the following code:
import init from './my_module_bg.js';
import {greet} from './my_module_bg.js';
function run() {
greet(\"World\");
}
init().then(run)
You can also specify WASM-dependencies like so:
#[wasmir(
[dependencies]
wasm-bindgen = "*"
[dependencies.web-sys]
version = "*"
features = ["Document", "Node", "Element"]
)]
Dependencies
~2.5MB
~54K SLoC