wasm-link 0.4.0

A WebAssembly plugin runtime based around Wasmtime intended for building fully modular applications
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

use std::collections::HashMap ;

use wasm_link::{ Binding, Engine, Linker, PluginInstanceAsync, PluginInstanceSync };
use wasm_link::cardinality::ExactlyOne ;

use crate::fixture_linking::TestContext ;

fixtures! {
	bindings = { root: "root" };
	plugins  = { plugin: "plugin" };
}

#[test]
fn debug_output_exposes_configuration_without_component_internals() -> Result<(), wasmtime::Error> {
	let engine = Engine::default();
	let linker = Linker::new( &engine );
	let plugins = fixtures::plugins( &engine );
	let bindings = fixtures::bindings();
	let plugin_debug = format!( "{:?}", plugins.plugin.plugin );
	assert!( plugin_debug.contains( "component: \"<Component>\"" ));
	assert!( plugin_debug.contains( "fuel_limiter: None" ));

	let plugin_instance = plugins.plugin.plugin.instantiate( &engine, &linker )?;
	let instance_debug = format!( "{plugin_instance:?}" );
	assert!( instance_debug.contains( "data: TestContext" ));
	assert!( instance_debug.contains( "fuel_limiter: None" ));
	let binding: Binding<
		String,
		TestContext,
		ExactlyOne<String, PluginInstanceSync<TestContext>>,
	> = Binding::new(
		bindings.root.package,
		HashMap::from([( bindings.root.name, bindings.root.spec )]),
		ExactlyOne( "plugin".to_string(), plugin_instance ),
	);
	let binding_debug = format!( "{binding:?}" );
	assert!( binding_debug.contains( "package_name: \"test:primitive\"" ));
	assert!( binding_debug.contains( "plugins: ExactlyOne" ));
	Ok(())
}

#[test]
fn async_debug_output_exposes_configuration_without_component_internals() -> Result<(), Box<dyn std::error::Error>> {
	futures::executor::block_on( async {
		let engine = Engine::default();
		let linker = Linker::new( &engine );
		let executor = futures::executor::ThreadPool::new()?;
		let plugins = fixtures::plugins( &engine );
		let bindings = fixtures::bindings();
		let plugin_instance = plugins.plugin.plugin.instantiate_async( &engine, &linker, executor ).await?;
		let instance_debug = format!( "{plugin_instance:?}" );
		assert!( instance_debug.contains( "state: \"<serialized store>\"" ));
		assert!( instance_debug.contains( "executor: \"<executor>\"" ));
		let binding: Binding<
			String,
			TestContext,
			ExactlyOne<String, PluginInstanceAsync<TestContext>>,
			PluginInstanceAsync<TestContext>,
		> = Binding::new(
			bindings.root.package,
			HashMap::from([( bindings.root.name, bindings.root.spec )]),
			ExactlyOne( "plugin".to_string(), plugin_instance ),
		);
		let binding_debug = format!( "{binding:?}" );
		assert!( binding_debug.contains( "package_name: \"test:primitive\"" ));
		assert!( binding_debug.contains( "plugins: ExactlyOne" ));
		Ok(())
	})
}