Examples of WasmEdge Rust SDK

All examples have been verified on Ubuntu-20.04/22.04.

• Examples of WasmEdge Rust SDK
  • Wasm App
    • Example: Run a wasm app from host
  • Wasm Library
    • Example: Define a wasm library
    • Example: Use extern functions in a wasm library
    • Example: Dependencies between wasm libraries
  • Host Functions
    • Example: Define a host function
    • Example: Define a host function with host context data
    • Example: Arguments of non-standard wasm types in wasm function (wasmedge-bindgen)
  • Memory and Table
    • Example: Manipulate WebAssembly linear memory
  • AOT
    • Example: Call wasm library in AOT mode
  • WASI
    • Example: Set environment variables and arguments via WasmEdge wasi interface
    • Example: Set environment variables, arguments and preopen-dirs via async-wasi interface
    • Example: Retrieve the socket address via async-wasi interface
  • WASI-NN
    • Example: AI inference over WasmEdge PyTorch Plugin
    • Example: Chat with Llama2
  • Plugin Development
    • Example: Create a simple plugin
    • Example: Run a plugin with Executor
  • Multi-threading
    • Example: Multi-threaded parallel execution with memory sharing
  • Async\await
    • Example: Define async host functions
    • Example: Define async host functions with host context data
    • Example: Call a wasm function in asynchromous way

Wasm App

Example: Run a wasm app from host

This example demonstrates how to create a WebAssembly application and run it as a wasm module over WasmEdge Runtime.

Wasm Library

Example: Define a wasm library

This example demonstrates how to define a wasm library and call the APIs exported from the wasm library in WasmEdge Runtime.

Example: Use extern functions in a wasm library

This example demonstrates how to use external functions in a wasm library, and how to call such a wasm library with WasmEdge Rust SDK.

Example: Dependencies between wasm libraries

This example demonstrates how a wasm function defined in one wasm library can be imported and called by another wasm library.

Host Functions

Example: Define a host function

This example demonstrates how to define a native function as a host function with #[host_function] macro, and register it into a WasmEdge Vm and run it over WasmEdge Runtime.

Example: Define a host function with host context data

This example demonstrates how to define a native function as a host function with #[host_function] macro. A host context data is used in the host function.

Example: Define a host function with string arguments

This example demonstrates how to define a host function that takes two arguments of Rust built-in String or string slice type.

Example: Arguments of non-standard wasm types in wasm function (wasmedge-bindgen)

This example demonstrates how to define wasm functions, of which the arguments are of Rust built-in types instead of WebAssembly types.

Memory and Table

Example: Manipulate WebAssembly linear memory

This example demonstrates how to manipulate linear memory.

Example: Use WebAssembly Table and FuncRef to invoke host functions

This example demonstrates how to use WebAssembly Table and FuncRef together to invoke host functions.

AOT

Example: Call wasm library in AOT mode

This example demonstrates how to generate a AOT file with WasmEdge AOT compiler, and then load the file and run the wasm function in AOT mode.

WASI

Example: Set environment variables and arguments via WasmEdge wasi interface

This example demonstrates how to set environment variables and arguments via WasmEdge wasi interface.

Example: Set environment variables, arguments and preopen-dirs via async-wasi interface

This example demonstrates how to call a wasm function in asynchronous way. Also, it presents the usage of async-wasi interface.

Example: Retrieve the socket address via async-wasi interface

This example presents how to retrieve the socket address information asynchronously.

WASI-NN

Example: AI inference over WasmEdge PyTorch Plugin

This example demonstrates how to perform an object detection task over WasmEdge Runtime.

Example: Chat with Llama2

This example demonstrates how to chat with Llama2 model driven by WasmEdge wasi-nn-ggml backend.

Plugin Development

Example: Create a simple plugin

This example demonstrates how to create a simple plugin with WasmEdge Rust SDK.

Example: Run a plugin with Executor

This example demonstrates how to create a simple plugin with WasmEdge Rust SDK, and run it with WasmEdge Executor.

Multi-threading

Example: Multi-threaded parallel execution with memory sharing

This example demonstrates how to use WasmEdge Rust SDK to create multiple threads to help us render Mandelbrot set in parallel, which is a compute-intensive workload. This example also present sharing the image memory between threads while rendering the image parallelly.

Async\await

Example: Define async host functions

This example demonstrates how to define a native async function as an async host function with #[async_host_function] macro, and register it into a WasmEdge Vm and run it over WasmEdge Runtime.

Example: Define async host functions with host context data

This example demonstrates how to define a native async function as an async host function with #[async_host_function] macro. A host context data is used in the host function.

Example: Call a wasm function in asynchromous way

This example demonstrates how to call a wasm function in asynchronous way.