diff --git a/README.md b/README.md index 877f0d6ef85..12d764314a7 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ Wasmer Docs - + Wasmer on Discord

@@ -22,23 +22,23 @@
Wasmer is a _fast_ and _secure_ [**WebAssembly**](https://webassembly.org) runtime that enables super -_lightweight containers_ to run anywhere: from *Desktop* to the *Cloud*, *Edge* and *IoT* devices. +_lightweight containers_ to run anywhere: from _Desktop_ to the _Cloud_, _Edge_ and _IoT_ devices. > _This document is also available in: -[🇨🇳 中 文 -Chinese](https://github.com/wasmerio/wasmer/blob/master/docs/cn/README.md) • -[🇩🇪 Deutsch-German](https://github.com/wasmerio/wasmer/blob/master/docs/de/README.md) • -[🇪🇸 Español-Spanish](https://github.com/wasmerio/wasmer/blob/master/docs/es/README.md) • -[🇫🇷 Français-French](https://github.com/wasmerio/wasmer/blob/master/docs/fr/README.md) • -[🇯🇵 日本 語 -Japanese](https://github.com/wasmerio/wasmer/blob/master/docs/ja/README.md) • -[🇰🇷 한국어 -Korean](https://github.com/wasmerio/wasmer/blob/master/docs/ko/README.md)_. +> [🇨🇳 中 文 -Chinese](https://github.com/wasmerio/wasmer/blob/master/docs/cn/README.md) • +> [🇩🇪 Deutsch-German](https://github.com/wasmerio/wasmer/blob/master/docs/de/README.md) • +> [🇪🇸 Español-Spanish](https://github.com/wasmerio/wasmer/blob/master/docs/es/README.md) • +> [🇫🇷 Français-French](https://github.com/wasmerio/wasmer/blob/master/docs/fr/README.md) • +> [🇯🇵 日本 語 -Japanese](https://github.com/wasmerio/wasmer/blob/master/docs/ja/README.md) • +> [🇰🇷 한국어 -Korean](https://github.com/wasmerio/wasmer/blob/master/docs/ko/README.md)_. ### Features -* Secure by default. No file, network, or environment access, unless explicitly enabled. -* Supports [WASI](https://github.com/WebAssembly/WASI) and [Emscripten](https://emscripten.org/) out of the box. -* Fast. Run WebAssembly at near-native speeds. -* Embeddable in [multiple programming languages](https://github.com/wasmerio/wasmer/#-language-integrations) -* Compliant with latest WebAssembly Proposals (SIMD, Reference Types, Threads, ...) +- Secure by default. No file, network, or environment access, unless explicitly enabled. +- Supports [WASIX](http://wasix.org/), [WASI](https://github.com/WebAssembly/WASI) and [Emscripten](https://emscripten.org/) out of the box. +- Fast. Run WebAssembly at near-native speeds. +- Embeddable in [multiple programming languages](https://github.com/wasmerio/wasmer/#-language-integrations) +- Compliant with latest WebAssembly Proposals (SIMD, Reference Types, Threads, ...). Read more about [Wasmer's WebAssembly Features](https://docs.wasmer.io/runtime/features#webassembly-features). ### Install @@ -48,7 +48,6 @@ Wasmer CLI ships as a single executable with no dependencies. curl https://get.wasmer.io -sSfL | sh ``` -
Other installation options (Powershell, Brew, Cargo, ...) @@ -59,49 +58,50 @@ curl https://get.wasmer.io -sSfL | sh iwr https://win.wasmer.io -useb | iex ``` - * Homebrew (macOS, Linux) +- Homebrew (macOS, Linux) - ```sh - brew install wasmer - ``` + ```sh + brew install wasmer + ``` - * Scoop (Windows) +- Scoop (Windows) - ```sh - scoop install wasmer - ``` + ```sh + scoop install wasmer + ``` - * Chocolatey (Windows) +- Chocolatey (Windows) - ```sh - choco install wasmer - ``` + ```sh + choco install wasmer + ``` - * Cargo binstall - - ```sh - cargo binstall wasmer-cli - ``` +- Cargo binstall - * Cargo + ```sh + cargo binstall wasmer-cli + ``` - _Note: All the available - features are described in the [`wasmer-cli` - crate docs](https://github.com/wasmerio/wasmer/tree/master/lib/cli/README.md)_ +- Cargo - ```sh - cargo install wasmer-cli - ``` + _Note: All the available + features are described in the [`wasmer-cli` + crate docs](https://github.com/wasmerio/wasmer/tree/master/lib/cli/README.md)_ + + ```sh + cargo install wasmer-cli + ``` + +> Looking for more installation options? See [the `wasmer-install` +> repository](https://github.com/wasmerio/wasmer-install) to learn +> more! - > Looking for more installation options? See [the `wasmer-install` - repository](https://github.com/wasmerio/wasmer-install) to learn - more!
### Quickstart You can start by running -[QuickJS](https://wapm.io/saghul/quickjs), a small and +[QuickJS](https://wasmer.io/saghul/quickjs), a small and embeddable Javascript engine compiled as a WebAssembly module ([`qjs.wasm`](https://registry-cdn.wapm.io/contents/_/quickjs/0.0.3/build/qjs.wasm)): ```bash @@ -114,38 +114,38 @@ hello 3 #### Here is what you can do next: -- [Use Wasmer from your Rust application](https://docs.wasmer.io/integrations/rust) -- [Publish a Wasm package on WAPM](https://docs.wasmer.io/ecosystem/wapm/publishing-your-package) -- [Read more about Wasmer](https://medium.com/wasmer/) +- [Use Wasmer from your Rust application](https://docs.rs/wasmer/latest/wasmer/) +- [Publish a WASM/WASIX package on Wasmer](https://docs.wasmer.io/registry/get-started) +- [Read more about Wasmer](https://wasmer.io/posts) ## 📦 Language Integrations The Wasmer runtime can be used as a library **embedded in different languages**, so you can use WebAssembly _anywhere_. -| | Language | Package | Documentation | -|-|-|-|-| -| ![Rust logo] | [**Rust**][Rust integration] | [`wasmer` Rust crate] | [Learn][rust docs] -| ![C logo] | [**C**][C integration] | [`wasm.h` header] | [Learn][c docs] | -| ![C++ logo] | [**C++**][C integration] | [`wasm.hh` header] | [Learn][c docs] | -| ![C# logo] | [**C#**][C# integration] | [`WasmerSharp` NuGet package] | [Learn][c# docs] | -| ![D logo] | [**D**][D integration] | [`wasmer` Dub package] | [Learn][d docs] | -| ![Python logo] | [**Python**][Python integration] | [`wasmer` PyPI package] | [Learn][python docs] | -| ![JS logo] | [**Javascript**][JS integration] | [`@wasmerio` NPM packages] | [Learn][js docs] | -| ![Go logo] | [**Go**][Go integration] | [`wasmer` Go package] | [Learn][go docs] | -| ![PHP logo] | [**PHP**][PHP integration] | [`wasm` PECL package] | [Learn][php docs] | -| ![Ruby logo] | [**Ruby**][Ruby integration] | [`wasmer` Ruby Gem] | [Learn][ruby docs] | -| ![Java logo] | [**Java**][Java integration] | [`wasmer/wasmer-jni` Bintray package] | [Learn][java docs] | -| ![R logo] | [**R**][R integration] | *no published package* | [Learn][r docs] | -| ![Postgres logo] | [**Postgres**][Postgres integration] | *no published package* | [Learn][postgres docs] | -| ![Swift logo] | [**Swift**][Swift integration] | *no published package* | | -| ![Zig logo] | [**Zig**][Zig integration] | *no published package* | | -| ![Dart logo] | [**Dart**][Dart integration] | [`wasm` pub package] | | -| ![Crystal logo] | [**Crystal**][Crystal integration] | *no published package* | [Learn][crystal docs] | -| ![Lisp logo] | [**Lisp**][Lisp integration] | *no published package* | | -| ![Julia logo] | [**Julia**][Julia integration] | *no published package* | | -| ![VLang logo] | [**V**][vlang integration] | *no published package* | | -| ![Ocaml logo] | [**OCaml**][OCaml integration] | [`wasmer` OCaml package] | | +| | Language | Package | Documentation | +| ---------------- | ------------------------------------ | ------------------------------------- | ---------------------- | +| ![Rust logo] | [**Rust**][Rust integration] | [`wasmer` Rust crate] | [Learn][rust docs] | +| ![C logo] | [**C**][C integration] | [`wasm.h` header] | [Learn][c docs] | +| ![C++ logo] | [**C++**][C integration] | [`wasm.hh` header] | [Learn][c docs] | +| ![C# logo] | [**C#**][C# integration] | [`WasmerSharp` NuGet package] | [Learn][c# docs] | +| ![D logo] | [**D**][D integration] | [`wasmer` Dub package] | [Learn][d docs] | +| ![Python logo] | [**Python**][Python integration] | [`wasmer` PyPI package] | [Learn][python docs] | +| ![JS logo] | [**Javascript**][JS integration] | [`@wasmerio` NPM packages] | [Learn][js docs] | +| ![Go logo] | [**Go**][Go integration] | [`wasmer` Go package] | [Learn][go docs] | +| ![PHP logo] | [**PHP**][PHP integration] | [`wasm` PECL package] | [Learn][php docs] | +| ![Ruby logo] | [**Ruby**][Ruby integration] | [`wasmer` Ruby Gem] | [Learn][ruby docs] | +| ![Java logo] | [**Java**][Java integration] | [`wasmer/wasmer-jni` Bintray package] | [Learn][java docs] | +| ![R logo] | [**R**][R integration] | _no published package_ | [Learn][r docs] | +| ![Postgres logo] | [**Postgres**][Postgres integration] | _no published package_ | [Learn][postgres docs] | +| ![Swift logo] | [**Swift**][Swift integration] | _no published package_ | | +| ![Zig logo] | [**Zig**][Zig integration] | _no published package_ | | +| ![Dart logo] | [**Dart**][Dart integration] | [`wasm` pub package] | | +| ![Crystal logo] | [**Crystal**][Crystal integration] | _no published package_ | [Learn][crystal docs] | +| ![Lisp logo] | [**Lisp**][Lisp integration] | _no published package_ | | +| ![Julia logo] | [**Julia**][Julia integration] | _no published package_ | | +| ![VLang logo] | [**V**][vlang integration] | _no published package_ | | +| ![Ocaml logo] | [**OCaml**][OCaml integration] | [`wasmer` OCaml package] | | [👋  Missing a language?](https://github.com/wasmerio/wasmer/issues/new?assignees=&labels=%F0%9F%8E%89+enhancement&template=---feature-request.md&title=) @@ -153,91 +153,70 @@ languages**, so you can use WebAssembly _anywhere_. [rust integration]: https://github.com/wasmerio/wasmer/tree/master/lib/api [`wasmer` rust crate]: https://crates.io/crates/wasmer/ [rust docs]: https://docs.rs/wasmer/ - [c logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/c.svg [c integration]: https://github.com/wasmerio/wasmer/tree/master/lib/c-api [`wasm.h` header]: https://github.com/wasmerio/wasmer/blob/master/lib/c-api/tests/wasm-c-api/include/wasm.h [c docs]: https://docs.rs/wasmer-c-api/*/wasmer/wasm_c_api/index.html - [c++ logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/cpp.svg [`wasm.hh` header]: https://github.com/wasmerio/wasmer/blob/master/lib/c-api/tests/wasm-c-api/include/wasm.hh - [c# logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/csharp.svg [c# integration]: https://github.com/migueldeicaza/WasmerSharp [`wasmersharp` nuget package]: https://www.nuget.org/packages/WasmerSharp/ [c# docs]: https://migueldeicaza.github.io/WasmerSharp/ - [d logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/d.svg [d integration]: https://github.com/chances/wasmer-d [`wasmer` Dub package]: https://code.dlang.org/packages/wasmer [d docs]: https://chances.github.io/wasmer-d - [python logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/python.svg [python integration]: https://github.com/wasmerio/wasmer-python [`wasmer` pypi package]: https://pypi.org/project/wasmer/ [python docs]: https://wasmerio.github.io/wasmer-python/api/wasmer - [go logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/go.svg [go integration]: https://github.com/wasmerio/wasmer-go [`wasmer` go package]: https://pkg.go.dev/github.com/wasmerio/wasmer-go/wasmer [go docs]: https://pkg.go.dev/github.com/wasmerio/wasmer-go/wasmer?tab=doc - [php logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/php.svg [php integration]: https://github.com/wasmerio/wasmer-php [`wasm` pecl package]: https://pecl.php.net/package/wasm [php docs]: https://wasmerio.github.io/wasmer-php/ - [js logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/js.svg [js integration]: https://github.com/wasmerio/wasmer-js [`@wasmerio` npm packages]: https://www.npmjs.com/org/wasmer [js docs]: https://docs.wasmer.io/integrations/js/reference-api - [ruby logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/ruby.svg [ruby integration]: https://github.com/wasmerio/wasmer-ruby [`wasmer` ruby gem]: https://rubygems.org/gems/wasmer [ruby docs]: https://wasmerio.github.io/wasmer-ruby/wasmer_ruby/index.html - [java logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/java.svg [java integration]: https://github.com/wasmerio/wasmer-java [`wasmer/wasmer-jni` bintray package]: https://bintray.com/wasmer/wasmer-jni/wasmer-jni [java docs]: https://github.com/wasmerio/wasmer-java/#api-of-the-wasmer-library - [elixir logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/elixir.svg [elixir integration]: https://github.com/tessi/wasmex [elixir docs]: https://hexdocs.pm/wasmex/api-reference.html [`wasmex` hex package]: https://hex.pm/packages/wasmex - [r logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/r.svg [r integration]: https://github.com/dirkschumacher/wasmr [r docs]: https://github.com/dirkschumacher/wasmr#example - [postgres logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/postgres.svg [postgres integration]: https://github.com/wasmerio/wasmer-postgres [postgres docs]: https://github.com/wasmerio/wasmer-postgres#usage--documentation - [swift logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/swift.svg [swift integration]: https://github.com/AlwaysRightInstitute/SwiftyWasmer - [zig logo]: https://github.com/raw/ziglang/logo/master/zig-favicon.png [zig integration]: https://github.com/zigwasm/wasmer-zig - [dart logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/dart.svg [dart integration]: https://github.com/dart-lang/wasm [`wasm` pub package]: https://pub.dev/packages/wasm - [lisp logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/lisp.svg [lisp integration]: https://github.com/helmutkian/cl-wasm-runtime - [crystal logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/crystal.svg [crystal integration]: https://github.com/naqvis/wasmer-crystal [crystal docs]: https://naqvis.github.io/wasmer-crystal/ - [julia logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/julia.svg [julia integration]: https://github.com/Pangoraw/Wasmer.jl - [vlang logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/vlang.svg [vlang integration]: https://github.com/vlang/wasmer - [OCaml logo]: https://github.com/raw/wasmerio/wasmer/master/assets/languages/ocaml.svg [OCaml integration]: https://github.com/wasmerio/wasmer-ocaml [`wasmer` OCaml package]: https://opam.ocaml.org/packages/wasmer/ @@ -246,11 +225,11 @@ languages**, so you can use WebAssembly _anywhere_. We appreciate your help! 💜 -We recommend reading the following guide on how to contribute into a complex project successfully: +We recommend reading the following guide on how to contribute into a complex project successfully: https://mitchellh.com/writing/contributing-to-complex-projects Check our docs on how to [build Wasmer from -source](https://docs.wasmer.io/ecosystem/wasmer/building-from-source) or [test your changes](https://docs.wasmer.io/ecosystem/wasmer/building-from-source/testing). +source](https://docs.wasmer.io/developers/build-from-source) or [test your changes](https://docs.wasmer.io/developers/testing). ## Bounties @@ -263,12 +242,10 @@ For some issues we offer paid bounties. You'll get paid automatically as soon as - ## Community Wasmer has an amazing community of developers and contributors. Welcome, please join us! 👋 -- [Wasmer Community Slack](https://slack.wasmer.io/) +- [Wasmer Community Discord](https://discord.gg/rWkMNStrEW) - [Wasmer on Twitter](https://twitter.com/wasmerio) -- [Wasmer on Facebook](https://www.facebook.com/wasmerio) - [Email](mailto:hello@wasmer.io)