tweag/asterius
1
1
Fork 0
mirror of https://github.com/tweag/asterius.git synced 2024-11-14 03:18:21 +03:00
Code Issues Projects Releases Wiki Activity
A Haskell to WebAssembly compiler
477 Commits 63 Branches 0 Tags 94 MiB
Haskell 81.4%
JavaScript 12.2%
C 4.1%
Nix 0.8%
Starlark 0.6%
Other 0.9%
a316f8ceb9
Go to file
Shao Cheng a316f8ceb9 Weekly report 190121
2019-01-21 13:36:24 +08:00
.circleci Do not use "ahc-link --bundle" for node.js targets 2019-01-08 03:56:11 +08:00
.github Update to ghc-8.7.20181027 (+13 squashed commit) 2018-10-29 16:38:28 +08:00
asterius Finalize the modularized rts work #50 (+53 squashed commit) 2019-01-08 03:36:09 +08:00
binaryen Work around the lack of -M on macOS for ar (#55) 2019-01-11 22:57:10 +08:00
docs Weekly report 190121 2019-01-21 13:36:24 +08:00
ghc-toolkit Finalize the modularized rts work #50 (+53 squashed commit) 2019-01-08 03:36:09 +08:00
inline-js@a1b472e03d bytestring support & numerous bugfixes and impovements 2018-12-09 10:19:01 +08:00
npm-utils Finalize the modularized rts work #50 (+53 squashed commit) 2019-01-08 03:36:09 +08:00
utils Simplify rts api & use v8 team's node build (+9 squashed commit) 2018-12-12 18:28:09 +08:00
wabt Update wabt & binaryen, add SIMD opcodes for binaryen bindings 2018-12-15 17:53:20 +08:00
wasm-toolkit bytestring support & numerous bugfixes and impovements 2018-12-09 10:19:01 +08:00
.dockerignore bytestring support & numerous bugfixes and impovements 2018-12-09 10:19:01 +08:00
.ghcid Finalize the modularized rts work #50 (+53 squashed commit) 2019-01-08 03:36:09 +08:00
.gitignore Finalize the modularized rts work #50 (+53 squashed commit) 2019-01-08 03:36:09 +08:00
.gitmodules bytestring support & numerous bugfixes and impovements 2018-12-09 10:19:01 +08:00
Dockerfile Finalize the modularized rts work #50 (+53 squashed commit) 2019-01-08 03:36:09 +08:00
mkdocs.yml Add status reports. 2018-12-28 17:09:21 +08:00
README.md Add status reports. 2018-12-28 17:09:21 +08:00
stack.yaml Fix CI breakage by outdated th-abstraction on head.hackage #52 2019-01-13 21:46:08 +08:00

README.md

Asterius: A Haskell to WebAssembly compiler

CircleCI Docker Pulls

A Haskell to WebAssembly compiler. Project status: alpha, in active development, some simple examples already work.

See the documentation for further instructions. Or check our blog posts:

Also, we've added Weekly Status Reports in case you're interested where the bleeding edge has reached.

Quick start

We provide pre-built Docker images. Put the input .hs program in a directory and map the directory to a Docker volume:

terrorjack@ubuntu:~$ docker run -it -v ~/mirror:/mirror terrorjack/asterius
root@76bcb511663d:~# cd /mirror
root@76bcb511663d:/mirror# ahc-link --help
...

See the help text of ahc-link for further instructions.

What works currently:

  • All GHC language features except Template Haskell.
  • Non-IO parts in ghc-prim/integer-simple/base/array/deepseq/containers/transformers/mtl/pretty/bytestring/binary/xhtml. IO is achieved via rts primitives like print_i64 or JavaScript FFI.
  • Fast arbitrary-precision Integer operations backed by BigInts.
  • Persistent "vault"s which are KV stores transferrable across asterius instances.
  • Importing JavaScript expressions via the foreign import javascript syntax. First-class JSVal type in Haskell land.
  • Fast conversion between Haskell/JavaScript types (strings, arrays and ArrayBuffers at the moment)
  • Calling Haskell functions from JavaScript via the foreign export javascript syntax. Haskell closures can be passed between Haskell/JavaScript boundary via StablePtr.
  • Invoking RTS API on the JavaScript side to manipulate Haskell closures and trigger evaluation.
  • A linker which performs aggressive dead-code elimination, producing as small WebAssembly binary as possible.
  • A debugger which checks invalid memory access and outputs memory loads/stores and control flow transfers.
  • Complete binaryen/wabt raw bindings, plus a monadic EDSL to construct WebAssembly code directly in Haskell.
  • A Haskell library to handle WebAssembly code, which already powers binary code generation.
  • Unit tests implementing stochastic fuzzer/shrinker for WebAssembly, in order to produce minimal repro in case something goes wrong in generated code.
  • Besides WebAssembly MVP and BigInt, no special requirements on the underlying JavaScript engine at the moment.

Better check the fib, jsffi, array, rtsapi and teletype test suites first to get some idea on current capabilities of asterius.

Sponsors

Asterius is maintained by Tweag I/O.

Have questions? Need help? Tweet at @tweagio.