wasmer/lib/README.md

# Wasmer Libraries

Wasmer is modularized into different libraries, separated into three main sections:

- [Runtime](#runtime)
- [Integrations](#integrations)
- [Backends](#backends)

## Runtime

The core of Wasmer is the runtime, which provides the necessary
abstractions to create a good user experience when embedding.

The runtime is divided into two main libraries:

- [runtime-core](./runtime-core/): The main implementation of the runtime.
- [runtime](./runtime/): Easy-to-use API on top of `runtime-core`.

## Integrations

The integration builds on the Wasmer runtime and allow us to run WebAssembly files compiled for different environments.

Wasmer intends to support different integrations:

- [emscripten](./emscripten): run Emscripten-generated WebAssembly files, such as [Lua](../examples/lua.wasm) or [nginx](../examples/nginx/nginx.wasm).
- Go ABI: _we will work on this soon! Want to give us a hand? ✋_
- Blazor: _research period, see [tracking issue](https://github.com/wasmerio/wasmer/issues/97)_

## Backends

The Wasmer [runtime](./runtime) is designed to support multiple compiler backends, allowing the user
to tune the codegen properties (compile speed, performance, etc) to best fit their use case.

Currently, we support multiple backends for compiling WebAssembly to machine code:

- [dynasm-backend](./dynasm-backend/): Dynasm backend - super fast compilation, slower runtime speed
- [clif-backend](./clif-backend/): Cranelift backend - slower compilation, normal runtime speed
- [llvm-backend](./llvm-backend/): LLVM backend - slow compilation, native runtime speed
Improved docs, adding repo structure and libraries README 2019-01-22 19:34:36 +00:00			`# Wasmer Libraries`

			`Wasmer is modularized into different libraries, separated into three main sections:`
Improved docs 2019-01-22 20:23:53 +00:00
Fix formatting and grammar in documentation 2019-02-20 00:01:44 +00:00			`- [Runtime](#runtime)`
			`- [Integrations](#integrations)`
			`- [Backends](#backends)`
Improved docs, adding repo structure and libraries README 2019-01-22 19:34:36 +00:00
			`## Runtime`

Improved docs 2019-01-22 20:23:53 +00:00			`The core of Wasmer is the runtime, which provides the necessary`
Fix formatting and grammar in documentation 2019-02-20 00:01:44 +00:00			`abstractions to create a good user experience when embedding.`
Improved docs 2019-01-22 20:23:53 +00:00
			`The runtime is divided into two main libraries:`
Improved docs, adding repo structure and libraries README 2019-01-22 19:34:36 +00:00
Improved docs 2019-01-22 20:23:53 +00:00			`- [runtime-core](./runtime-core/): The main implementation of the runtime.`
Fix formatting and grammar in documentation 2019-02-20 00:01:44 +00:00			- [runtime](./runtime/): Easy-to-use API on top of `runtime-core`.
Improved docs, adding repo structure and libraries README 2019-01-22 19:34:36 +00:00
			`## Integrations`

Fix formatting and grammar in documentation 2019-02-20 00:01:44 +00:00			`The integration builds on the Wasmer runtime and allow us to run WebAssembly files compiled for different environments.`
Improved docs, adding repo structure and libraries README 2019-01-22 19:34:36 +00:00
			`Wasmer intends to support different integrations:`

Fix formatting and grammar in documentation 2019-02-20 00:01:44 +00:00			`- [emscripten](./emscripten): run Emscripten-generated WebAssembly files, such as [Lua](../examples/lua.wasm) or [nginx](../examples/nginx/nginx.wasm).`
Improved docs 2019-01-22 20:23:53 +00:00			`- Go ABI: _we will work on this soon! Want to give us a hand? ✋_`
Fix formatting and grammar in documentation 2019-02-20 00:01:44 +00:00			`- Blazor: _research period, see [tracking issue](https://github.com/wasmerio/wasmer/issues/97)_`
Improved docs, adding repo structure and libraries README 2019-01-22 19:34:36 +00:00
			`## Backends`

Improved docs 2019-01-22 20:23:53 +00:00			`The Wasmer [runtime](./runtime) is designed to support multiple compiler backends, allowing the user`
Fix formatting and grammar in documentation 2019-02-20 00:01:44 +00:00			`to tune the codegen properties (compile speed, performance, etc) to best fit their use case.`
Improved docs 2019-01-22 20:23:53 +00:00
Update README.md 2019-03-08 04:39:44 +00:00			`Currently, we support multiple backends for compiling WebAssembly to machine code:`
Improved docs, adding repo structure and libraries README 2019-01-22 19:34:36 +00:00
Added dynasm-backend to the libraries README 2019-03-22 04:12:01 +00:00			`- [dynasm-backend](./dynasm-backend/): Dynasm backend - super fast compilation, slower runtime speed`
			`- [clif-backend](./clif-backend/): Cranelift backend - slower compilation, normal runtime speed`
			`- [llvm-backend](./llvm-backend/): LLVM backend - slow compilation, native runtime speed`