Skip to main content

The Cranelift compiler for the `wasmer` package (to compile WebAssembly module)

Project description

Wasmer logo Wasmer Python PyPI version Wasmer Python Documentation Wasmer PyPI downloads Wasmer Slack Channel

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

Other compilers exist:

  • wasmer_compiler_llvm,
  • 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_cranelift

Usage

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

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

# Let's use the Cranelift 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/.

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

wasmer_compiler_cranelift-1.0.0_beta1-cp39-cp39-macosx_10_7_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.9 macOS 10.7+ x86-64

wasmer_compiler_cranelift-1.0.0_beta1-cp38-cp38-macosx_10_7_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.8 macOS 10.7+ x86-64

wasmer_compiler_cranelift-1.0.0_beta1-cp37-cp37m-macosx_10_7_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.7m macOS 10.7+ x86-64

wasmer_compiler_cranelift-1.0.0_beta1-cp36-cp36m-macosx_10_7_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.6m macOS 10.7+ x86-64

wasmer_compiler_cranelift-1.0.0_beta1-cp35-cp35m-macosx_10_7_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.5m macOS 10.7+ x86-64

Supported by

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