/asterius

A Haskell to WebAssembly compiler
  1. Haskell 32.0%
  2. WebAssembly 29.8%
  3. JavaScript 17.8%
  4. C++ 16.5%
  5. C 2.5%
  6. Python 0.8%
  7. Other 0.6%
Switch branches/tags
Nothing to show
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.circleci Improve rtsapi & StablePtr related utils (+11 squashed commit) Aug 16, 2018
asterius "foreign export javascript" is working, included in jsffi unit test. … Aug 19, 2018
binaryen Update binaryen to version_50 Aug 8, 2018
docs "foreign export javascript" is working, included in jsffi unit test. … Aug 19, 2018
genapply Include genapply into build script of ghc-toolkit, to properly genera… Apr 23, 2018
ghc-toolkit Do not depend on gcc after booting; update ghc (+3 squashed commit) Aug 21, 2018
.gitignore Improve JSFFI & docs (+18 squashed commit) Jul 16, 2018
Dockerfile Improve JSFFI & docs (+18 squashed commit) Jul 16, 2018
README.md "foreign export javascript" is working, included in jsffi unit test. … Aug 19, 2018
appveyor.yml Improve rtsapi & StablePtr related utils (+11 squashed commit) Aug 16, 2018
mkdocs.yml Add Checklist Aug 16, 2018
stack.yaml Do not depend on gcc after booting; update ghc (+3 squashed commit) Aug 21, 2018

README.md

Asterius: A Haskell to WebAssembly compiler

CircleCI AppVeyor

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

See the documentation for further instructions.

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. IO is achieved via rts primitives like print_i64 or JavaScript FFI.
  • Importing JavaScript expressions via the foreign import javascript syntax. First-class JSRef type in Haskell land.
  • 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 outputs memory loads/stores and control flow transfers.
  • Complete binaryen raw bindings, plus a monadic EDSL to construct WebAssembly code directly in Haskell.
  • Besides WebAssembly MVP & the experimental BigInt support, no special requirements on the underlying JavaScript engine.

Better check the fib, jsffi, array and rtsapi 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.