Today, we are releasing a new tool that will help you use WebAssembly anywhere: WAPM (aka WebAssembly Package Manager).
This release includes:
- A command line application:
wapm, included when you install Wasmer
- A website and package registry: wapm.io
Why: while working on Wasmer, we discovered that the developer ergonomics needed to improve significantly for WebAssembly to be accessible by the general audience. We realized that a Package Manager will help solve common problems like publishing, defining module ABIs, distributing executable binaries and using them.
What: WebAssembly is an abstraction on top of chipset instructions, this enables wasm modules to run very easily on any machine. If we move this abstraction up we can unlock the potential of having universal binaries that can run anywhere, even on platforms/chipsets not supported at the moment of releasing the binary. Integrations like WASI and Emscripten are essential for projects that want to target WebAssembly easily.
We aim to offer a Package Manager to be a companion to WebAssembly, that will ease the use and distribution of WebAssembly modules.
You can see
wapm in action in this video:
Why do we need a Package Manager?
Let’s dig a bit more into why a Package Manager is key for the adoption of WebAssembly on the server-side.
Persona I: common user
First, we have the use case of a developer that wants to use a WebAssembly binary but has no idea how/where to find it: this can be nginx, lua, sqlite or any other wasm binary. For them, this is how the process looked like:
- Let’s do some search and see where can I find a runnable lua.wasm
- Try to run it… what are the commands I can run on this binary?
wasmer run lua.wasm -- -h
Persona II: universal binary publisher
Our second persona is a developer that wants to create a universal binary and distribute it very easily across any machine and operating system. This can be useful for command-line tools, or anything that can be run directly in your shell:
- Generate the WebAsseembly file (with tools like
emcc main.c -s WASM=1 # this emits the main.wasm file
- Where should I publish it? Github? Npm? But it’s only the WebAssembly, no JS associated… let’s do Github!
git push ...
Persona III: universal library publisher
This would be useful, for example, for developers that are creating libraries that could be used across any language (like a lightweight embeddable search engine, a face detection library, an universal GraphQL framework …).
All these use cases pushed us to re-think the current panorama of Package Managers and how we can create one solely focused on WebAssembly that will unite the following principles:
- It should make it easy to publish, download and use WebAssembly modules
- It should enable an easy way to define commands on top of wasm
- It should allow different ABIs: WASI, Emscripten, or even new ones in the future.
Read a in-depth analysis of what’s a WebAssembly ABI here.
We have good news! WAPM is already included when you install wasmer:
curl https://get.wasmer.io -sSfL | sh
You can start using it now. Let’s install cowsay and lolcat to see all the awesomeness of it!
To make easy to adopt wapm, we have already published a lot of awesome packages, so you can start using them!
- cowsay (running using Rust and WASI!): cows say things
- lolcat (WASI as well!): rainbows and unicorns!
- sqlite: database
- php: web programming language
- nginx: http server
- lua: programming language
- wabt: WebAssembly binary toolkit (we can run wasm2wat using the wabt binary tool compiled to wasm 🤯)
Publish your own WebAssembly modules
We are very, very excited of what you will build with this.
Register now in WAPM and start publishing your own packages, so anyone can start using them… anywhere!
We have created a guide to ease the initiation into wapm:
We also created an example package to showcase how to create and publish a package to wapm using Rust and the WASI target:
Welcome to the WebAssembly journey!
Interested in working with us?
Reach out to firstname.lastname@example.org!