Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/godunko/adawebpack
Ada WASM Runtime and Bindings for Web API
https://github.com/godunko/adawebpack
ada ada-runtime ada-wasm-runtime gnat-llvm wasm
Last synced: 2 months ago
JSON representation
Ada WASM Runtime and Bindings for Web API
- Host: GitHub
- URL: https://github.com/godunko/adawebpack
- Owner: godunko
- License: bsd-3-clause
- Created: 2020-01-09T20:10:48.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-04-02T07:21:14.000Z (over 1 year ago)
- Last Synced: 2024-02-01T16:15:45.444Z (5 months ago)
- Topics: ada, ada-runtime, ada-wasm-runtime, gnat-llvm, wasm
- Language: Ada
- Homepage:
- Size: 493 KB
- Stars: 43
- Watchers: 5
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.BSD3
Lists
- awesome-ada - adawebpack - GNAT RTL for WASM and bindings for Web API. (Runtimes / Continuous Integration)
- awesome-ada - adawebpack - GNAT RTL for WASM and bindings for Web API. (Runtimes / Continuous Integration)
README
[](https://github.com/godunko/adawebpack/actions/workflows/build.yml)
# AdaWebPack
AdaWebPack includes GNAT-LLVM compiler for WebAssembly target, GNAT Run Time Library and AdaWebPack bindings for Web API.
## How to install
Prebuild packages are available on [Release page](https://github.com/godunko/adawebpack/releases).
You will also need `wasm-ld`, the Web asssembly linker. You will find this:
* on Fedora Linux through the `lld` package;
* on Ubuntu through the `lld-15` package;
* on other Linux systems look for a similarly-named package.
## How to build
* Setup GNAT using [Alire](https://alire.ada.dev/) or GNAT Community 2021.
* Clone [GNAT-LLVM](https://github.com/AdaCore/gnat-llvm). Latest known good revision of GNAT-LLVM compatible with GNAT FSF is `e000ea613704acc27238ec17ce020251427f9e1d`.
```
git clone https://github.com/AdaCore/gnat-llvm
git -C gnat-llvm checkout e000ea613704acc27238ec17ce020251427f9e1d
```
* Clone [bb-runtimes](https://github.com/Fabien-Chouteau/bb-runtimes). Use `gnat-fsf-12` branch.
```
git clone -b gnat-fsf-12 https://github.com/Fabien-Chouteau/bb-runtimes gnat-llvm/llvm-interface/bb-runtimes
```
* Clone [GCC](https://github.com/gcc-mirror/gcc) sources. Use, for instance, `e000ea613704acc27238ec17ce020251427f9e1d` commit.
```
git clone --single-branch --shallow-since=13-11-2022 https://github.com/gcc-mirror/gcc gnat-llvm/llvm-interface/gcc
git -C gnat-llvm/llvm-interface/gcc checkout e000ea613704acc27238ec17ce020251427f9e1d
```
* Setup GNAT-LLVM development environment, see details in
[GNAT-LLVM README](https://github.com/AdaCore/gnat-llvm). Note, you need to use
externally build LLVM with enabled 'lld' project and 'WebAssembly' target,
so, if you build it your-self, `cmake` command line should contain among other switches:
```
cmake ... -DLLVM_ENABLE_PROJECTS='...;clang;lld' -DLLVM_TARGETS_TO_BUILD="...;WebAssembly"
```
On Ubuntu it is possible to install prebuild LLVM/CLang packages (use LLVM/CLang 15). However,
alternatives need to be updated using the provided script:
```
sudo utilities/update-alternatives-clang.sh 15 100
```
Or install a [LLVM 15 binary release](https://github.com/llvm/llvm-project/releases) (`llvm-15`, `lld-15` and `clang-15` are required).
* Checkout AdaWebPack repository into `gnat-llvm/llvm-interface` as
`adawebpack_src` and create link for Makefile.target.
```
cd gnat-llvm/llvm-interface
git clone https://github.com/godunko/adawebpack.git adawebpack_src
ln -s adawebpack_src/source/rtl/Makefile.target
cd -
```
* Create a link to RTS source code
```
cd gnat-llvm/llvm-interface
ln -s bb-runtimes/gnat_rts_sources/include/rts-sources/
cd -
```
* Create a link to GNAT source code (or copy it)
```
cd gnat-llvm/llvm-interface
ln -s gcc/gcc/ada gnat_src
cd -
```
* Apply patch to GNAT-LLVM repository
```
cd gnat-llvm
patch -p0 < llvm-interface/adawebpack_src/patches/gnat-llvm.patch
cd -
```
* Use `make wasm` to build compiler and Run Time Library
```
cd gnat-llvm/llvm-interface
make wasm
cd -
```
* When `make` finishes, you will find toolchain in `gnat-llvm/llvm-interface/bin`.
```
cd gnat-llvm/llvm-interface
export PATH=$PWD/bin:$PATH
cd -
```
* Now you can build examples:
```
cd gnat-llvm/llvm-interface/adawebpack_src
make build_examples
cd -
```
You will most likely need to run the examples through an HTTP server;
otherwise, the browser will report a security error and/or refuse to load the page.
An easy way to obtain an HTTP server is by via Python 3 with `python3 -m http.server`.
## Usage with Docker
It could be handy to use docker.
* Find latest build on our [Fedora COPR](https://copr.fedorainfracloud.org/coprs/reznik/adawebpack/) repository.
* Build a container image (make sure to replace `curl` argument with latest RPM URL)
```
docker build --tag wgprbuild - <