Wasmtime's wasi-runtime-config Implementation

This crate provides a Wasmtime host implementation of the wasi-runtime-config API. With this crate, the runtime can run components that call APIs in wasi-runtime-config and provide configuration variables for the component.

Examples

The usage of this crate is very similar to other WASI API implementations such as wasi:cli and wasi:http.

A common scenario is getting runtime-passed configurations in a wasi:cli component. A standalone example of doing all this looks like:

use wasmtime::{
    component::{Linker, ResourceTable},
    Config, Engine, Result, Store,
};
use wasmtime_wasi::{WasiCtx, WasiCtxBuilder, WasiView};
use wasmtime_wasi_runtime_config::{WasiRuntimeConfig, WasiRuntimeConfigVariables};

#[tokio::main]
async fn main() -> Result<()> {
    let mut config = Config::new();
    config.async_support(true);
    let engine = Engine::new(&config)?;

    let mut store = Store::new(&engine, Ctx {
        table: ResourceTable::new(),
        wasi_ctx: WasiCtxBuilder::new().build(),
        wasi_runtime_config_vars: WasiRuntimeConfigVariables::from_iter(vec![
            ("config_key1", "value1"),
            ("config_key2", "value2"),
        ]),
    });

    let mut linker = Linker::<Ctx>::new(&engine);
    wasmtime_wasi::add_to_linker_async(&mut linker)?;
    // add `wasi-runtime-config` world's interfaces to the linker
    wasmtime_wasi_runtime_config::add_to_linker(&mut linker, |h: &mut Ctx| {
        WasiRuntimeConfig::from(&h.wasi_runtime_config_vars)
    })?;

    // ... use `linker` to instantiate within `store` ...

    Ok(())
}

struct Ctx {
    table: ResourceTable,
    wasi_ctx: WasiCtx,
    wasi_runtime_config_vars: WasiRuntimeConfigVariables,
}

impl WasiView for Ctx {
    fn table(&mut self) -> &mut ResourceTable { &mut self.table }
    fn ctx(&mut self) -> &mut WasiCtx { &mut self.wasi_ctx }
}