https://github.com/yoshuawuyts/rust-wasi-hello

"hello world" using Rust and Wasm Components
https://github.com/yoshuawuyts/rust-wasi-hello

components demo example rust template wasi wasm

Last synced: 18 days ago
JSON representation

"hello world" using Rust and Wasm Components

• Host: GitHub
• URL: https://github.com/yoshuawuyts/rust-wasi-hello
• Owner: yoshuawuyts
• Created: 2024-09-05T16:20:56.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-10-21T15:02:00.000Z (26 days ago)
• Last Synced: 2024-10-22T01:15:49.334Z (26 days ago)
• Topics: components, demo, example, rust, template, wasi, wasm
• Language: Rust
• Homepage:
• Size: 104 KB
• Stars: 5
• Watchers: 1
• Forks: 1
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Rust WASI Hello

[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/yoshuawuyts/rust-wasi-hello)

An example project showing how to build an HTTP server for WASI 0.2 built in

Rust.

## Installation

The easiest way to try this project is by opening it in a GitHub Codespace. This

will create a VS Code instance with all dependencies installed. If instead you

would prefer to run this locally, you can run the following commands:

```bash

$ curl https://wasmtime.dev/install.sh -sSf | bash # install wasm runtime

$ cargo install cargo-component                    # install build tooling

$ cargo install wkg                                # install wasm OCI tooling

```

## Local Development

The HTTP server uses the `wasi:http/proxy` world. You can run it locally in a

`wasmtime` instance by using the following [cargo-component] command:

```rust

$ cargo component serve

```

## Working with deployment artifacts

This project automatically published compiled Wasm Components as OCI to GitHub

Artifacts. You can pull the artifact with any OCI-compliant tooling and run it

in any Wasm runtime that supports the `wasi:http/proxy` world. To fetch the

latest published version from GitHub releases and run it in a local `wasmtime`

instance you can run the following command:

```bash

$ wkg pull ghcr.io/yoshuawuyts/rust-wasi-hello:latest

$ wasmtime serve rust-wasi-hello.wasm

```

For production workloads however, you may want to use other runtimes or

integrations which provide their own OCI integrations. Deployment will vary

depending on you providers, though at their core they will tend to be variations

on the pull + serve pattern we've shown here.

## Roadmap

- [x] Get a base version compiling

- [x] Create a GitHub Actions Workflow

- [x] Add routes to the HTTP handler

- [ ] Create a wasm OCI publish action

- [ ] Setup a GitHub Codespace with all tools pre-installed

- [ ] Demo unit tests in CI

- [ ] Automatically publish a package on GitHub Release

- [ ] Add a load-testing example

- [ ] Upstream and integrate `scripts/` into their respective packages

- [ ] Add deploy remote artifact

- [ ] Show wkg pull and run locally

## License

MIT OR Apache-2.0

[cargo-component]: https://github.com/bytecodealliance/cargo-component