#wasm-component #component #codec #component-model

wac-graph

A library for defining, encoding, and decoding WebAssembly composition graphs

7 releases (breaking)

0.6.0 Sep 5, 2024
0.5.0 Jul 22, 2024
0.4.0 Jul 9, 2024
0.3.0 May 20, 2024
0.0.0 Apr 16, 2024

#1418 in WebAssembly

Download history 98/week @ 2024-06-10 79/week @ 2024-06-17 138/week @ 2024-06-24 58/week @ 2024-07-01 240/week @ 2024-07-08 144/week @ 2024-07-15 482/week @ 2024-07-22 127/week @ 2024-07-29 76/week @ 2024-08-05 52/week @ 2024-08-12 204/week @ 2024-08-19 792/week @ 2024-08-26 975/week @ 2024-09-02 807/week @ 2024-09-09 1123/week @ 2024-09-16 912/week @ 2024-09-23

3,849 downloads per month
Used in 4 crates

Apache-2.0 WITH LLVM-exception

245KB
5K SLoC

A library for defining, encoding, and decoding WebAssembly composition graphs.

An example of composing two components together using a CompositionGraph:

use wac_graph::{CompositionGraph, EncodeOptions, types::Package};

let mut graph = CompositionGraph::new();

// Register the packages with the graph
// It is assumed that `my:package1` exports a function named `a`,
// while `my:package2` imports a function named `b`.
let pkg = Package::from_file("my:package1", None, "package1.wasm", graph.types_mut())?;
let package1 = graph.register_package(pkg)?;
let pkg = Package::from_file("my:package2", None, "package2.wasm", graph.types_mut())?;
let package2 = graph.register_package(pkg)?;

// Instantiate package `my:package1`
let instantiation1 = graph.instantiate(package1);

// Alias the `a` export of the `my:package1` instance
let a = graph.alias_instance_export(instantiation1, "a")?;

// Instantiate package `my:package2`
let instantiation2 = graph.instantiate(package2);

// Set argument `b` of the instantiation of `my:package2` to `a`
graph.set_instantiation_argument(instantiation2, "b", a)?;

// Finally, encode the graph into a new component
let bytes = graph.encode(EncodeOptions::default())?;

Dependencies

~7MB
~117K SLoC