https://github.com/webassembly/wasmint

Library for interpreting / debugging wasm code
https://github.com/webassembly/wasmint

Last synced: 14 days ago
JSON representation

Library for interpreting / debugging wasm code

• Host: GitHub
• URL: https://github.com/webassembly/wasmint
• Owner: WebAssembly
• License: apache-2.0
• Created: 2015-06-19T13:54:10.000Z (over 9 years ago)
• Default Branch: main
• Last Pushed: 2022-08-22T17:46:28.000Z (about 2 years ago)
• Last Synced: 2024-08-02T01:25:24.411Z (3 months ago)
• Language: C++
• Homepage:
• Size: 678 KB
• Stars: 94
• Watchers: 21
• Forks: 12
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# wasmint

[![Build Status](https://travis-ci.org/WebAssembly/wasmint.svg?branch=master)](https://travis-ci.org/WebAssembly/wasmint)

A embeddable **work-in-progress** WebAssembly (**wasm**) **int**erpreter and debugger licensed under the Apache 2.0 License.

## Navigation

* `wasm-module` will build the wasm-module library that allows parsing/serializing wasm modules.

* `libwasmint` will build the libwasmint library that allows running wasm modules inside a VM. The library will also

   be wrapped in a normal binary called `wasmint` that can be used as a normal wasm interpreter.

* `debugger` will build wasmdbg - a interactive wasm debugger with a curses TUI.

* `wast-converter` can transform the *.wast-files that are used in the testsuite into normal wasm programs.

* `wasm-to-c` compiles wasm modules to C source code.

## Current state

The interpreter still needs to catch up with the latest spec.

## Building

libwasmint, wasmint and wasm-module require a C++11 compiler (including STL) and CMake as build dependencies.

wasmdbg also requires a curses implementation. The wast-converter binary requires boost. You only need to install

those dependencies if you require one of those two projects (they are otherwise skipped in the build process).

Make sure to pull all git submodules before the build:

```

git submodule init

git submodule update

```

### Linux/OS X/Unix/Posix

Run this in the source directory:

```

cmake . && make

```

If you want to contribute, out of source builds are preferred (as some files are modified by CMake).

### Windows

CMake can generate a visual studio solution which allows compiling all projects via Visual Studio.