Support for the axum web server framework in wasi-http components, via wstd.

This crate is a pretty thin wrapper on wstd that allows users to use the axum crate on top of wstd's http support. This means that axum services can run anywhere the wasi-http proxy world is supported, e.g. in wasmtime serve.

Users of this crate should depend on axum with default-features = false, and opt in to any features that they require (e.g. form, json, matched-path, original-uri, query, tower-log, tracing). The axum crate features that require hyper or tokio are NOT supported (e.g. http1, http2, ws), because unlike in native applications, wasi-http components have an http implementation provided as imported interfaces (i.e. implemented the Wasm host), and do not use raw sockets inside of this program.

Examples

The simplest use is via the wstd_axum::http_server proc macro. This macro can be applied to a sync or async fn main which returns an impl of the tower_service::Service trait, typically an axum::Router:

If users desire, they can instead use a wstd::http_server entry point and then use wstd_axum::serve directly. The following is equivelant to the above example: