as-wasi
v0.6.0
Published
<!--- Badges -->
Downloads
576
Readme
as-wasi
A high-level AssemblyScript layer for the WebAssembly System Interface (WASI). 🧩
WASI is an API providing access to the external world to WebAssembly modules. AssemblyScript exposes the low-level WASI standard set of system calls. as-wasi
builds a higher level API on top of the AssemblyScript WASI interface, at a similar level to the Node API. 🚀
Installation
You can install as-wasi
in your project by running the following:
npm install --save as-wasi
Quick Start
Example usage of the Console
and Environ
classes:
// Import from the installed as-wasi package
import { Console, Environ } from "as-wasi/assembly";
// Create an environ instance
let env = new Environ();
// Get the HOME Environment variable
let home = env.get("HOME")!;
// Log the HOME string to stdout
Console.log(home);
Here are some exported classes that are commonly used:
FileSystem
- Reading and Writing the user's fileystem. 📁Console
- General logging to stdout and stderr. 🖥️Environ
- Accessing environment variables, command flags, etc... 🌐Date
- Getting the current system time. 📅Random
- Accessing random numbers. 🤔Time
- Allow sleeping and waiting for events to occur. ⏰- And More! See the Reference API in the next section for the full API.
Reference API Docs
Reference API documentation can be found in REFERENCE_API_DOCS. Documentation is generated using typedoc.
Projects using as-wasi
- wasmboy - Game Boy / Game Boy Color Emulator Library, 🎮written for WebAssembly using AssemblyScript. 🚀
- wasmerio/io-devices-lib - Library for interacting with the Wasmer Experimental IO Devices API. Uses WASI for outputting graphics in a framebuffer, and handles mouse/keyboard input.
- wasm-by-example - Wasm By Example is a website with a set of hands-on introduction examples and tutorials for WebAssembly (Wasm). Wasm By Example features
as-wasi
by default for the AssemblyScript WASI examples. - wasm-matrix - A Matrix effect in your terminal using AssemblyScript 🚀 and WASI 🧩 . This project is a bit older, and uses an older version of
as-wasi
, but still creates a cool effect!
If your project is using as-wasi, and you would like to be featured here. Please open a pull request against the README with links to your project, and if appropriate, explaining how as-wasi is being used. 😊
Contributing
Contributions are definitely welcome! Feel free to open a PR for small fixes such as typos and things. Larger fixes, or new features should start out as an issue for discussion, in which then a PR should be made. 🥳
This project will also adhere to the AssemblyScript Code of Conduct.
License
MIT. 📝