12 unstable releases (3 breaking)

new 0.4.4 May 3, 2021
0.4.3 Apr 27, 2021
0.3.2 Mar 30, 2021
0.2.2 Mar 2, 2021
0.1.7 Nov 10, 2020

#22 in WebAssembly

Download history 5/week @ 2021-01-15 4/week @ 2021-01-22 2/week @ 2021-01-29 2/week @ 2021-02-05 34/week @ 2021-02-12 8/week @ 2021-02-19 43/week @ 2021-02-26 27/week @ 2021-03-05 6/week @ 2021-03-12 15/week @ 2021-03-19 32/week @ 2021-03-26 18/week @ 2021-04-02 6/week @ 2021-04-09 103/week @ 2021-04-16 41/week @ 2021-04-23 44/week @ 2021-04-30

114 downloads per month

Apache-2.0 and LGPL-3.0

245KB
6K SLoC

Latest Release Rust Build Rust Version Contributors Good first issues

                                     _                 _    _____ _          _ _ 
                                ____| |               | |  / ____| |        | | |
 __      ____ _ ___ _ __ ___  / ____| | ___  _   _  __| | | (___ | |__   ___| | |
 \ \ /\ / / _` / __| '_ ` _ \| |    | |/ _ \| | | |/ _` |  \___ \| '_ \ / _ \ | |
  \ V  V / (_| \__ \ | | | | | |____| | (_) | |_| | (_| |  ____) | | | |  __/ | |
   \_/\_/ \__,_|___/_| |_| |_|\_____|_|\___/ \__,_|\__,_| |_____/|_| |_|\___|_|_|

Why wash

wash is a bundle of command line tools that, together, form a comprehensive CLI for wasmcloud development. Everything from generating signing keys to a fully interactive REPL environment is contained within the subcommands of wash. Our goal with wash is to encapsulate our tools into a single binary to make developing WebAssembly with wasmcloud painless and simple.

Installing wash

Cargo

cargo install wash-cli

Linux (deb/rpm + apt)

# Debian / Ubuntu (deb)
curl -s https://packagecloud.io/install/repositories/wasmcloud/core/script.deb.sh | sudo bash
# Fedora (rpm)
curl -s https://packagecloud.io/install/repositories/wasmcloud/core/script.rpm.sh | sudo bash

sudo apt install wasmcloud wash

MacOS (brew)

brew tap wasmcloud/wasmcloud
brew install wasmcloud wash

NixOS

nix run github:wasmCloud/wash

Using wash

wash has multiple subcommands, each specializing in one specific area of the wasmcloud development process.

claims

Generate JWTs for actors, capability providers, accounts and operators. Sign actor modules with claims including capability IDs, expiration, and keys to verify identity. Inspect actor modules to view their claims.

ctl

Interact directly with a wasmcloud control-interface, allowing you to imperatively schedule actors, providers and modify configurations of a wasmcloud host. Can be used to interact with local and remote control-interfaces.

drain

Manage contents of the local wasmcloud cache. wasmcloud manages a local cache that will avoid redundant fetching of content when possible. drain allows you to manually clear that cache to ensure you're always pulling the latest versions of actors and providers that are hosted in remote OCI registries.

keys

Generate ed25519 keys for securely signing and identifying wasmcloud entities (actors, providers, hosts). Read more about our decision to use ed25519 keys in our ADR.

par

Create, modify and inspect provider archives, a TAR format that contains a signed JWT and OS/Architecture specific binaries for native capability providers.

reg

Push and Pull actors and capability providers to/from OCI compliant registries. Used extensively in our own CI/CD and in local development, where a local registry is used to store your development artifacts.

up

Launch a fully interactive wasmcloud REPL environment, where all of the above subcommands are available to you. up provides you with a wasmcloud host, so you can get started running actors and providers without ever touching a line of code.

Contributing to wash

If you have any feature suggestions, find any bugs, or otherwise have a question, please submit an issue here. Forking & submitting Pull Requests are welcome, and the good first issue label is a great way to find a place to start if you're looking to contribute.

Dependencies

~34MB
~731K SLoC