Python extension to run WebAssembly binaries

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for syrusakbary from gravatar.com syrusakbary Avatar for wasmer from gravatar.com wasmer

Unverified details

These details have not been verified by PyPI
Project links
Meta
Classifiers
Report project as malware

Project description

Wasmer logo Wasmer Python, the LLVM compiler PyPI version Wasmer Python Documentation Wasmer PyPI downloads Wasmer Slack Channel

wasmer is a complete and mature WebAssembly runtime for Python. wasmer_compiler_llvm provides the LLVM compiler to wasmer, so that wasmer is able to compile WebAssembly module.

Other compilers exist:

  • wasmer_compiler_cranelift,
  • wasmer_compiler_singlepass.

To get a more complete view, please see the documentation of the wasmer package itself.

Install

This package must be used with the wasmer package, thus:

$ pip install wasmer
$ pip install wasmer_compiler_llvm

Usage

Any engines in wasmer.engine can take the wasmer_compiler_llvm.Compiler class as argument:

from wasmer import engine, Store, Module, Instance
from wasmer_compiler_llvm import Compiler

# Let's use the LLVM compiler with the JIT engine…
store = Store(engine.JIT(Compiler))

# … or with the native engine!
store = Store(engine.Native(Compiler))

# And now, compile the module.
module = Module(store, open('my_program.wasm', 'rb').read())

# Now it's compiled, let's instantiate it.
instance = Instance(module)

# And get fun, for example by calling the `sum` exported function!
print(instance.exports.sum(1, 2))

Documentation

Browse the documentation at https://wasmerio.github.io/wasmer-python/api/wasmer_compiler_llvm/.

Alternatively, run just build compiler-llvm followed by just doc to generate the documentation inside docs/api/wasmer_compiler_llvm.html.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page