You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Nick Fitzgerald 7341e2fb14
Merge pull request #980 from alexcrichton/mdbook-test
5 years ago
.dependabot Update dependabot for only security updates 5 years ago
.github Install submodules as well 5 years ago
ci Move the C API to a separate crate (#818) 5 years ago
crates Update cranelift to 0.59.0 5 years ago
docs Test book documentation on CI 5 years ago
fuzz Remove always-on logging from fuzz targets (#878) 5 years ago
scripts Document and codify the release process 5 years ago
src Optimize generated code via the CLI by default (#973) 5 years ago
tests Optimize generated code via the CLI by default (#973) 5 years ago
.gitignore Commit Cargo.lock. (#705) 5 years ago
.gitmodules Move the C API to a separate crate (#818) 5 years ago
.rustfmt.toml Convert a CRLF file. 5 years ago
CODE_OF_CONDUCT.md docs: Include the code of conduct directly into the mdbook 5 years ago
CONTRIBUTING.md Fix links in CONTRIBUTING.md (#565) 5 years ago
Cargo.lock Update cranelift to 0.59.0 5 years ago
Cargo.toml Update dependencies to current versions, reducing duplicate versions (#963) 5 years ago
LICENSE Adjust whitespace to match the upstream exception text. 6 years ago
ORG_CODE_OF_CONDUCT.md Make it a Bytecode Alliance project (#549) 5 years ago
README.md Update lightbeam link (#558) 5 years ago
SECURITY.md Make it a Bytecode Alliance project (#549) 5 years ago
build.rs Update to cranelift 0.58.0 and enable (but ignore) reference types and bulk memory tests (#926) 5 years ago
clippy.toml General Cargo.toml cleanup. (#529) 5 years ago

README.md

Wasmtime: a WebAssembly Runtime

A Bytecode Alliance project

Wasmtime is a standalone wasm-only optimizing runtime for WebAssembly and WASI. It runs WebAssembly code outside of the Web, and can be used both as a command-line utility or as a library embedded in a larger application.

To get started, visit wasmtime.dev.

build-status gitter-chat-badge minimum-rustc

There are Rust, C, and C++ toolchains that can compile programs with WASI. See the WASI intro for more information, and the WASI tutorial for a tutorial on compiling and running programs using WASI and wasmtime, as well as an overview of the filesystem sandboxing system.

Wasmtime passes the WebAssembly spec testsuite. To run it, update the tests/spec_testsuite submodule with git submodule update --remote, and it will be run as part of cargo test.

Wasmtime does not yet implement Spectre mitigations, however this is a subject of ongoing research.

Additional goals for Wasmtime include:

  • Support a variety of host APIs (not just WASI), with fast calling sequences, and develop proposals for additional API modules to be part of WASI.
  • Facilitate development and testing around the Cranelift and Lightbeam JITs, and other WebAssembly execution strategies.
  • Develop a native ABI used for compiling WebAssembly suitable for use in both JIT and AOT to native object files.

Including Wasmtime in your project

Wasmtime exposes an API for embedding as a library through the wasmtime subcrate, which contains both a high-level and safe Rust API, as well as a C-compatible API compatible with the proposed WebAssembly C API.

For more information, see the Rust API embedding chapter of the Wasmtime documentation.

It's Wasmtime.