https://github.com/binji/wasm-e2e
Temporary scaffolding for running WebAssembly end-to-end, from C++ to browsers.
https://github.com/binji/wasm-e2e
Last synced: about 1 year ago
JSON representation
Temporary scaffolding for running WebAssembly end-to-end, from C++ to browsers.
- Host: GitHub
- URL: https://github.com/binji/wasm-e2e
- Owner: binji
- License: apache-2.0
- Created: 2015-10-27T00:52:38.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2016-03-25T16:45:30.000Z (over 10 years ago)
- Last Synced: 2025-06-03T10:53:58.005Z (about 1 year ago)
- Language: Python
- Homepage:
- Size: 46.9 KB
- Stars: 23
- Watchers: 18
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: Contributing.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
[](https://travis-ci.org/WebAssembly/wasm-e2e)
# wasm-e2e
**WARNING**
wasm-e2e isn't kept up to date anymore. We're keeping it here for historical purpose only. Don't rely on it!
**WARNING**
This repository contains tools and scripts to compile C/C++ to a WebAssembly
binary format, and run it.
Currently this includes:
- LLVM: for compiling C source to the ".s" format, which is the current
output of WebAssembly by the LLVM backend.
- binaryen: different tools, including `s2wasm` for converting `.s` to the
S-expression format as defined in the [spec repo][].
- sexpr-wasm: for converting the S-expression format to the v8-native binary
format.
- v8-native: for running the binary.
[spec repo]: https://github.com/WebAssembly/spec
At this time, the contents of this repository are under development and known
to be incomplet and inkorrect.
Participation is welcome, though many of the changes will need to be landed in
other repositories.
## Cloning/Updating
Clone the repo, update the submodules, and update LLVM:
```
$ git clone https://github.com/WebAssembly/wasm-e2e
$ cd wasm-e2e
$ git submodule update --init
$ ./scripts/update-llvm.sh
```
LLVM is not included as a submodule because it is quite large and requires a
repo to be installed inside another repo. The `update-llvm.sh` script clones
with `--depth 5000` to reduce the download size.
Updating the repo is almost the same:
```
$ git pull origin master
$ git submodule update
$ ./scripts/update-llvm.sh
```
## Building
To build all the tools:
```
$ ./scripts/build-all.sh
```
You can also build each component separately:
- LLVM/Clang: `./scripts/build-llvm.sh`
- v8-native/d8: `./scripts/build-d8.sh`
- sexpr-wasm: `./scripts/build-sexpr-wasm.sh`
## Running
Use the `./script/run.py` Python script to compile and run a C source file:
```
$ ./scripts/run.py test/hello.c
Hello, world!
$ scripts/run.py test/fizzbuzz.c
1
2
fizz
4
buzz
fizz
7
8
fizz
buzz
11
fizz
13
14
fizzbuzz
16
17
fizz
19
```
The script compiles the C source to v8-native binary format.