mirror of
https://github.com/mii443/wasmer.git
synced 2025-09-03 07:59:25 +00:00
4384ddf9cd
- Store::new() now takes an impl Into<Engine>. - Added Into<Engine> impls in each of the compilers - Updated docs/migration_to_3.0.0.md on API usage
34 lines
1.7 KiB
Markdown
34 lines
1.7 KiB
Markdown
# `wasmer-compiler-singlepass` [](https://github.com/wasmerio/wasmer/actions?query=workflow%3Abuild) [](https://slack.wasmer.io) [](https://github.com/wasmerio/wasmer/blob/master/LICENSE) [](https://crates.io/crates/wasmer-compiler-singlepass)
|
|
|
|
This crate contains a compiler implementation based on the Singlepass linear compiler.
|
|
|
|
## Usage
|
|
|
|
```rust
|
|
use wasmer::{Store, EngineBuilder};
|
|
use wasmer_compiler_singlepass::Singlepass;
|
|
|
|
let compiler = Singlepass::new();
|
|
let mut store = Store::new(compiler);
|
|
```
|
|
|
|
*Note: you can find a [full working example using Singlepass compiler
|
|
here][example].*
|
|
|
|
## When to use Singlepass
|
|
|
|
Singlepass is designed to emit compiled code at linear time, as such
|
|
is not prone to JIT bombs and also offers great compilation
|
|
performance orders of magnitude faster than
|
|
[`wasmer-compiler-cranelift`] and [`wasmer-compiler-llvm`], however
|
|
with a bit slower runtime speed.
|
|
|
|
The fact that singlepass is not prone to JIT bombs and offers a very
|
|
predictable compilation speed makes it ideal for **blockchains** and other
|
|
systems where fast and consistent compilation times are very critical.
|
|
|
|
|
|
[example]: https://github.com/wasmerio/wasmer/blob/master/examples/compiler_singlepass.rs
|
|
[`wasmer-compiler-cranelift`]: https://github.com/wasmerio/wasmer/tree/master/lib/compiler-cranelift
|
|
[`wasmer-compiler-llvm`]: https://github.com/wasmerio/wasmer/tree/master/lib/compiler-llvm
|